XLIV. InterBase functions
Introduction
InterBase is a popular database put out by Borland/Inprise. More information about InterBase is available at http://www.interbase.com/. Oh, by the way, InterBase just joined the open source movement!
Installation
To enable InterBase support configure PHP --with-interbase[=DIR], where DIR is the InterBase base install directory, which defaults to /usr/interbase.
Note to Win32 Users: In order to enable this module on a Windows environment, you must copy gds32.dll from the DLL folder of the PHP/Win32 binary package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32). In case you installed the InterBase database server on the same machine PHP is running on, you will have this DLL already. Therfore you don't need to copy gds32.dll from the DLL folder.
Runtime Configuration
The behaviour of these functions is affected by settings in php.ini.
Table 1. InterBase configuration options
| Name | Default | Changeable |
|---|---|---|
| ibase.allow_persistent | "1" | PHP_INI_SYSTEM |
| ibase.max_persistent | "-1" | PHP_INI_SYSTEM |
| ibase.max_links | "-1" | PHP_INI_SYSTEM |
| ibase.default_user | NULL | PHP_INI_ALL |
| ibase.default_password | NULL | PHP_INI_ALL |
| ibase.timestampformat | "%m/%d/%Y%H:%M:%S" | PHP_INI_ALL |
| ibase.dateformat | "%m/%d/%Y" | PHP_INI_ALL |
| ibase.timeformat | "%H:%M:%S" | PHP_INI_ALL |
Predefined Constants
The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.
- IBASE_DEFAULT (integer)
- IBASE_TEXT (integer)
- IBASE_UNIXTIME (integer)
- IBASE_WRITE (integer)
Access mode
- IBASE_READ (integer)
Access mode
- IBASE_COMMITTED (integer)
Isolation level
- IBASE_CONSISTENCY (integer)
Isolation level
- IBASE_CONCURRENCY (integer)
Isolation level (default)
- IBASE_REC_VERSION (integer)
- IBASE_REC_NO_VERSION (integer)
- IBASE_NOWAIT (integer)
Lock resolution
- IBASE_WAIT (integer)
Lock resolution (default)
- IBASE_TIMESTAMP (integer)
- IBASE_DATE (integer)
- IBASE_TIME (integer)
- Table of Contents
- ibase_add_user -- Add a user to a security database (only for IB6 or later)
- ibase_affected_rows -- Return the number of rows that were affected by the previous query
- ibase_blob_add -- Add data into a newly created blob
- ibase_blob_cancel -- Cancel creating blob
- ibase_blob_close -- Close blob
- ibase_blob_create -- Create a new blob for adding data
- ibase_blob_echo -- Output blob contents to browser
- ibase_blob_get -- Get len bytes data from open blob
- ibase_blob_import -- Create blob, copy file in it, and close it
- ibase_blob_info -- Return blob length and other useful info
- ibase_blob_open -- Open blob for retrieving data parts
- ibase_close -- Close a connection to an InterBase database
- ibase_commit_ret -- Commit a transaction without closing it
- ibase_commit -- Commit a transaction
- ibase_connect -- Open a connection to an InterBase database
- ibase_delete_user -- Delete a user from a security database (only for IB6 or later)
- ibase_drop_db -- Drops a database
- ibase_errcode -- Return an error code
- ibase_errmsg -- Return error messages
- ibase_execute -- Execute a previously prepared query
- ibase_fetch_assoc -- Fetch a result row from a query as an associative array
- ibase_fetch_object -- Get an object from a InterBase database
- ibase_fetch_row -- Fetch a row from an InterBase database
- ibase_field_info -- Get information about a field
- ibase_free_event_handler -- Cancels a registered event handler
- ibase_free_query -- Free memory allocated by a prepared query
- ibase_free_result -- Free a result set
- ibase_modify_user -- Modify a user to a security database (only for IB6 or later)
- ibase_name_result -- Assigns a name to a result set
- ibase_num_fields -- Get the number of fields in a result set
- ibase_num_params -- Return the number of parameters in a prepared query
- ibase_param_info -- Return information about a parameter in a prepared query
- ibase_pconnect -- Open a persistent connection to an InterBase database
- ibase_prepare -- Prepare a query for later binding of parameter placeholders and execution
- ibase_query -- Execute a query on an InterBase database
- ibase_rollback_ret -- Roll back a transaction without closing it
- ibase_rollback -- Roll back a transaction
- ibase_set_event_handler -- Register a callback function to be called when events are posted
- ibase_timefmt -- Sets the format of timestamp, date and time type columns returned from queries
- ibase_trans -- Begin a transaction
- ibase_wait_event -- Wait for an event to be posted by the database