php-doc-en/reference/ingres-ii/ini.xml
2012-12-02 05:40:00 +00:00

391 lines
12 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="ingres.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Ingres configuration options</title>
<tgroup cols="4">
<thead align="left">
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="ingres.configuration.list">
<row>
<entry><link
linkend="ini.ingres.allow-persistent">ingres.allow_persistent</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.array-index-start">ingres.array_index_start</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.4.0.</entry>
</row>
<row>
<entry><link linkend="ini.ingres.auto">ingres.auto</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.0.0.</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.blob-segment-length">ingres.blob_segment_length</link></entry>
<entry>"4096"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.2.0.</entry>
</row>
<row>
<entry><link linkend="ini.ingres.cursor-mode">ingres.cursor_mode</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.1.0.</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.default-database">ingres.default_database</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.default-password">ingres.default_password</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.ingres.default-user">ingres.default_user</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link linkend="ini.ingres.describe">ingres.describe</link></entry>
<entry>1</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.1.0</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.fetch-buffer-size">ingres.fetch_buffer_size</link></entry>
<entry>100</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.1.0</entry>
</row>
<row>
<entry><link linkend="ini.ingres.max-links">ingres.max_links</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.max-persistent">ingres.max_persistent</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Available since ingres 1.0.0</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.reuse-connection">ingres.reuse_connection</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.0.0</entry>
</row>
<row>
<entry><link linkend="ini.ingres.scrollable">ingres.scrollable</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.ingres.trace">ingres.trace</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.0.0.</entry>
</row>
<row>
<entry><link
linkend="ini.ingres.trace-connect">ingres.trace_connect</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 1.2.1.</entry>
</row>
<row>
<entry><link linkend="ini.ingres.utf8">ingres.utf8</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since ingres 2.0.0.</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.ingres.allow-persistent">
<term>
<parameter>ingres.allow_persistent</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Specifies whether to allow
<link linkend="features.persistent-connections">persistent connections</link>
to Ingres
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.array-index-start">
<term>
<parameter>ingres.array_index_start</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the start value for an integer key for arrays
generated by <function>ingres_fetch_row</function> or
<function>ingres_fetch_array</function>. By default
<parameter>ingres.array_index_start</parameter> is set to 1. If you wish
to make the ingres extension behave like other database extensions set
this configuration option to 0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.auto">
<term>
<parameter>ingres.auto</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables or disables autocommit emulation. Ingres cannot have multiple cursors
open with autocommit enabled. When enabled, the driver emulates autocommit.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.blob-segment-length">
<term>
<parameter>ingres.blob_segment_length</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the amount of memory to use when reading BLOB data, in bytes
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.cursor-mode">
<term>
<parameter>ingres.cursor_mode</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the default mode for cursors opened with ingres_prepare(). Valid values
are <constant>INGRES_CURSOR_UPDATE</constant> or <constant>INGRES_CURSOR_READONLY</constant>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.default-database">
<term>
<parameter>ingres.default_database</parameter>
<type>string</type>
</term>
<listitem>
<para>
Specifies the default database name to use when connecting to the database
server if no other name is specified. Does not apply in
&sqlsafemode;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.default-password">
<term>
<parameter>ingres.default_password</parameter>
<type>string</type>
</term>
<listitem>
<para>
Specifies the default password to use when connecting to the database
server if no other name is specified. Does not apply in
&sqlsafemode;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.default-user">
<term>
<parameter>ingres.default_user</parameter>
<type>string</type>
</term>
<listitem>
<para>
Specifies the default user name to use when connecting to the database
server if no other name is specified. Does not apply in
&sqlsafemode;.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.describe">
<term>
<parameter>ingres.describe</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables the use of <literal>DESCRIBE INPUT</literal> to determine the expected data types
for queries that use parameters. Available with Ingres 9.1.0 and later.
When disabled, queries that have parameters passed may need to manually
describe the types of those parameters using the <link
linkend="function.ingres-query.types">types</link> parameter in
<function>ingres_query</function>.
</para>
<note>
<para>
Enabling this feature with <function>ingres_query</function> will cause additional
communications traffic between this extension and the server. To
minimize this additional traffic, use <function>ingres_prepare</function> and
<function>ingres_execute</function>.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.fetch-buffer-size">
<term>
<parameter>ingres.fetch_buffer_size</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the number of pre-fetch rows that <function>ingres_fetch_array</function>,
<function>ingres_fetch_object</function> and
<function>ingres_fetch_row</function> will try and fetch in one fetch operation.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.max-links">
<term>
<parameter>ingres.max_links</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the maximum number of Ingres sessions allowed per process or thread.
The number of sessions should not exceed the total number of
connected sessions configured within Ingres.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.max-persistent">
<term>
<parameter>ingres.max_persistent</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Specifies the maximum number of persistent Ingres sessions allowed per process or
thread. The number of sessions should not exceed the total
number of connected sessions configured within Ingres.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.reuse-connection">
<term>
<parameter>ingres.reuse_connection</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Reuses an existing active connection if connecting to the same database
with the same user name
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.scrollable">
<term>
<parameter>ingres.scrollable</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables support for scrollable cursors. When fetching CLOB or BLOB data, this
should be set to &false;. Available with Ingres 9.2.0 or later.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.trace">
<term>
<parameter>ingres.trace</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables simple tracing using <constant>E_NOTICE</constant> messages
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.trace-connect">
<term>
<parameter>ingres.trace_connect</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Prints <constant>E_NOTICE</constant> messages during
<function>ingres_connect</function> or <function>ingres_pconnect</function> calls
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.ingres.utf8">
<term>
<parameter>ingres.utf8</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Assumes that strings being passed to National Character column types
(<literal>NVARCHAR</literal> or <literal>NCHAR</literal>) are using UTF8 encoding and converts them to UTF16
for the server
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<!-- 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:"~/.phpdoc/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
-->