<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- splitted from ./en/functions/ibase.xml, last change in rev 1.2 -->
  <refentry id="function.ibase-connect">
   <refnamediv>
    <refname>ibase_connect</refname>
    <refpurpose>
     Open a connection to an InterBase database
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>ibase_connect</methodname>
      <methodparam><type>string</type><parameter>database</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>username</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>password</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>buffers</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>dialect</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>role</parameter></methodparam>
     </methodsynopsis>
    <para>
     Establishes a connection to an InterBase server.
     The <parameter>database</parameter> 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. <parameter>username</parameter>
     and <parameter>password</parameter> can also
     be specified with PHP configuration directives ibase.default_user and
     ibase.default_password. <parameter>charset</parameter> is the default
     character set for a database. <parameter>buffers</parameter> is the number
     of database buffers to allocate for the server-side cache. If 0 or omitted,
     server chooses its own default. <parameter>dialect</parameter> selects
     the default SQL dialect for any statement executed within a connection,
     and it defaults to the highest one supported by client libraries.
    </para>
    <para>
     In case a second call is made to
     <function>ibase_connect</function> 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
     <function>ibase_close</function>. 
     <example>
      <title><function>ibase_connect</function> example</title>
      <programlisting role="php">
<![CDATA[
<?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);
?>
]]>
      </programlisting>
     </example>
    </para>
    <note>
     <para>
      The optional <parameter>buffers</parameter> parameter was added in 
      PHP 4.0.0.
     </para>
    </note>
    <note>
     <para>
      The optional <parameter>dialect</parameter> parameter was added in PHP
      4.0.0 and is functional only with InterBase 6 and up.
     </para>
    </note>
    <note>
     <para>
      The optional <parameter>role</parameter> parameter was added in PHP
      4.0.0 and is functional only with InterBase 5 and up.
     </para>
    </note>
    <note>
     <para>
      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 <function>ibase_query</function> you must
      set the character set (i.e. ISO8859_1 or your current character set).
     </para>
    </note>
    <para>
     See also 
     <function>ibase_pconnect</function> and
     <function>ibase_close</function>.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->