<HTML ><HEAD ><TITLE >FrontBase Functions</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Function Reference" HREF="funcref.html"><LINK REL="PREVIOUS" TITLE="user_error" HREF="function.user-error.html"><LINK REL="NEXT" TITLE="fbsql_affected_rows" HREF="function.fbsql-affected-rows.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="reference" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.user-error.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.fbsql-affected-rows.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="reference" ><A NAME="ref.fbsql" ></A ><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" >XXVIII. FrontBase Functions</H1 ><DIV CLASS="PARTINTRO" ><A NAME="AEN23160" ></A ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.intro" ></A >Introduction</H1 ><P > These functions allow you to access FrontBase database servers. More information about FrontBase can be found at <A HREF="http://www.frontbase.com/" TARGET="_top" >http://www.frontbase.com/</A >. </P ><P > Documentation for FrontBase can be found at <A HREF="http://www.frontbase.com/cgi-bin/WebObjects/FrontBase.woa/wa/productsPage?currentPage=Documentation" TARGET="_top" >http://www.frontbase.com/cgi-bin/WebObjects/FrontBase.woa/wa/productsPage?currentPage=Documentation</A >. </P ><P > Frontbase support has been added to PHP 4.0.6. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.requirements" ></A >Requirements</H1 ><P > You must install the FrontBase database server or at least the fbsql client libraries to use this functions. You can get FrontBase from <A HREF="http://www.frontbase.com/" TARGET="_top" >http://www.frontbase.com/</A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.installation" ></A >Installation</H1 ><P > In order to have these functions available, you must compile PHP with fbsql support by using the <TT CLASS="option" >--with-fbsql[=DIR]</TT > option. If you use this option without specifying the path to fbsql, PHP will search for the fbsql client libraries in the default installation location for the platform. Users who installed FrontBase in a non standard directory should always specify the path to fbsql: <TT CLASS="option" >--with-fbsql=/path/to/fbsql</TT >. This will force PHP to use the client libraries installed by FrontBase, avoiding any conflicts. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.configuration" ></A >Runtime Configuration</H1 ><P > The behaviour of these functions is affected by settings in <TT CLASS="filename" >php.ini</TT >. </P ><P > <DIV CLASS="table" ><A NAME="AEN23182" ></A ><P ><B >Table 1. FrontBase configuration options</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Name</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Default</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Changeable</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.allow_persistent</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.generate_warnings</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"0"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.autocommit</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.max_persistent</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"-1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.max_links</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"128"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.max_connections</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"128"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.max_results</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"128"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.batchSize</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"1000"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.default_host</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >NULL</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.default_user</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"_SYSTEM"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.default_password</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >""</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.default_database</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >""</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >fbsql.default_database_password</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >""</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ></TBODY ></TABLE ></DIV > For further details and definition of the PHP_INI_* constants see <A HREF="function.ini-set.html" ><B CLASS="function" >ini_set()</B ></A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.resources" ></A >Resource Types</H1 ><P > </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="fbsql.constants" ></A >Predefined Constants</H1 ><P > 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. </P ><P ></P ><DIV CLASS="variablelist" ><DL ><DT ><TT CLASS="constant" ><B >FBSQL_ASSOC</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_NUM</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_BOTH</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_LOCK_DEFERRED</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_LOCK_OPTIMISTIC</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_LOCK_PESSIMISTIC</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_ISO_READ_UNCOMMITTED</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_ISO_READ_COMMITTED</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_ISO_REPEATABLE_READ</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_ISO_SERIALIZABLE</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_ISO_VERSIONED</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_UNKNOWN</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_STOPPED</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_STARTING</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_RUNNING</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_STOPPING</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_NOEXEC</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_LOB_DIRECT</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >FBSQL_LOB_HANDLE</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ></DL ></DIV ></DIV ></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="function.fbsql-affected-rows.html" >fbsql_affected_rows</A > -- Get number of affected rows in previous FrontBase operation </DT ><DT ><A HREF="function.fbsql-autocommit.html" >fbsql_autocommit</A > -- Enable or disable autocommit</DT ><DT ><A HREF="function.fbsql-change-user.html" >fbsql_change_user</A > -- Change logged in user of the active connection </DT ><DT ><A HREF="function.fbsql-close.html" >fbsql_close</A > -- Close FrontBase connection</DT ><DT ><A HREF="function.fbsql-commit.html" >fbsql_commit</A > -- Commits a transaction to the database</DT ><DT ><A HREF="function.fbsql-connect.html" >fbsql_connect</A > -- Open a connection to a FrontBase Server</DT ><DT ><A HREF="function.fbsql-create-blob.html" >fbsql_create_blob</A > -- Create a BLOB</DT ><DT ><A HREF="function.fbsql-create-clob.html" >fbsql_create_clob</A > -- Create a CLOB</DT ><DT ><A HREF="function.fbsql-create-db.html" >fbsql_create_db</A > -- Create a FrontBase database</DT ><DT ><A HREF="function.fbsql-data-seek.html" >fbsql_data_seek</A > -- Move internal result pointer</DT ><DT ><A HREF="function.fbsql-database-password.html" >fbsql_database_password</A > -- Sets or retrieves the password for a FrontBase database </DT ><DT ><A HREF="function.fbsql-database.html" >fbsql_database</A > -- Get or set the database name used with a connection</DT ><DT ><A HREF="function.fbsql-db-query.html" >fbsql_db_query</A > -- Send a FrontBase query</DT ><DT ><A HREF="function.fbsql-db-status.html" >fbsql_db_status</A > -- Get the status for a given database</DT ><DT ><A HREF="function.fbsql-drop-db.html" >fbsql_drop_db</A > -- Drop (delete) a FrontBase database</DT ><DT ><A HREF="function.fbsql-errno.html" >fbsql_errno</A > -- Returns the numerical value of the error message from previous FrontBase operation </DT ><DT ><A HREF="function.fbsql-error.html" >fbsql_error</A > -- Returns the text of the error message from previous FrontBase operation </DT ><DT ><A HREF="function.fbsql-fetch-array.html" >fbsql_fetch_array</A > -- Fetch a result row as an associative array, a numeric array, or both </DT ><DT ><A HREF="function.fbsql-fetch-assoc.html" >fbsql_fetch_assoc</A > -- Fetch a result row as an associative array </DT ><DT ><A HREF="function.fbsql-fetch-field.html" >fbsql_fetch_field</A > -- Get column information from a result and return as an object </DT ><DT ><A HREF="function.fbsql-fetch-lengths.html" >fbsql_fetch_lengths</A > -- Get the length of each output in a result </DT ><DT ><A HREF="function.fbsql-fetch-object.html" >fbsql_fetch_object</A > -- Fetch a result row as an object</DT ><DT ><A HREF="function.fbsql-fetch-row.html" >fbsql_fetch_row</A > -- Get a result row as an enumerated array</DT ><DT ><A HREF="function.fbsql-field-flags.html" >fbsql_field_flags</A > -- Get the flags associated with the specified field in a result </DT ><DT ><A HREF="function.fbsql-field-len.html" >fbsql_field_len</A > -- Returns the length of the specified field </DT ><DT ><A HREF="function.fbsql-field-name.html" >fbsql_field_name</A > -- Get the name of the specified field in a result </DT ><DT ><A HREF="function.fbsql-field-seek.html" >fbsql_field_seek</A > -- Set result pointer to a specified field offset </DT ><DT ><A HREF="function.fbsql-field-table.html" >fbsql_field_table</A > -- Get name of the table the specified field is in </DT ><DT ><A HREF="function.fbsql-field-type.html" >fbsql_field_type</A > -- Get the type of the specified field in a result </DT ><DT ><A HREF="function.fbsql-free-result.html" >fbsql_free_result</A > -- Free result memory</DT ><DT ><A HREF="function.fbsql-get-autostart-info.html" >fbsql_get_autostart_info</A > -- No description given yet</DT ><DT ><A HREF="function.fbsql-hostname.html" >fbsql_hostname</A > -- Get or set the host name used with a connection</DT ><DT ><A HREF="function.fbsql-insert-id.html" >fbsql_insert_id</A > -- Get the id generated from the previous INSERT operation </DT ><DT ><A HREF="function.fbsql-list-dbs.html" >fbsql_list_dbs</A > -- List databases available on a FrontBase server </DT ><DT ><A HREF="function.fbsql-list-fields.html" >fbsql_list_fields</A > -- List FrontBase result fields</DT ><DT ><A HREF="function.fbsql-list-tables.html" >fbsql_list_tables</A > -- List tables in a FrontBase database</DT ><DT ><A HREF="function.fbsql-next-result.html" >fbsql_next_result</A > -- Move the internal result pointer to the next result </DT ><DT ><A HREF="function.fbsql-num-fields.html" >fbsql_num_fields</A > -- Get number of fields in result</DT ><DT ><A HREF="function.fbsql-num-rows.html" >fbsql_num_rows</A > -- Get number of rows in result</DT ><DT ><A HREF="function.fbsql-password.html" >fbsql_password</A > -- Get or set the user password used with a connection</DT ><DT ><A HREF="function.fbsql-pconnect.html" >fbsql_pconnect</A > -- Open a persistent connection to a FrontBase Server </DT ><DT ><A HREF="function.fbsql-query.html" >fbsql_query</A > -- Send a FrontBase query</DT ><DT ><A HREF="function.fbsql-read-blob.html" >fbsql_read_blob</A > -- Read a BLOB from the database</DT ><DT ><A HREF="function.fbsql-read-clob.html" >fbsql_read_clob</A > -- Read a CLOB from the database</DT ><DT ><A HREF="function.fbsql-result.html" >fbsql_result</A > -- Get result data</DT ><DT ><A HREF="function.fbsql-rollback.html" >fbsql_rollback</A > -- Rollback a transaction to the database</DT ><DT ><A HREF="function.fbsql-select-db.html" >fbsql_select_db</A > -- Select a FrontBase database</DT ><DT ><A HREF="function.fbsql-set-lob-mode.html" >fbsql_set_lob_mode</A > -- Set the LOB retrieve mode for a FrontBase result set </DT ><DT ><A HREF="function.fbsql-set-transaction.html" >fbsql_set_transaction</A > -- Set the transaction locking and isolation </DT ><DT ><A HREF="function.fbsql-start-db.html" >fbsql_start_db</A > -- Start a database on local or remote server</DT ><DT ><A HREF="function.fbsql-stop-db.html" >fbsql_stop_db</A > -- Stop a database on local or remote server</DT ><DT ><A HREF="function.fbsql-tablename.html" >fbsql_tablename</A > -- Get table name of field</DT ><DT ><A HREF="function.fbsql-username.html" >fbsql_username</A > -- Get or set the host user used with a connection</DT ><DT ><A HREF="function.fbsql-warnings.html" >fbsql_warnings</A > -- Enable or disable FrontBase warnings</DT ></DL ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.user-error.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.fbsql-affected-rows.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >user_error</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="funcref.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >fbsql_affected_rows</TD ></TR ></TABLE ></DIV ></BODY ></HTML >