ibase_pconnect(3) [php man page]

IBASE_PCONNECT(3)							 1							 IBASE_PCONNECT(3)

ibase_pconnect - Open a persistent connection to an InterBase database

SYNOPSIS

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

DESCRIPTION

	Opens a persistent connection to an InterBase database.

       ibase_pconnect(3) acts very much like ibase_connect(3) with two major differences.

	First, when connecting, the function will first try to find a (persistent) link that's already opened with the same parameters. If one	is
       found, an identifier for it will be returned instead of opening a new connection.

	Second,  the  connection  to  the InterBase server will not be closed when the execution of the script ends. Instead, the link will remain
       open for future use (ibase_close(3) will not close links established by ibase_pconnect(3)). This type of link is therefore called  'persis-
       tent'.

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/' (NetBEUI) or 'hostname@' (IPX/SPX), depending on the connection proto-
		col 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. Functional only with InterBase 6 and up.

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

	      o $sync
		-

RETURN VALUES

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

SEE ALSO

       ibase_close(3), ibase_connect(3).

PHP Documentation Group 													 IBASE_PCONNECT(3)

IBASE_QUERY(3)								 1							    IBASE_QUERY(3)

ibase_query - Execute a query on an InterBase database

SYNOPSIS

       resource ibase_query ([resource	$link_identifier], string  $query, [int  $bind_args])

DESCRIPTION

	Performs a query on an InterBase database.

PARAMETERS

	      o $link_identifier
		- An InterBase link identifier. If omitted, the last opened link is assumed.

	      o $query
		- An InterBase query.

	      o $bind_args
		-

RETURN VALUES

	If the query raises an error, returns FALSE. If it is successful and there is a (possibly empty) result set (such as with a SELECT query),
       returns a result identifier. If the query was successful and there were no results, returns TRUE.

       Note

	       In PHP 5.0.0 and up, this function will return the number of rows affected by the query for INSERT, UPDATE and  DELETE  statements.
	      In  order  to  retain  backward compatibility, it will return TRUE for these statements if the query succeeded without affecting any
	      rows.

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

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.1	|						    |
       |	|						    |
       |	|  On success the  function  now  returns  TRUE  if |
       |	| there  were no affected rows, where it previously |
       |	| returned 0  (a zero followed by an empty space).  |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      ibase_query(3) example

	      <?php

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

	      $dbh = ibase_connect($host, $username, $password);
	      $stmt = 'SELECT * FROM tblname';

	      $sth = ibase_query($dbh, $stmt) or die(ibase_errmsg());

	      ?>

SEE ALSO

       ibase_errmsg(3), ibase_fetch_row(3), ibase_fetch_object(3), ibase_free_result(3).

PHP Documentation Group 													    IBASE_QUERY(3)