ibase_connect(3) [php man page]

IBASE_CONNECT(3)							 1							  IBASE_CONNECT(3)

ibase_connect - Open a connection to a database

SYNOPSIS

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

DESCRIPTION

	Establishes a connection to an Firebird/InterBase server.

	In case a second call is made to ibase_connect(3) with the same arguments, no new link will be established, but instead, the link  identi-
       fier 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(3).

PARAMETERS

	      o $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/port:' (TCP/IP with interbase server on custom TCP port), '//hostname/'
		(NetBEUI), depending on the connection protocol used.

	      o $username
		- The user name. Can be set with the ibase.default_user php.ini directive.

	      o $password
		- The password for $username. Can be set with the ibase.default_password php.ini directive.

	      o $charset
		-$charset is the default character set for a database.

	      o $buffers
		-$buffers is the number of database buffers to allocate for the server-side cache.  If	0  or  omitted,  server  chooses  its  own
		default.

	      o $dialect
		-$dialect  selects the default SQL dialect for any statement executed within a connection, and it defaults to the highest one sup-
		ported by client libraries.

	      o $role
		- Functional only with InterBase 5 and up.

	      o $sync
		-

RETURN VALUES

	Returns an Firebird/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(3) you must set the character set
       (i.e. ISO8859_1 or your current character set).

EXAMPLES

       Example #1

	      ibase_connect(3) 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, "
";
	      }
	      ibase_free_result($sth);
	      ibase_close($dbh);
	      ?>

SEE ALSO

       ibase_pconnect(3), ibase_close(3).

PHP Documentation Group 													  IBASE_CONNECT(3)

DBX_CONNECT(3)								 1							    DBX_CONNECT(3)

dbx_connect - Open a connection/database

SYNOPSIS

       object dbx_connect (mixed  $module, string  $host, string  $database, string  $username, string	$password, [int  $persistent])

DESCRIPTION

	Opens a connection to a database.

PARAMETERS

	      o $module
		-  The	$module parameter can be either a string or a constant, though the latter form is preferred. The possible values are given
		below, but keep in mind that they only work if the module is actually loaded.

		     o DBX_MYSQL or "mysql"

		     o DBX_ODBC or "odbc"

		     o DBX_PGSQL or "pgsql"

		     o DBX_MSSQL or "mssql"

		     o DBX_FBSQL or "fbsql"

		     o DBX_SYBASECT or "sybase_ct"

		     o DBX_OCI8 or "oci8"

		     o DBX_SQLITE or "sqlite"

	      o $host
		- The SQL server host

	      o $database
		- The database name

	      o $username
		- The username

	      o $password
		- The password

	      o $persistent
		- The $persistent parameter can be set to DBX_PERSISTENT, if so, a persistent connection will be created.

	The $host, $database, $username and $password parameters are expected, but not always used depending on  the  connect  functions  for  the
       abstracted module.

RETURN VALUES

	Returns  an  object  on  success,  FALSE on error. If a connection has been made but the database could not be selected, the connection is
       closed and FALSE is returned.

	The returned $object has three properties:

	      o database
		- It is the name of the currently selected database.

	      o handle
		- It is a valid handle for the connected database, and as such it can be used in module-specific functions (if required).

	      <?php
	      $link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
	      mysql_close($link->handle); // dbx_close($link) would be better here
	      ?>

	      o module
		- It is used internally by dbx only, and is actually the module number mentioned above.

CHANGELOG

       +--------+---------------------------+
       |Version |			    |
       |	|			    |
       |	|	 Description	    |
       |	|			    |
       +--------+---------------------------+
       | 5.0.0	|			    |
       |	|			    |
       |	|   Introduced DBX_SQLITE.  |
       |	|			    |
       | 4.3.0	|			    |
       |	|			    |
       |	|    Introduced DBX_OCI8.   |
       |	|			    |
       | 4.2.0	|			    |
       |	|			    |
       |	|  Introduced DBX_SYBASECT. |
       |	|			    |
       | 4.1.0	|			    |
       |	|			    |
       |	|   Introduced DBX_FBSQL.   |
       |	|			    |
       +--------+---------------------------+
EXAMPLES

       Example #1

	      dbx_connect(3) example

	      <?php
	      $link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
		  or die("Could not connect");

	      echo "Connected successfully";
	      dbx_close($link);
	      ?>

NOTES

       Note

	       Always refer to the module-specific documentation as well.

SEE ALSO

       dbx_close(3).

PHP Documentation Group 													    DBX_CONNECT(3)