(PHP 5, PHP 7)

ibase_connectOtwiera połączenie do serwera baz danych


ibase_connect ([ string $baza_danych [, string $użytkownik [, string $hasło [, string $kodowanie_znaków [, int $bufory [, int $dialekt [, string $rola [, int $synchronizacja ]]]]]]]] ) : resource

Nawiązuje połączenie z serwerem Firebird/InterBase.

W przypadku ponownego wywołania funkcji ibase_connect() z takimi samymi argumentami, nie jest otwierane nowe połączenie, jednak w to miejsce powinien zostać zwrócony identyfikator już otwartego połączenia. Połączenie do serwera powinno zostać zamknięte wkrótce po tym, gdy wykonywanie skryptu PHP się zakończy, o ile nie zostanie zamknięte wcześniej przez jawne wywołanie funkcji ibase_close().



Parametr baza_danych jest ścieżką do pliku bazy danych (lub aliasem zapisanym w pliku aliases.conf) na serwerze, na którym się ona znajduje. Jeżeli serwer nie jest uruchomiony lokalnie, to ścieżka musi być poprzedzona łańcuchem 'nazwa_hosta:' (TCP/IP), 'nazwa_hosta/port:' (TCP/IP z serwerem interbase na własnym porcie) lub '//nazwa_hosta/' (NetBEUI), w zależności od używanego protokołu.


Nazwa użytkownika. Może być ona ustawiona za pomocą dyrektywy konfiguracyjnej PHP ibase.default_user w pliku php.ini.


Hasło użytkownika. Może być ono ustawione za pomocą dyrektywy konfiguracyjnej PHP ibase.default_password w pliku php.ini.


Parametr kodowanie_znaków jest domyślnym kodowaniem znaków narodowych w bazie danych.


Parametr bufory jest liczbą buforów bazy danych jaką ma zaalokować serwer w swojej pamięci podręcznej. Jeżeli jest ustawiony na 0, lub jest pominięty, to serwer użyje wartości domyślnej.


Parametr dialekt ustawia domyślny dialekt SQL dla wszystkich instrukcji wykonywanych podczas połączenia. Domyślnie jest on ustawiony na najwyższy obsługiwany przez biblioteki klienta.


Są obsługiwane przez InterBase 5 i nowsze wersje.


Zwracane wartości

Zwraca identyfikator połączenia do serwera Firebird/InterBase w przypadku powodzenia, lub FALSE w przypadku błędu.


Jeżeli są zwracane błędy takie jak "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (to może się zdarzyć w przypadku użycia niektórych znaków narodowych) po użyciu funkcji ibase_query(), to należy ustawić kodowanie znaków (np. ISO8859_2, WIN1250, UTF8).


Przykład #1 Przykład ibase_connect()


$dbh ibase_connect($host$username$password'ISO8859_2');
$sth ibase_query($dbh$stmt);
while (
$row ibase_fetch_object($sth)) {

Zobacz też:

add a note add a note

User Contributed Notes 7 notes

anthony at trams dot com
21 years ago
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.

simon at thorndancer dot com
19 years ago
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.id, c.title, c.description ";   
    $query .= "FROM collections c ";  
    $query .= "WHERE (c.id = $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.
fwrk at bk dot ru
7 years ago
If you want to connect to interbase server runned on custom port (not default port 3050), you can specify it in "database" parameter in this way: 'hostname/port:' (TCP/IP with custom port).
$dbh = ibase_connect('example.com/11099:dbalias', $username, $password);
$dbh = ibase_connect('example.com/11099:var/data/myibase.fdb', $username, $password);
$dbh = ibase_connect('example.com/11099:C:\\data\\mywinibase.fdb', $username, $password);
ag at dividi dot de
17 years ago
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
17 years ago
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')
fb dot bird at gmail dot com
15 years ago
Remember for different locations
of php.ini file:


Please do not confuse this
and know location _loaded_ *.ini-file!
sam at intranex.ru
18 years ago
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 :)
To Top