php-doc-en/reference/pdo_odbc/ini.xml
2021-04-23 11:35:26 +03:00

127 lines
4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<section xml:id="pdo-odbc.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>PDO_ODBC Configuration Options</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="pdo-odbc.configuration.list">
<row>
<entry><link linkend="ini.pdo-odbc.connection-pooling">pdo_odbc.connection_pooling</link></entry>
<entry>"strict"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.pdo-odbc.db2-instance-name">pdo_odbc.db2_instance_name</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&removed.php.future;</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.pdo-odbc.connection-pooling">
<term>
<parameter>pdo_odbc.connection_pooling</parameter>
<type>string</type>
</term>
<listitem>
<para>
Whether to pool ODBC connections. Can be one of <literal>"strict"</literal>,
<literal>"relaxed"</literal> or <literal>"off"</literal> (equals to
<literal>""</literal>). The parameter describes how strict the connection
manager should be when matching connection parameters to existing pooled
connections. <userinput>strict</userinput> is the recommend default, and
will result in the use of cached connections only when all the connection
parameters match exactly. <userinput>relaxed</userinput> will result in
the use of cached connections when similar connection parameters are
used. This can result in increased use of the cache, at the risk of
bleeding connection information between (for example) virtual hosts.
</para>
<para>
This setting can only be changed from the &php.ini;
file, and affects the entire process; any other modules loaded into the
process that use the same ODBC libraries will be affected too, including
the <link linkend="ref.uodbc">Unified ODBC extension</link>.
</para>
<warning>
<para>
<userinput>relaxed</userinput> matching should not be used on a shared
server, for security reasons.
</para>
</warning>
<tip>
<para>
Leave this setting at the default <userinput>strict</userinput> setting
unless you have good reason to change it.
</para>
</tip>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.pdo-odbc.db2-instance-name">
<term>
<parameter>pdo_odbc.db2_instance_name</parameter>
<type>string</type>
</term>
<listitem>
<para>
If you compile PDO_ODBC using the <literal>db2</literal> flavour,
this setting sets the value of the DB2INSTANCE environment variable on
Linux and UNIX operating systems to the specified name of the DB2
instance. This enables PDO_ODBC to resolve the location of the DB2
libraries and make cataloged connections to DB2 databases.
</para>
<para>
This setting can only be changed from the &php.ini;
file, and affects the entire process; any other modules loaded into the
process that use the same ODBC libraries will be affected too, including
the <link linkend="ref.uodbc">Unified ODBC extension</link>.
</para>
<para>
This setting has no effect on Windows.
</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
-->