cvs: phpdoc-sk /appendices ini.xml
[email protected] ("Joseph Drake") Thu, 08 Jul 2004 00:11:26 -0000
| Newsgroups | php.doc.sk |
|---|---|
| Message-ID | <cvsjoseph1089245486@cvsserver> |
joseph Wed Jul 7 20:11:26 2004 EDT
Added files:
/phpdoc-sk/appendices ini.xml
Log:
just working on
joseph-20040707201126.txt
(text/plain, 34 KB)
http://cvs.php.net/co.php/phpdoc-sk/appendices/ini.xml?r=1.1&p=1
Index: phpdoc-sk/appendices/ini.xml
+++ phpdoc-sk/appendices/ini.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.3 Maintainer: joseph Status: working -->
<appendix id="ini">
<title>Zoznam &php.ini; direktív jadra</title>
<para>
Tento zoznam zahàòa &php.ini; direktívy jadra, ktoré mô¾ete nastavi»
na konfigurovanie vá¹ho PHP nastavenia. Direktívy riadené roz¹íreniami sú
vypísané a rozobrané na dokumentaèných stránkach daného roz¹írenia;
Napríklad informácie o direktívach sedenia sa dajú nájs» na
<link linkend="ref.session">stránke sedení</link>.
</para>
<sect1 id="ini.sect.httpd-options">
<title>Httpd Voµby</title>
<para>
<table>
<title>Httpd Options</title>
<tgroup cols="3">
<thead>
<row>
<entry>Názov</entry>
<entry>©tandardne</entry>
<entry>Zmeniteµný</entry>
</row>
</thead>
<tbody>
<row>
<entry>async_send</entry>
<entry>"0"</entry>
<entry>PHP_INI_ALL</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>
</para>
</sect1>
<sect1 id="ini.sect.language-options">
<title>Voµby jazyka</title>
<para>
<table>
<title>Jazyk a Rozlièné konfiguraèné voµby</title>
<tgroup cols="3">
<thead>
<row>
<entry>Názov</entry>
<entry>©tandardne</entry>
<entry>Zmeniteµný</entry>
</row>
</thead>
<tbody>
<row>
<entry>short_open_tag</entry>
<entry>On</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>asp_tags</entry>
<entry>Off</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>precision</entry>
<entry>"14"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>y2k_compliance</entry>
<entry>Off</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>allow_call_time_pass_reference</entry>
<entry>On</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>expose_php</entry>
<entry>On</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.short-open-tag">
<term>
<parameter>short_open_tag</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Hovorí, èi by mala krátka forma (<userinput><? ?></userinput>)
otvoreného tagu PHP by» povolená. Ak chcete pou¾íva» PHP v
kombinácii s XML, mô¾ete túto voµbu zakáza», aby ste pou¾ívali
<userinput><?xml ?></userinput> inline. Inak ho mô¾ete
vytlaèi» s PHP, napríklad: <userinput><?php echo '<?xml
version="1.0"'; ?></userinput>. Tie¾ ak je zakázaná, musíte pou¾i»
dlhú formu otvoreného tagu PHP (<userinput><?php ?></userinput>).
</para>
<note>
<para>
Táto direktíva tie¾ ovplyvòuje skratku <userinput><?=</userinput>,
ktorá je identická s <userinput><? echo</userinput>. Pou¾itie tejto
skratky vy¾aduje <systemitem role="directive">short_open_tag</systemitem>
nastavenie na on.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.asp-tags">
<term>
<parameter>asp_tags</parameter>
<type>boolean</type>
</term>
<listitem>
<simpara>
Povoluje pou¾itie ASP-podobných <% %> tagov dodatoène k
zvyèajným <?php ?> tagom. To zahàòa skratku tlaèenia
hodnoty premennej <%= $value %>. Pre viac informácii, pozri
<link linkend="language.basic-syntax.phpmode">Vyskoèenie z HTML</link>.
</simpara>
<note>
<para>
Podpora pre ASP-podobné tagy bola pridaná v 3.0.4.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.precision">
<term>
<parameter>precision</parameter>
<type>integer</type>
</term>
<listitem>
<simpara>
Poèet cifier zobrazených v èíslach s pohyblivou èiarkou.
</simpara>
</listitem>
</varlistentry>
<varlistentry id="ini.y2k-compliance">
<term>
<parameter>y2k_compliance</parameter>
<type>boolean</type>
</term>
<listitem>
<simpara>
Prinúti prispôsobenie sa k roku 2000 (spôsobí problémy s
neprispôsobovými prehliadaèmi)
</simpara>
</listitem>
</varlistentry>
<varlistentry id="ini.allow-call-time-pass-reference">
<term>
<parameter>allow_call_time_pass_reference</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Èi sa má povoli» schopnos» prinúti» poslanie argumentov referenciou
v èase volania funkcie. Táto metóda je odmietaná a je pravdepodobné, ¾e
nebude podporovaná v budúcich verziách PHP/Zend. Povzbudzovaná metóda
urèovania, ktoré argumenty by sa mali posla» referenciou v deklarácii
funkcie. Povzbudzujeme vás k vyskú¹aniu a nastaveniu tejto voµby na Off
a uistite sa, ¾e vá¹ skript s tým funguje správne, aby ste mohli zabezpeèi»,
¾e budú fugova» s budúcimi verziami jazyka (tie¾ dostanete varovanie v¾dy,
keï budete túto vlastnos» pou¾íva» a argument sa po¹le hodnotou namiesto
referencie).
</para>
<para>
Tie¾ pozri <link linkend="language.references">Vysvetlené Referencie</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.expose-php">
<term>
<parameter>expose_php</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Rozhoduje, èi PHP mô¾e odhali» fakt, ¾e je nain¹talovaný na serveri
(napr. pridaním jeho signatúry do hlavièky web servera). Bezpeènosti to
vôbec neu¹kodí, ale umo¾òuje urèi», èi pou¾ívate PHP va¹om web serveri
alebo nie.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="ini.sect.resource-limits">
<title>Limity zdroja</title>
<para>
<table>
<title>Limity zdroja</title>
<tgroup cols="3">
<thead>
<row>
<entry>Názov</entry>
<entry>©tandardne</entry>
<entry>Zmeniteµný</entry>
</row>
</thead>
<tbody>
<row>
<entry>memory_limit</entry>
<entry>"8M"</entry>
<entry>PHP_INI_ALL</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.memory-limit">
<term>
<parameter>memory_limit</parameter>
<type>integer</type>
</term>
<listitem>
<para>
Toto nastavuje maximálny poèet pamäte v bytoch, ktorý má skript
povolený na alokáciu. To pomáha zabráni» zle napísanému skriptu
pohlti» v¹etku dostupnú pamä» na serveri. Aby ste túto direktívu
mohli pou¾íva», museli by ste ju povoli» poèas kompilácie. Tak¾e,
vá¹ konfiguraèný riadok by bol zahàòal:
<option role="configure">--enable-memory-limit</option>. Pozor na to, ¾e
ju musíte nastavi» na -1, ak nechcete ¾iadne limity pre va¹u pamä».
</para>
<para>
Od PHP 4.3.2, ak je memory_limit povolená, tak je dostupná PHP
funkcia <function>memory_get_usage</function>.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
Tie¾ pozri: <link linkend="ini.max-execution-time">max_execution_time</link>.
</para>
</sect1>
<sect1 id="ini.sect.data-handling">
<title>Spracovanie dát</title>
<para>
<table>
<title>Konfiguraèné voµby spracovania dát</title>
<tgroup cols="3">
<thead>
<row>
<entry>Názov</entry>
<entry>©tandardne</entry>
<entry>Zmeniteµný</entry>
</row>
</thead>
<tbody>
<row>
<entry>track_vars</entry>
<entry>"On"</entry>
<entry>PHP_INI_??</entry>
</row>
<row>
<entry>arg_separator.output</entry>
<entry>"&"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>arg_separator.input</entry>
<entry>"&"</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>variables_order</entry>
<entry>"EGPCS"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>register_globals</entry>
<entry>"Off"</entry>
<entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>register_argc_argv</entry>
<entry>"On"</entry>
<entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>register_long_arrays</entry>
<entry>"On"</entry>
<entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>post_max_size</entry>
<entry>"8M"</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>gpc_order</entry>
<entry>"GPC"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>auto_prepend_file</entry>
<entry>""</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>auto_append_file</entry>
<entry>""</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>default_mimetype</entry>
<entry>"text/html"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>default_charset</entry>
<entry>"iso-8859-1"</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>always_populate_raw_post_data</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
<row>
<entry>allow_webdav_methods</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.track-vars">
<term>
<parameter>track_vars</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Ak je zapnutý, potom sa premenné Environment, GET, POST, Cookie
a Server dajú nájs» v globálnych asociatívnych poliach
<varname>$_ENV</varname>,
<varname>$_GET</varname>,
<varname>$_POST</varname>,
<varname>$_COOKIE</varname> a
<varname>$_SERVER</varname>.
</para>
<para>
Od PHP 4.0.3 je <systemitem
role="directive">track_vars</systemitem> v¾dy zapnutá.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.arg-separator.output">
<term>
<parameter>arg_separator.output</parameter>
<type>string</type>
</term>
<listitem>
<para>
Oddelovaè pou¾ívaný v PHP generoval URL-ka na oddelenie argumentov.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.arg-separator.input">
<term>
<parameter>arg_separator.input</parameter>
<type>string</type>
</term>
<listitem>
<para>
Zoznam oddelovaèov pou¾ivaných PHP-èkom na analýzu vstupných
URL na premenné.
</para>
<note>
<para>
Ka¾dý znak v tejto direktíve sa pova¾uje ako oddelovaè!
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.variables-order">
<term>
<parameter>variables_order</parameter>
<type>string</type>
</term>
<listitem>
<para>
Nastavte poradie analýzy premenných EGPCS (Environment, GET, POST,
Cookie, Server). Východzie nastavenie tejto direktívy je
"EGPCS". Napríklad, nastavenie na "GP" spôsobí, ¾e PHP bude
kompletne ignorova» enviromentálne premenné, premenné cookies
a server a bude prepisova» v¹etky premenné metódy GET
premennými metody POST rovnakého názvu.
</para>
<para>
Tie¾ pozri <link linkend="ini.register-globals">register_globals</link>.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.register-globals">
<term>
<parameter>register_globals</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Hovorí, èi registrova» alebo neregistrova» premenné EGPCS (Environment,
GET, POST, Cookie, Server) ako globálne premenné. Napríklad;
ak register_globals = on, URL
<literal>http://www.example.com/test.php?id=3</literal> vyprodukuje
<varname>$id</varname>. Alebo <varname>$DOCUMENT_ROOT</varname> z
<varname>$_SERVER['DOCUMENT_ROOT']</varname>. Mô¾ete ju chcie» nastavi»
na off, ak si nechcete urobi» neporiadok v globalnom poli va¹ich skriptov
s u¾ívateµskými dátami. Od PHP <ulink url="&url.php.release4.2.0;">4.2.0</ulink>,
je východzia hodnota tejto direktívy <emphasis>off</emphasis>. Je preferované
prejs» si rad¹ej PHP <link linkend="reserved.variables">Preddefinované premenné
</link>, sko
<link linkend="language.variables.superglobals">superglobály</link>:
<varname>$_ENV</varname>, <varname>$_GET</varname>,
<varname>$_POST</varname>, <varname>$_COOKIE</varname> a
<varname>$_SERVER</varname>. Prosím, preèítajte si kapitolu bezpeènosti o
<link linkend="security.globals">Pou¾ívaní register_globals</link>
pre súvicsiace informácie.
</para>
<para>
Upozoròujeme, ¾e <systemitem role="directive">register_globals</systemitem>
sa nedajú nastavi» poèas runtime (<function>ini_set</function>). I keï, mô¾ete
pou¾i» &htaccess; ak vá¹ to vá¹ host umo¾òuje ako je popísané
vy¹¹ie. Príklad &htaccess; polo¾ky:
<userinput>php_flag register_globals on</userinput>.
</para>
<note>
<para>
<systemitem role="directive">register_globals</systemitem> je ovplyvnená
direktívou <link linkend="ini.variables-order">variables_order</link>.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.register-argc-argv">
<term>
<parameter>register_argc_argv</parameter>
<type>boolean</type>
</term>
<listitem>
<simpara>
Hovorí PHP, èi má deklarova» argv & argc premenné
(ktoré by obsahoval GET informáciu).
</simpara>
<simpara>
Tie¾ pozri <link linkend="features.commandline">command line</link>.
Táto direktíva bola sprístupnená v PHP 4.0.0 a
a pred tým bola v¾dy "on".
</simpara>
</listitem>
</varlistentry>
<varlistentry id="ini.register-long-arrays">
<term>
<parameter>register_long_arrays</parameter>
<type>boolean</type>
</term>
<listitem>
<simpara>
Tells PHP whether or not to register the deprecated long
<varname>$HTTP_*_VARS</varname> type
<link linkend="language.variables.predefined">predefined
variables</link>. When On (default), long predefined PHP
variables like <varname>$HTTP_GET_VARS</varname> will be defined.
If you're not using them, it's recommended to turn them off,
for performance reasons. Instead, use the superglobal arrays,
like <varname>$_GET</varname>.
</simpara>
<simpara>
This directive became available in PHP 5.0.0.
</simpara>
</listitem>
</varlistentry>
<varlistentry id="ini.post-max-size">
<term>
<parameter>post_max_size</parameter>
<type>integer</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>
If memory limit is enabled by your configure script, <link
linkend="ini.memory-limit">memory_limit</link> also affects
file uploading. Generally speaking,
<link linkend="ini.memory-limit">memory_limit</link> should be
larger than <parameter>post_max_size</parameter>.
</simpara>
</listitem>
</varlistentry>
<varlistentry id="ini.gpc-order">
<term>
<parameter>gpc_order</parameter>
<type>string</type>
</term>
<listitem>
<para>
Set the order of GET/POST/COOKIE variable parsing. The
default setting of this directive is "GPC". Setting this to
"GP", for example, will cause PHP to completely ignore cookies
and to overwrite any GET method variables with POST-method
variables of the same name.
</para>
<note>
<para>
This option is not available in PHP 4.
Use <link linkend="ini.variables-order">variables_order</link>
instead.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry 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>include</function> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <systemitem class="constant">none</systemitem>
disables auto-prepending.
</para>
</listitem>
</varlistentry>
<varlistentry 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>include</function> function, so
<link linkend="ini.include-path">include_path</link> is used.</para>
<para>
The special value <systemitem class="constant">none</systemitem>
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 id="ini.default-mimetype">
<term>
<parameter>default_mimetype</parameter>
<type>string</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.default-charset">
<term>
<parameter>default_charset</parameter>
<type>string</type>
</term>
<listitem>
<para>
As of 4.0b4, PHP always outputs a character encoding by default in
the Content-type: header. To disable sending of the charset, simply
set it to be empty.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.always-populate-raw-post-data">
<term>
<parameter>always_populate_raw_post_data</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Always populate the $HTTP_RAW_POST_DATA variable.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.allow-webdav-methods">
<term>
<parameter>allow_webdav_methods</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Allow handling of WebDAV http requests within PHP scripts (eg.
PROPFIND, PROPPATCH, MOVE, COPY, etc..)
If you want to get the post data of those requests, you have to
set <link linkend="ini.always-populate-raw-post-data">
always_populate_raw_post_data</link> as well.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
See also: <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>,
<link linkend="ini.magic-quotes-runtime">magic_quotes_runtime</link>,
and
<link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>.
</para>
</sect1>
<sect1 id="ini.sect.path-directory">
<title>Paths and Directories</title>
<para>
<table>
<title>Paths and Directories Configuration Options</title>
<tgroup cols="3">
<thead>
<row>
<entry>Name</entry>
<entry>Default</entry>
<entry>Changeable</entry>
</row>
</thead>
<tbody>
<row>
<entry>include_path</entry>
<entry>PHP_INCLUDE_PATH</entry>
<entry>PHP_INI_ALL</entry>
</row>
<row>
<entry>doc_root</entry>
<entry>PHP_INCLUDE_PATH</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>user_dir</entry>
<entry>NULL</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>extension_dir</entry>
<entry>PHP_EXTENSION_DIR</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>cgi.fix_pathinfo</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>cgi.force_redirect</entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>cgi.redirect_status_env</entry>
<entry>""</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>fastcgi.impersonate</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>cgi.rfc2616_headers</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.include-path">
<term>
<parameter>include_path</parameter>
<type>string</type>
</term>
<listitem>
<para>
Specifies a list of directories where the
<function>require</function>, <function>include</function>
and <function>fopen_with_path</function> functions look for
files. The format is like the system's <envar>PATH</envar>
environment variable: a list of directories separated with a
colon in Unix or semicolon in Windows.
</para>
<para>
<example>
<title>Unix include_path</title>
<programlisting role="php.ini">
<![CDATA[
include_path=".:/php/includes"
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Windows include_path</title>
<programlisting role="php.ini">
<![CDATA[
include_path=".;c:\php\includes"
]]>
</programlisting>
</example>
</para>
<para>
Using a <literal>.</literal> in the include path allows for
relative includes as it means the current directory.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.doc-root">
<term>
<parameter>doc_root</parameter>
<type>string</type>
</term>
<listitem>
<para>
PHP's "root directory" on the server. Only used if
non-empty. If PHP is configured with &safemode;, no files outside
this directory are served.
If PHP was not compiled with FORCE_REDIRECT, you <emphasis>should
</emphasis> set doc_root if you are running PHP as a CGI under any web
server (other than IIS). The alternative is to use the
<link linkend="ini.cgi.force-redirect">
cgi.force_redirect</link> configuration below.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.user-dir">
<term>
<parameter>user_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
The base name of the directory used on a user's home directory for PHP
files, for example <filename class="directory">public_html
</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.extension-dir">
<term>
<parameter>extension_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
In what directory PHP should look for dynamically loadable
extensions. See also: <link linkend="ini.enable-dl">enable_dl</link>,
and <function>dl</function>.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.extension">
<term>
<parameter>extension</parameter>
<type>string</type>
</term>
<listitem>
<para>
Which dynamically loadable extensions to load when PHP starts
up.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.cgi.fix_pathinfo">
<term>
<parameter>cgi.fix_pathinfo</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Provides <emphasis>real</emphasis> PATH_INFO/PATH_TRANSLATED
support for CGI. PHP's previous behaviour was to set
PATH_TRANSLATED to SCRIPT_FILENAME, and to not grok what PATH_INFO
is. For more information on PATH_INFO, see the cgi specs. Setting
this to 1 will cause PHP CGI to fix it's paths to conform to the
spec. A setting of zero causes PHP to behave as before. Default
is zero. You should fix your scripts to use SCRIPT_FILENAME rather
than PATH_TRANSLATED.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.cgi.force-redirect">
<term>
<parameter>cgi.force_redirect</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
cgi.force_redirect is necessary to provide security running PHP as a
CGI under most web servers. Left undefined, PHP turns this on by
default. You can turn it off <emphasis>at your own risk</emphasis>.
</para>
<note>
<para>
Windows Users: You <emphasis>can</emphasis> safely turn this off for
IIS, in fact, you <emphasis>must</emphasis>.
To get OmniHTTPD or Xitami to work you <emphasis>must</emphasis> turn
it off.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.cgi.redirect-status-env">
<term>
<parameter>cgi.redirect_status_env</parameter>
<type>string</type>
</term>
<listitem>
<para>
If cgi.force_redirect is turned on, and you are not running under
Apache or Netscape (iPlanet) web servers, you <emphasis>may</emphasis>
need to set an environment variable name that PHP will look for to
know it is OK to continue execution.
</para>
<note>
<para>
Setting this variable <emphasis>may</emphasis> cause security issues,
<emphasis>know what you are doing first</emphasis>.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry id="ini.fastcgi.impersonate">
<term>
<parameter>fastcgi.impersonate</parameter>
<type>string</type>
</term>
<listitem>
<para>
FastCGI under IIS (on WINNT based OS) supports the ability to impersonate
security tokens of the calling client. This allows IIS to define the
security context that the request runs under. mod_fastcgi under Apache
does not currently support this feature (03/17/2002)
Set to 1 if running under IIS. Default is zero.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.cgi.rfc2616-headers">
<term>
<parameter>cgi.rfc2616_headers</parameter>
<type>int</type>
</term>
<listitem>
<para>
Tells PHP what type of headers to use when sending HTTP response
code. If it's set 0, PHP sends a Status: header that is supported
by Apache and other web servers. When this option is set to 1, PHP
will send <ulink url="&url.rfc;2616">RFC 2616</ulink> compliant
headers. Leave it set to 0 unless you know what you're doing.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="ini.sect.file_uploads">
<title>File Uploads</title>
<para>
<table>
<title>File Uploads Configuration Options</title>
<tgroup cols="3">
<thead>
<row>
<entry>Name</entry>
<entry>Default</entry>
<entry>Changeable</entry>
</row>
</thead>
<tbody>
<row>
<entry>file_uploads</entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>upload_tmp_dir</entry>
<entry>NULL</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
<row>
<entry>upload_max_filesize</entry>
<entry>"2M"</entry>
<entry>PHP_INI_SYSTEM|PHP_INI_PERDIR</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.file-uploads">
<term>
<parameter>file_uploads</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Whether or not to allow HTTP
<link linkend="features.file-upload">file uploads</link>. See also
the
<link linkend="ini.upload-max-filesize">upload_max_filesize</link>,
<link linkend="ini.upload-tmp-dir">upload_tmp_dir</link>, and
<link linkend="ini.post-max-size">post_max_size</link> directives.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.upload-tmp-dir">
<term>
<parameter>upload_tmp_dir</parameter>
<type>string</type>
</term>
<listitem>
<para>
The temporary directory used for storing files when doing
file upload. Must be writable by whatever user PHP
is running as. If not specified PHP will use the system's default.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.upload-max-filesize">
<term>
<parameter>upload_max_filesize</parameter>
<type>integer</type>
</term>
<listitem>
<para>
The maximum size of an uploaded file.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="ini.sql-general">
<title>General SQL</title>
<para>
<table>
<title>General SQL Configuration Options</title>
<tgroup cols="3">
<thead>
<row>
<entry>Name</entry>
<entry>Default</entry>
<entry>Changeable</entry>
</row>
</thead>
<tbody>
<row>
<entry>sql.safe_mode</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry id="ini.sql.safe-mode">
<term>
<parameter>sql.safe_mode</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<sect1 id="ini.sect.debugger">
<title>Debugger Configuration Directives</title>
<caution>
<para>
Only PHP 3 implements a default debugger, for more information see <xref
linkend="debugger"/>.
</para>
</caution>
<variablelist>
<varlistentry id="ini.debugger.host">
<term>
<parameter>debugger.host</parameter>
<type>string</type>
</term>
<listitem>
<para>
DNS name or IP address of host used by the debugger.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.debugger.port">
<term>
<parameter>debugger.port</parameter>
<type>string</type>
</term>
<listitem>
<para>
Port number used by the debugger.
</para>
</listitem>
</varlistentry>
<varlistentry id="ini.debugger.enabled">
<term>
<parameter>debugger.enabled</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
Whether the debugger is enabled.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
</appendix>
<!-- 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:"../../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
-->