   #PHP Manual InterBase functions ibase_commit ibase_delete_user

   PHP Manual
   Prev  Next
   ______________________________________________________________________

                                 ibase_connect

   (PHP 3>= 3.0.6, PHP 4 )
   ibase_connect --  Open a connection to an InterBase database

Description

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

     Note: The optional buffers parameter was added in PHP 4.0.0.

     Note: The optional dialect parameter was added in PHP 4.0.0 and is
     functional only with InterBase 6 and up.

     Note: The optional role parameter was added in PHP 4.0.0 and is
     functional only with InterBase 5 and up.

     Note: 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).

   See also ibase_pconnect() and ibase_close().
   ______________________________________________________________________

   Prev         Home              Next
   ibase_commit  Up  ibase_delete_user
