php-doc-en/reference/info/ini.xml
Torben Wilson af4410a7e1 Normalized the sgml-default-dtd-file local-variable line for those
still using this, after discussion on the phpdoc list.
From now on, manual.ced will need to be found at ~/.phpdoc/manual.ced.



git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@288721 c90b9560-bf6c-de11-be94-00142212c4b1
2009-09-25 07:04:39 +00:00

389 lines
12 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<section xml:id="info.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>PHP Options/Inf 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.assert.active">assert.active</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.bail">assert.bail</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.warning">assert.warning</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.callback">assert.callback</link></entry>
<entry>NULL</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.assert.quiet-eval">assert.quiet_eval</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.enable-dl">enable_dl</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>Removed in PHP 6.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.max-execution-time">max_execution_time</link></entry>
<entry>"30"</entry>
<entry>PHP_INI_ALL</entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.max-input-time">max_input_time</link></entry>
<entry>"-1"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available since PHP 4.3.0.</entry>
</row>
<row>
<entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
<entry>"64"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>Available since PHP 4.4.8. Removed in PHP 5.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_PERDIR</entry>
<entry>PHP_INI_ALL in PHP &lt;= 4.2.3. Removed in PHP 6.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link></entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Removed in PHP 6.0.0.</entry>
</row>
<row>
<entry><link linkend="ini.zend.enable-gc">zend.enable_gc</link></entry>
<entry>"1"</entry>
<entry>PHP_INI_ALL</entry>
<entry>Available since PHP 5.3.0.</entry>
</row>
</tbody>
</tgroup>
</table>
&ini.php.constants;
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.assert.active">
<term>
<parameter>assert.active</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enable <function>assert</function> evaluation.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.bail">
<term>
<parameter>assert.bail</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Terminate script execution on failed assertions.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.warning">
<term>
<parameter>assert.warning</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Issue a PHP warning for each failed assertion.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.callback">
<term>
<parameter>assert.callback</parameter>
<type>string</type>
</term>
<listitem>
<para>
user function to call on failed assertions
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.assert.quiet-eval">
<term>
<parameter>assert.quiet_eval</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Use the current setting of <function>error_reporting</function> during
assertion expression evaluation. If enabled, no errors are shown
(implicit error_reporting(0)) while evaluation. If disabled, errors are
shown according to the settings of <function>error_reporting</function>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.enable-dl">
<term>
<parameter>enable_dl</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
This directive is really only useful in the Apache module
version of PHP. You can turn dynamic loading of
PHP extensions with <function>dl</function> on and
off per virtual server or per directory.
</para>
<para>
The main reason for turning dynamic loading off is
security. With dynamic loading, it's possible to ignore all
<link linkend="ini.open-basedir">open_basedir</link> restrictions.
The default is to allow dynamic loading, except when using
&safemode;. In &safemode;, it's
always impossible to use <function>dl</function>.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-execution-time">
<term>
<parameter>max_execution_time</parameter>
<type>integer</type>
</term>
<listitem>
<para>
This sets the maximum time in seconds a script is allowed to
run before it is terminated by the parser. This helps
prevent poorly written scripts from tying up the server. The
default setting is <literal>30</literal>. When running PHP
from the <link linkend="features.commandline">command
line</link> the default setting is <literal>0</literal>.
</para>
<para>
The maximum execution time is not affected by system calls,
stream operations etc. Please see the
<function>set_time_limit</function> function for more
details.
</para>
<para>
You can not change this setting with <function>ini_set</function> when
running in &safemode;. The only workaround is to turn off safe mode or
by changing the time limit in the &php.ini;.
</para>
<para>
Your web server can have other timeout configurations that may
also interrupt PHP execution. Apache has a
<literal>Timeout</literal> directive and IIS has a CGI timeout
function. Both default to 300 seconds. See your web server
documentation for specific details.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-input-time">
<term>
<parameter>max_input_time</parameter>
<type>integer</type>
</term>
<listitem>
<para>
This sets the maximum time in seconds a script is allowed to
parse input data, like POST, GET and file uploads.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.max-input-nesting-level">
<term>
<parameter>max_input_nesting_level</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Sets the max nesting depth of
<link linkend="language.variables.external">input variables</link> (i.e.
<varname>$_GET</varname>, <varname>$_POST</varname>..)
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.magic-quotes-gpc">
<term>
<parameter>magic_quotes_gpc</parameter>
<type>boolean</type>
</term>
<listitem>
&warn.deprecated.feature-5-3-0.removed-6-0-0;
<para>
Sets the magic_quotes state for GPC (Get/Post/Cookie)
operations. When magic_quotes are on, all ' (single-quote),
&quot; (double quote), \ (backslash) and NUL's are escaped
with a backslash automatically.
</para>
<note>
<para>
In PHP 4, also <varname>$_ENV</varname>
variables are escaped.
</para>
</note>
<note>
<para>
If the <link linkend="ini.magic-quotes-sybase">
magic_quotes_sybase</link> directive is also ON it will
completely override magic_quotes_gpc. Having both directives
enabled means only single quotes are escaped as
<emphasis>''</emphasis>. Double quotes, backslashes and
NUL's will remain untouched and unescaped.
</para>
</note>
<para>
See also <function>get_magic_quotes_gpc</function>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.magic-quotes-runtime">
<term>
<parameter>magic_quotes_runtime</parameter>
<type>boolean</type>
</term>
<listitem>
&warn.deprecated.feature-5-3-0.removed-6-0-0;
<para>
If <parameter>magic_quotes_runtime</parameter> is enabled,
most functions that return data from any sort of external
source including databases and text files will have quotes
escaped with a backslash. If
<link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>
is also on, a single-quote is escaped with a single-quote instead
of a backslash.
</para>
<para>
Functions affected by <parameter>magic_quotes_runtime</parameter>
(does not include functions from PECL):
<simplelist>
<member><function>get_meta_tags</function></member>
<member><function>file_get_contents</function></member>
<member><function>file</function></member>
<member><function>fgets</function></member>
<member><function>fwrite</function></member>
<member><function>fread</function></member>
<member><function>fputcsv</function></member>
<member><function>stream_socket_recvfrom</function></member>
<member><function>exec</function></member>
<member><function>system</function></member>
<member><function>passthru</function></member>
<member><function>stream_get_contents</function></member>
<member><function>bzread</function></member>
<member><function>gzfile</function></member>
<member><function>gzgets</function></member>
<member><function>gzwrite</function></member>
<member><function>gzread</function></member>
<member><function>phar_file_get_contents</function></member>
<member><function>exif_read_data</function></member>
<member><function>dba_insert</function></member>
<member><function>dba_replace</function></member>
<member><function>dba_fetch</function></member>
<member><function>ibase_fetch_row</function></member>
<member><function>ibase_fetch_assoc</function></member>
<member><function>ibase_fetch_object</function></member>
<member><function>mssql_fetch_row</function></member>
<member><function>mssql_fetch_object</function></member>
<member><function>mssql_fetch_array</function></member>
<member><function>mssql_fetch_assoc</function></member>
<member><function>mysqli_fetch_row</function></member>
<member><function>mysqli_fetch_array</function></member>
<member><function>mysqli_fetch_assoc</function></member>
<member><function>mysqli_fetch_object</function></member>
<member><function>pg_fetch_row</function></member>
<member><function>pg_fetch_assoc</function></member>
<member><function>pg_fetch_array</function></member>
<member><function>pg_fetch_object</function></member>
<member><function>pg_fetch_all</function></member>
<member><function>pg_select</function></member>
<member><function>sybase_fetch_object</function></member>
<member><function>sybase_fetch_array</function></member>
<member><function>sybase_fetch_assoc</function></member>
<member><function>SplFileObject::fgets</function></member>
<member><function>SplFileObject::fgetcsv</function></member>
<member><function>SplFileObject::fwrite</function></member>
</simplelist>
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.zend.enable-gc">
<term>
<parameter>zend.enable_gc</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Enables or disables the circular reference collector.
</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
-->