ibase_connect

Open a connection to an InterBase database (PHP 4, PHP 5)
resource ibase_connect ( [string database [, string username [, string password [, string charset [, int buffers [, int dialect [, string role [, int sync]]]]]]]] )

Establishes a connection to an InterBase server.

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().

Parameters

database: 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: The user name. Can be set with the ibase.default_user php.ini directive.
password: The password for username. Can be set with the ibase.default_password php.ini directive.
charset: charset is the default character set for a database.
buffers: buffers is the number of database buffers to allocate for the server-side cache. If 0 or omitted, server chooses its own default.
dialect: dialect selects the default SQL dialect for any statement executed within a connection, and it defaults to the highest one supported by client libraries. Functional only with InterBase 6 and up.
role: Functional only with InterBase 5 and up.
sync

Return Values

Returns an InterBase link identifier on success, or FALSE on error.

Errors/Exceptions

If you get some error like "arithmetic exception, numeric overflow, or string truncation. Cannot transliterate character between character sets" (this occurs when you try use some character with accents) when using this and after ibase_query() you must set the character set (i.e. ISO8859_1 or your current character set).

ChangeLog

Version	Description
4.0.0	The `buffers`, `dialect` and `role` parameters were added

Examples

Example 681. ibase_connect() example

copy to clipboard

<?php

$host = 'localhost:/path/to/your.gdb';

$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);
?>

See Also

ibase_pconnect()

ibase_close()

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. eg: 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.

ibase_connect

Open a connection to an InterBase database (PHP 4, PHP 5)
resource ibase_connect ( [string database [, string username [, string password [, string charset [, int buffers [, int dialect [, string role [, int sync]]]]]]]] )

Parameters

Return Values

Errors/Exceptions

ChangeLog

Examples

Example 681. ibase_connect() example

Code Examples / Notes » ibase_connect

Change Language

ibase_connect

Open a connection to an InterBase database (PHP 4, PHP 5) resource ibase_connect ( [string database [, string username [, string password [, string charset [, int buffers [, int dialect [, string role [, int sync]]]]]]]] )

Parameters

Return Values

Errors/Exceptions

ChangeLog

Examples

Example 681. ibase_connect() example

Code Examples / Notes » ibase_connect

Change Language

Open a connection to an InterBase database (PHP 4, PHP 5)
resource ibase_connect ( [string database [, string username [, string password [, string charset [, int buffers [, int dialect [, string role [, int sync]]]]]]]] )