PHP Doku:: Öffnet eine Verbindung zu einer InterBase-Datenbank - function.ibase-connect.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzDatenbankerweiterungenAnbieterspezifische DatenbankerweiterungenFirebird/InterBaseFirebird/InterBase Funktionenibase_connect

Ein Service von Reinhard Neidl - Webprogrammierung.

Firebird/InterBase Funktionen




(PHP 4, PHP 5)

ibase_connect Öffnet eine Verbindung zu einer InterBase-Datenbank


int ibase_connect ( string $database [, string $username [, string $password [, string $charset [, int $buffers [, int $dialect [, string $role ]]]]]] )

Stellt eine Verbindung zu einem InterBase-Server her. Das database-Argument muss ein gültiger Pfad zu einer bestehenden Datenbank des Servers sein. Ist der DB-Server nicht lokal, muss ihm - in Abhängigkeit vom benutzten Protokoll - ein 'hostname:' (bei TCP/IP), '//hostname/' (bei NetBEUI) oder 'hostname@' (bei IPX/SPX) vorangestellt werden. Die Parameter username und password können auch über die PHP-Konfigurations-Anweisungen ibase.default_user und ibase.default_password gesetzt werden. Charset ist der reguläre Zeichensatz der Datenbank. Mit buffers geben sie die Anzahl der Datenbank-Cache-Buffer (serverseitig) an. Ist der Wert 0 oder nicht angegeben, benutzt der Server seine Default-Werte. Mittels dialect bestimmen sie den Default-Wert des anzuwendenden SQL-Dialekts für alle Anweisungen während einer Datenbank-Verbindung (default ist der Client-seitig höchst verfügbare Dialekt).

Wenn ibase_connect() mit den selben Argumenten erneut aufgerufen wird, wird keine neue Verbindung hergestellt, sondern die ID der bereits geöffneten Verbindung zurück gegeben. Die Verbindung zum InterBase-Server wird am Ende des jeweiligen Skripts automatisch beendet, es sei denn, es wird vorher die Funktion ibase_close() aufgerufen.

Beispiel #1 ibase_connect()-Beispiel:

ibase_connect ($host$username$password);
$stmt 'SELECT * FROM tblname';
$sth ibase_query ($dbh$stmt);
    while (
$row ibase_fetch_object ($sth)) {
$row->email "\n";
ibase_close ($dbh);


Buffers existiert seit PHP4-RC2.


Dialect wurde in PHP4-RC2 hinzugefügt. Er funktioniert ab der InterBase-Version 6.


Role existiert seit PHP4-RC2. Er funktioniert ab der InterBase-Version 5.

Siehe auch: ibase_pconnect().

8 BenutzerBeiträge:
- Beiträge aktualisieren...
kgbfernando at yahoo dot com dot br
22.01.2008 15:25
If you have this problem:

Warning: ibase_connect(): Unable to complete network request to host "localhost"
. Failed to locate host machine. Undefined service gds_db/tcp.  in C:\\wamp\\php\\ibase.php on line 5

This is because php is deployed with old client library gds32.dll.

To resolve this, update this library to Firebird latest version of fbclient.dll, of course, rename it to gds32.dll and overwrite into php dir.

Or simply don't use localhost ou, use computer name.
fb dot bird at gmail dot com
10.08.2007 23:32
Remember for different locations
of php.ini file:


Please do not confuse this
and know location _loaded_ *.ini-file!
Łukasz Wojciechowski
11.02.2007 12:06
ag at dividi dot de wrote:
The solution is to insert the line
gds_db    3050/tcp    #firebird Database
into the windows services file %WINDIR%\\system32\\drivers\\etc\\services

...but it is very important to hit ENTER at the end of this line:
gds_db    3050/tcp    #firebird Database

I spent 2 hours before I discover this - I love Windows ;-)

ag at dividi dot de
20.09.2005 14:07
With php5 on Windows i couldnt connect to a firebird database with following error :

Warning: ibase_connect(): Unable to complete network request to host "localhost"
. Failed to locate host machine. Undefined service gds_db/tcp.  in C:\\wamp\\php\\ibase.php on line 5

the connect command was "$dbh = ibase_connect ("localhost:path_to_file.fdb", $username, $password);"

The solution is to insert the line
gds_db    3050/tcp    #firebird Database
into the windows services file %WINDIR%\\system32\\drivers\\etc\\services
Robert Silvia
5.12.2004 2:02
Just to update Simon's note...

Things must have been fixed since Simon wrote that note.
With PHP5 the following example works flawlessly:

$strconnect = 'localhost:/opt/firebird/examples/employee.fdb';

if (!($db=ibase_connect($strconnect, 'sysdba', 'yourpass', 'ISO8859_1', 0, 1)))
    die('Could not connect: ' .  ibase_errmsg());

  $cursor = ibase_query($sql);
  $row_array = ibase_fetch_row($cursor);


Also you CAN get away with the following connection string:
ibase_connect('/opt/firebird/examples/employee.fdb', 'sysdba', 'yourpass')
sam at
5.08.2004 13:08
If you get a sloooow work of ibase_connect on Win2003, try to update your FireBird to version 1.5 or above, and your InterBase to version 7.1. Or move back to Win2000 :)
simon at thorndancer dot com
15.06.2003 8:22
I found it difficult to get anything working using the current documentation.
While logic would suggest that the format in the docs should work (being based on all the
syntax of other standard database access functions) I had problem after problem. Finally I
found some comments on a newgroup that helped, and this is the result.

This is actual production code (not a mere example). It works.
Don't ask me why it is so different from the official docs.

if ( ibase_connect( $db_filespec,$db_user,$db_pass_word) )
    $query  = "SELECT, c.title, c.description ";   
    $query .= "FROM collections c ";  
    $query .= "WHERE ( = $page_id) ";                                      

    $result = ibase_query( $query );

    $row_array = ibase_fetch_row($result);

    $row_fetched = !empty($row_array);

    if ($row_fetched)     
       // Extract the row into variables

        $collection_id   = $row_array[0];           
       $edit_title      = $row_array[1];           
       $edit_desc       = $row_array[2];           

       // Standardise the record contents

        $collection_id   = $collection_id + 0;      // force type to numeric

    // Wrap up the database side of things

     ibase_commit();     // note parenthesis but no parameters.

     ibase_close;        // note total lack of parenthesis and parameters !
You'll notice that there is no reference to a database handle in this code.
It seems to be implicit when dealing with interbase functions. Certainly, I couldn't
get the code to work when using it explicitly. This makes the documentation
very hard to work with, and any reference to a handle needs to be ignored.

Important: ibase_close doesn't work for me if I put parenthesis after it.
        ibase_close;        // works
        ibase_close();      // fails
        ibase_close($db);   // fails
Note: the line "if ($row_fetched)" could be replaced with "while ($row_fetched)"
if you need to process more than one record.

All that said, Interbase is a fantastic database to work with and IMHO a much
better choice than something like PostgreSQL if you need to move up from MySQL
to something more industrial strength. Just be sure to RTFM.
anthony at trams dot com
21.11.2000 4:44
If you get a message like: 'Dynamic SQL Error SQL error code = -901 feature is not supported', this may be caused by InterBASE client 6.01 accessing a server running 5.x.

Make sure the dialect value is set to '1', like the following:

ibase_connect ('localhost:/usr/db/db.gdb', 'SYSDBA', 'masterkey', 'ISO8859_1', '100', '1' ) ;

That last value is the dialect, but you need the two preceding also, do avoid errors.


PHP Powered Diese Seite bei
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)