<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>Description of core &php.ini; directives</title>

<para>

This list includes the core &php.ini; directives you can set to

configure your PHP setup. Directives handled by extensions are listed

and detailed at the extension documentation pages respectively;

Information on the session directives for example can be found at the

<link linkend="session.configuration">sessions page</link>.

</para>

<note>

<para>

The defaults listed here are used when &php.ini; is not loaded; the values for the production and development &php.ini; may vary.

</para>

</note>

<section xml:id="ini.sect.language-options">

<title>Language Options</title>

<para>

<table>

<title>Language and Misc 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.short-open-tag">short_open_tag</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.precision">precision</link></entry>

<entry>"14"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>

<entry>"-1"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>

Prior to PHP 7.1.0, the default value was 17.

</entry>

</row>

<row>

<entry><link linkend="ini.disable-functions">disable_functions</link></entry>

<entry>""</entry>

<entry><constant>INI_SYSTEM</constant> only</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.disable-classes">disable_classes</link></entry>

<entry>""</entry>

<entry>&php.ini; only</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.expose-php">expose_php</link></entry>

<entry>"1"</entry>

<entry>&php.ini; only</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>

<entry>"2"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>Available as of PHP 7.1.0.</entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Available as of PHP 7.4.0</entry>

</row>

<row>

<entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>

<entry>"0"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.detect-unicode">zend.detect_unicode</link></entry>

<entry>NULL</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>

<entry>"0"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>

<entry>"1"</entry>

<entry><constant>INI_ALL</constant> with restrictions</entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.zend.exception-string-param-max-len">zend.exception_string_param_max_len</link></entry>

<entry>"15"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry>Available as of PHP 8.0.0.</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.short-open-tag">

<term>

<parameter>short_open_tag</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Tells PHP whether the short form (<userinput>&lt;? ?&gt;</userinput>)

of PHP's open tag should be allowed. If you want to use PHP in

combination with XML, you can disable this option in order to

use <userinput>&lt;?xml ?&gt;</userinput> inline. Otherwise, you

can print it with PHP, for example: <userinput>&lt;?php echo '&lt;?xml

version="1.0"?&gt;'; ?&gt;</userinput>. Also, if disabled, you must use the

long form of the PHP open tag (<userinput>&lt;?php ?&gt;</userinput>).

</para>

<note>

<para>

This directive does not affect the shorthand

<userinput>&lt;?=</userinput>, which is always available.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.precision">

<term>

<parameter>precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

The number of significant digits displayed in floating point numbers.

<literal>-1</literal> means that an enhanced algorithm for rounding

such numbers will be used.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.serialize-precision">

<term>

<parameter>serialize_precision</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

The number of significant digits stored while serializing floating point numbers.

<literal>-1</literal> means that an enhanced algorithm for rounding

such numbers will be used.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.expose-php">

<term>

<parameter>expose_php</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Exposes to the world that PHP is installed on the server, which includes the

PHP version within the HTTP header (e.g., X-Powered-By: PHP/5.3.7).

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-functions">

<term>

<parameter>disable_functions</parameter>

<type>string</type>

</term>

<listitem>

<simpara>

This directive allows disables certain functions.

It takes on a comma-delimited list of function names.

As of PHP 8.0.0, disabling a function removes it definition

allowing userland to redefine it.

Prior to PHP 8.0.0, disabling a function just prevent invoking the function.

</simpara>

<simpara>

Only <link linkend="functions.internal">internal functions</link> can

be disabled using this directive.

<link linkend="functions.user-defined">User-defined functions</link>

are unaffected.

</simpara>

<simpara>

This directive must be set in &php.ini;.

It cannot be set in &httpd.conf;.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.disable-classes">

<term>

<parameter>disable_classes</parameter>

<type>string</type>

</term>

<listitem>

<para>

This directive allows disables certain classes.

It takes on a comma-delimited list of class names.

Disabling a class just prevent instantiating the class.

</para>

<para>

Only internal classes can be disabled using this directive.

User-defined classes are unaffected.

</para>

<simpara>

This directive must be set in &php.ini;.

It cannot be set in &httpd.conf;.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.assertions">

<term>

<parameter>zend.assertions</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

When set to <literal>1</literal>, assertion code will be generated and

executed (development mode). When set to <literal>0</literal>,

assertion code will be generated but it will be skipped (not executed)

at runtime. When set to <literal>-1</literal>, assertion code will not

be generated, making the assertions zero-cost (production mode).

</simpara>

<note>

<para>

If a process is started in production mode, <link linkend="ini.zend.assertions">zend.assertions</link>

cannot be changed at runtime, since the code for assertions was not generated.

</para>

<para>

If a process is started in development mode, <link linkend="ini.zend.assertions">zend.assertions</link>

cannot be set to <literal>-1</literal> at runtime.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-string-param-max-len">

<term>

<parameter>zend.exception_string_param_max_len</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

The maximum length of string function arguments in stringified stack traces.

Must range between <literal>"0"</literal> and <literal>"1000000"</literal>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.hard-timeout">

<term>

<parameter>hard_timeout</parameter>

<type>int</type>

</term>

<listitem>

<para>

When the timeout set in <link linkend="ini.max-execution-time">max_execution_time</link>

has been hit, the PHP runtime will tear down resources gracefully. If

something gets stuck while this happens, the hard timeout will tick

for the set amount of seconds. When the hard timeout is hit, PHP will

exit ungracefully. When set to 0, the hard timeout will never activate.

</para>

<para>

When PHP stops from a hard timeout, it will look something like this:

<screen>

<![CDATA[

Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0

]]>

</screen>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.exception-ignore-args">

<term>

<parameter>zend.exception_ignore_args</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Excludes arguments from stack traces generated from exceptions.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.multibyte">

<term>

<parameter>zend.multibyte</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Enables parsing of source files in multibyte encodings. Enabling zend.multibyte

is required to use character encodings like SJIS, BIG5, etc that contain special

characters in multibyte string data. ISO-8859-1 compatible encodings like UTF-8,

EUC, etc do not require this option.

</para>

<para>

Enabling zend.multibyte requires the mbstring extension to be available.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.script-encoding">

<term>

<parameter>zend.script_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

This value will be used unless a

<link linkend="control-structures.declare.encoding">declare(encoding=...)</link>

directive appears at the top of the script. When ISO-8859-1 incompatible encoding

is used, both zend.multibyte and zend.script_encoding must be used.

</para>

<para>

Literal strings will be transliterated from zend.script_encoding to

mbstring.internal_encoding, as if

<function>mb_convert_encoding</function> would have been called.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.detect-unicode">

<term>

<parameter>zend.detect_unicode</parameter>

<type>bool</type>

</term>

<listitem>

<para>

Check for BOM (Byte Order Mark) and see if the file contains valid

multibyte characters.

This detection is performed before processing of

<function>__halt_compiler</function>.

Available only in Zend Multibyte mode.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.zend.signal-check">

<term>

<parameter>zend.signal_check</parameter>

<type>bool</type>

</term>

<listitem>

<para>

To check for replaced signal handlers on shutdown.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.exit-on-timeout">

<term>

<parameter>exit_on_timeout</parameter>

<type>bool</type>

</term>

<listitem>

<para>

This is an Apache1 mod_php-only directive that forces an Apache child to exit if a PHP execution timeout occurred.

Such a timeout causes an internal longjmp() call in Apache1 which can leave some extensions in an inconsistent

state. By terminating the process any outstanding locks or memory will be cleaned up.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.resource-limits">

<title>Resource Limits</title>

<para>

<table>

<title>Resource Limits</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.memory-limit">memory_limit</link></entry>

<entry>"128M"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.memory-limit">

<term>

<parameter>memory_limit</parameter>

<type>int</type>

</term>

<listitem>

<para>

This sets the maximum amount of memory in bytes that a script

is allowed to allocate. This helps prevent poorly written

scripts for eating up all available memory on a server. Note that

to have no memory limit, set this directive to <literal>-1</literal>.

</para>

&ini.shorthandbytes;

</listitem>

</varlistentry>

</variablelist>

</para>

<para>

See also: <link linkend="ini.max-execution-time">max_execution_time</link>.

</para>

</section>

<section xml:id="ini.sect.performance">

<title>Performance Tuning</title>

<para>

<table>

<title>Performance Tuning</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.realpath-cache-size">realpath_cache_size</link></entry>

<entry>"4M"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry>Prior to PHP 7.0.16 and 7.1.2, the default was <literal>"16K"</literal></entry>

</row>

<row>

<entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>

<entry>"120"</entry>

<entry><constant>INI_SYSTEM</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

<note>

<para>

Using <link linkend="ini.open-basedir">open_basedir</link> will

<emphasis>disable</emphasis> the realpath cache.

</para>

</note>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.realpath-cache-size">

<term>

<parameter>realpath_cache_size</parameter>

<type>int</type>

</term>

<listitem>

<para>

Determines the size of the realpath cache to be used by PHP. This

value should be increased on systems where PHP opens many files, to

reflect the quantity of the file operations performed.

</para>

<para>

The size represents the total number of bytes in the path strings

stored, plus the size of the data associated with the cache entry. This

means that in order to store longer paths in the cache, the cache size

must be larger. This value does not directly control the number of

distinct paths that can be cached.

</para>

<para>

The size required for the cache entry data is system dependent.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.realpath-cache-ttl">

<term>

<parameter>realpath_cache_ttl</parameter>

<type>int</type>

</term>

<listitem>

<para>

Duration of time (in seconds) for which to cache realpath information

for a given file or directory. For systems with rarely changing files,

consider increasing the value.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</section>

<section xml:id="ini.sect.data-handling">

<title>Data Handling</title>

<para>

<table>

<title>Data Handling 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.arg-separator.output">arg_separator.output</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>

<entry>"&amp;"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.variables-order">variables_order</link></entry>

<entry>"EGPCS"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.request-order">request_order</link></entry>

<entry>""</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>

<entry>"1"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.post-max-size">post_max_size</link></entry>

<entry>"8M"</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>

<entry>NULL</entry>

<entry><constant>INI_PERDIR</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>

<entry>"text/html"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.default-charset">default_charset</link></entry>

<entry>"UTF-8"</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.input-encoding">input_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.output-encoding">output_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

<row>

<entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>

<entry>""</entry>

<entry><constant>INI_ALL</constant></entry>

<entry></entry>

</row>

</tbody>

</tgroup>

</table>

</para>

&ini.descriptions.title;

<para>

<variablelist>

<varlistentry xml:id="ini.arg-separator.output">

<term>

<parameter>arg_separator.output</parameter>

<type>string</type>

</term>

<listitem>

<para>

The separator used in PHP generated URLs to separate arguments.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.arg-separator.input">

<term>

<parameter>arg_separator.input</parameter>

<type>string</type>

</term>

<listitem>

<para>

List of separator(s) used by PHP to parse input URLs into variables.

</para>

<note>

<para>

Every character in this directive is considered as separator!

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.variables-order">

<term>

<parameter>variables_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

Sets the order of the EGPCS (<literal>E</literal>nvironment,

<literal>G</literal>et, <literal>P</literal>ost,

<literal>C</literal>ookie, and <literal>S</literal>erver) variable

parsing. For example, if variables_order

is set to <literal>"SP"</literal> then PHP will create the

&link.superglobals; <varname>$_SERVER</varname> and

<varname>$_POST</varname>, but not create

<varname>$_ENV</varname>, <varname>$_GET</varname>, and

<varname>$_COOKIE</varname>. Setting to "" means no

&link.superglobals; will be set.

</para>

<warning>

<para>

In both the CGI and FastCGI SAPIs,

<varname>$_SERVER</varname> is

also populated by values from the environment; <literal>S</literal>

is always equivalent to <literal>ES</literal> regardless of the

placement of <literal>E</literal> elsewhere in this directive.

</para>

</warning>

<note>

<para>

The content and order of

<varname>$_REQUEST</varname> is also

affected by this directive.

</para>

</note>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.request-order">

<term>

<parameter>request_order</parameter>

<type>string</type>

</term>

<listitem>

<para>

This directive describes the order in which PHP registers GET, POST

and Cookie variables into the _REQUEST array. Registration is done

from left to right, newer values override older values.

</para>

<para>

If this directive is not set, <link

linkend="ini.variables-order">variables_order</link> is used for

<varname>$_REQUEST</varname> contents.

</para>

<para>

Note that the default distribution <filename>php.ini</filename> files does not contain

the <literal>'C'</literal> for cookies, due to security concerns.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-globals-jit">

<term>

<parameter>auto_globals_jit</parameter>

<type>bool</type>

</term>

<listitem>

<para>

When enabled, the SERVER, REQUEST, and ENV variables are created when they're

first used (Just In Time) instead of when the script starts. If these

variables are not used within a script, having this directive on will

result in a performance gain.

</para>

<warning>

<para>

Usage of SERVER, REQUEST, and ENV variables is checked during the compile time

so using them through e.g. <link

linkend="language.variables.variable">variable variables</link> will

not cause their initialization.

</para>

</warning>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.register-argc-argv">

<term>

<parameter>register_argc_argv</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

Tells PHP whether to declare the argv &amp; argc variables

(that would contain the GET information).

</simpara>

<simpara>

See also <link linkend="features.commandline">command line</link>.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.enable-post-data-reading">

<term>

<parameter>enable_post_data_reading</parameter>

<type>bool</type>

</term>

<listitem>

<simpara>

Disabling this option causes <varname>$_POST</varname> and

<varname>$_FILES</varname> <emphasis>not</emphasis> to be populated.

The only way to read postdata will then be through the

<link linkend="wrappers.php">php://input</link> stream wrapper.

This can be useful to proxy requests or to process

the POST data in a memory efficient fashion.

</simpara>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.post-max-size">

<term>

<parameter>post_max_size</parameter>

<type>int</type>

</term>

<listitem>

<simpara>

Sets max size of post data allowed. This setting also affects

file upload. To upload large files, this value must be larger

than <link linkend="ini.upload-max-filesize">upload_max_filesize</link>.

</simpara>

<simpara>

Generally speaking,

<link linkend="ini.memory-limit">memory_limit</link> should be

larger than <parameter>post_max_size</parameter>.

</simpara>

&ini.shorthandbytes;

<simpara>

If the size of post data is greater than post_max_size, the

<varname>$_POST</varname> and <varname>$_FILES</varname>

<link linkend="language.variables.superglobals">superglobals</link>

are empty. This can be tracked in various ways, e.g. by passing the

<varname>$_GET</varname> variable to the script processing the data,

i.e. <literal>&lt;form action="edit.php?processed=1"&gt;</literal>,

and then checking if <varname>$_GET['processed']</varname> is set.

</simpara>

<para>

<note>

<para>

PHP allows shortcuts for byte values, including K (kilo), M (mega)

and G (giga). PHP will do the conversions automatically if you

use any of these. Be careful not to exceed the 32 bit signed integer

limit (if you're using 32bit versions) as it will cause your script

to fail.

</para>

</note>

</para>

<para>

<table>

<title>Changelog for <literal>post_max_size</literal></title>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>5.3.4</entry>

<entry>

<parameter>post_max_size</parameter> = 0 will not disable the limit when the content

type is application/x-www-form-urlencoded or is not registered with PHP.

</entry>

</row>

<row>

<entry>5.3.2 , 5.2.12</entry>

<entry>

Allow unlimited post size by setting <parameter>post_max_size</parameter> to 0.

</entry>

</row>

</tbody>

</tgroup>

</table>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-prepend-file">

<term>

<parameter>auto_prepend_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Specifies the name of a file that is automatically parsed

before the main file. The file is included as if it was

called with the <function>require</function> function, so

<link linkend="ini.include-path">include_path</link> is used.</para>

<para>

The special value <literal>none</literal>

disables auto-prepending.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.auto-append-file">

<term>

<parameter>auto_append_file</parameter>

<type>string</type>

</term>

<listitem>

<para>

Specifies the name of a file that is automatically parsed

after the main file. The file is included as if it was

called with the <function>require</function> function, so

<link linkend="ini.include-path">include_path</link> is used.</para>

<para>

The special value <literal>none</literal>

disables auto-appending.

<note>

<simpara>

If the script is terminated with <function>exit</function>,

auto-append will <emphasis>not</emphasis> occur.</simpara>

</note>

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-mimetype">

<term>

<parameter>default_mimetype</parameter>

<type>string</type>

</term>

<listitem>

<para>

By default, PHP will output a media type using the Content-Type header.

To disable this, simply set it to be empty.

</para>

<para>

PHP's built-in default media type is set to text/html.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.default-charset">

<term>

<parameter>default_charset</parameter>

<type>string</type>

</term>

<listitem>

<para>

"UTF-8" is the default value and its value is used

as the default character encoding for

<function>htmlentities</function>,

<function>html_entity_decode</function> and

<function>htmlspecialchars</function> if the

<parameter>encoding</parameter> parameter is omitted. The value of

<parameter>default_charset</parameter> will also be used to set the

default character set for <link linkend="book.iconv">iconv</link>

functions if the

<link linkend="ini.iconv.input-encoding"><parameter>iconv.input_encoding</parameter></link>,

<link linkend="ini.iconv.output-encoding"><parameter>iconv.output_encoding</parameter></link> and

<link linkend="ini.iconv.internal-encoding"><parameter>iconv.internal_encoding</parameter></link>

configuration options are unset, and for

<link linkend="book.mbstring">mbstring</link> functions if the

<link linkend="ini.mbstring.http-input"><parameter>mbstring.http_input</parameter></link>

<link linkend="ini.mbstring.http-output"><parameter>mbstring.http_output</parameter></link>

<link linkend="ini.mbstring.internal-encoding"><parameter>mbstring.internal_encoding</parameter></link>

configuration option is unset.

</para>

<para>

All versions of PHP will use this value as the charset within the

default Content-Type header sent by PHP if the header isn't overridden

by a call to <function>header</function>.

</para>

<para>

Setting <parameter>default_charset</parameter> to an empty value is

not recommended.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.input-encoding">

<term>

<parameter>input_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

This setting is used for multibyte modules

such as mbstring and iconv. Default is empty.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.output-encoding">

<term>

<parameter>output_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

This setting is used for multibyte modules

such as mbstring and iconv. Default is empty.

</para>

</listitem>

</varlistentry>

<varlistentry xml:id="ini.internal-encoding">

<term>

<parameter>internal_encoding</parameter>

<type>string</type>

</term>

<listitem>

<para>

This setting is used for multibyte modules

such as mbstring and iconv. Default is empty. If empty,

<link linkend="ini.default-charset">default_charset</link> is used.

</para>