1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127
|
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 297557 $ -->
<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>
<row>
<entry><link linkend="ini.pdo-odbc.connection-pooling">pdo_odbc.connection_pooling</link></entry>
<entry>"strict"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 5.1.0.</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>Available since PHP 5.1.1. &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
-->
|