Forum und email

ibase_connect

(PHP 4, PHP 5)

ibase_connect — Open a connection to an InterBase database

Description

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

Establishes a connection to an InterBase server. The database argument has to be a valid path to database file on the server it resides on. If the server is not local, it must be prefixed with either 'hostname:' (TCP/IP), '//hostname/' (NetBEUI) or 'hostname@' (IPX/SPX), depending on the connection protocol used. username and password can also be specified with PHP configuration directives ibase.default_user and ibase.default_password. charset is the default character set for a database. buffers is the number of database buffers to allocate for the server-side cache. If 0 or omitted, server chooses its own default. dialect selects the default SQL dialect for any statement executed within a connection, and it defaults to the highest one supported by client libraries.

In case a second call is made to ibase_connect() with the same arguments, no new link will be established, but instead, the link identifier of the already opened link will be returned. The link to the server will be closed as soon as the execution of the script ends, unless it's closed earlier by explicitly calling ibase_close().

Example#1 ibase_connect() example

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

Note: buffers was added in PHP 4.0RC2.

Note: dialect was added in PHP 4.0RC2. It is functional only with InterBase 6 and versions higher than that.

Note: role was added in PHP 4.0RC2. It is functional only with InterBase 5 and versions higher than that.

See also ibase_pconnect().