cvs: phpdoc-sv /chapters config.xml
[email protected] ("Per Gustafsson") Sun, 05 Jan 2003 13:52:54 -0000
| Newsgroups | php.doc.sv |
|---|---|
| Message-ID | <cvsjome1041774774@cvsserver> |
jome Sun Jan 5 08:52:54 2003 EDT
Modified files:
/phpdoc-sv/chapters config.xml
Log:
sync with english
jome-20030105085254.txt
(text/plain, 66.4 KB)
Index: phpdoc-sv/chapters/config.xml
diff -u phpdoc-sv/chapters/config.xml:1.6 phpdoc-sv/chapters/config.xml:1.7
--- phpdoc-sv/chapters/config.xml:1.6 Sun Sep 29 13:33:10 2002
+++ phpdoc-sv/chapters/config.xml Sun Jan 5 08:52:54 2003
@@ -1,11 +1,10 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- EN-Revision: 1.78 Maintainer: Jome Status: not ready -->
+<!-- EN-Revision: 1.89 Maintainer: Jome Status: not ready -->
<chapter id="configuration">
<title>Konfiguration</title>
<sect1 id="configuration.file">
<title>Konfigurationsfilen</title>
-
<simpara>
Konfigurationsfilen (kallad <filename>php3.ini</filename> i PHP
3.0 och helt enkelt &php.ini; från och med PHP 4.0) läses av då
@@ -32,10 +31,10 @@
</para>
<note>
<para>
- Standardvärdet för PHP-direktiven
- <link linkend="ini.register-globals">register_globals</link> ändrades
- från <emphasis>on</emphasis> till <emphasis>off</emphasis> i PHP
- <ulink url="&url.php.release4.2.0;">4.2.0</ulink>.
+ Standardvärdet för PHP-direktiven
+ <link linkend="ini.register-globals">register_globals</link> ändrades
+ från <emphasis>on</emphasis> till <emphasis>off</emphasis> i PHP
+ <ulink url="&url.php.release4.2.0;">4.2.0</ulink>.
</para>
</note>
<para>
@@ -61,77 +60,91 @@
<!-- TODO: add more details about values and expressions -->
</example>
</para>
+ </sect1>
- <simpara>
- När PHP används som Apache-modul, kan du ändra inställningar
- med hjälp av Apache's konfigurationsfiler och .htaccess-filer.
- (Du behöver "AllowOverride Options" och "AllowOverride
- All"-rättigheter för att det ska fungera.)
- </simpara>
+ <sect1 id="configuration.changes">
+ <title>How to change configuration settings</title>
- <simpara>
- Med PHP 3.0 finns Apache-direktiv motsvarande varje inställning
- i <filename>php3.ini</filename>, och med samma namn som i filen
- förutom att det inleds med "php3_".
- </simpara>
+ <sect2 id="configuration.changes.apache">
+ <title>Running <literal>PHP</literal> as Apache module</title>
+ <simpara>
+ När PHP används som Apache-modul, kan du ändra inställningar
+ med hjälp av Apache's konfigurationsfiler och .htaccess-filer.
+ (Du behöver "AllowOverride Options" och "AllowOverride
+ All"-rättigheter för att det ska fungera.)
+ </simpara>
+
+ <simpara>
+ Med PHP 3.0 finns Apache-direktiv motsvarande varje inställning
+ i <filename>php3.ini</filename>, och med samma namn som i filen
+ förutom att det inleds med "php3_".
+ </simpara>
- <para>
- Med PHP 4.0, finns ett antal Apache-direktiv som gör det
- möjligt för dig att ändra PHP-inställningar i Apache's
- konfigurationsfil.
- <variablelist>
- <varlistentry>
- <term>
- <systemitem role="directive">php_value</systemitem>
- <parameter>name</parameter>
- <parameter>value</parameter>
- </term>
- <listitem>
- <para>
- Det här tilldelar den specificerade variabeln ett värde.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <systemitem role="directive">php_flag</systemitem>
- <parameter>name</parameter>
- <parameter>on|off</parameter>
- </term>
- <listitem>
- <para>
- Det här används för att sätta booleska inställningar.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <systemitem role="directive">php_admin_value</systemitem>
- <parameter>name</parameter>
- <parameter>value</parameter>
- </term>
- <listitem>
- <para>
- Det här tilldelar den specificerade variabeln ett värde.
- "Admin"-inställningar kan bara ändras inuti Apache's
- konfigurationsfil och inte i .htaccess-filer.</para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <systemitem role="directive">php_admin_flag</systemitem>
- <parameter>name</parameter>
- <parameter>on|off</parameter>
- </term>
- <listitem>
- <para>
- Det här används för att sätta booleska inställningar.</para>
- </listitem>
- </varlistentry>
- </variablelist>
- </para>
- <para>
- <example>
- <title>Konfigurationsexempel för Apache</title>
- <programlisting role="ini">
+ <para>
+ Med PHP 4.0, finns ett antal Apache-direktiv som gör det
+ möjligt för dig att ändra PHP-inställningar i Apache's
+ konfigurationsfil.
+ <variablelist>
+ <varlistentry>
+ <term>
+ <systemitem role="directive">php_value</systemitem>
+ <parameter>name</parameter>
+ <parameter>value</parameter>
+ </term>
+ <listitem>
+ <para>
+ Det här tilldelar den specificerade variabeln ett värde.</para>
+ <informalexample>
+ <programlisting role="ini">
+<![CDATA[
+php_value auto_prepend_file none
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <systemitem role="directive">php_flag</systemitem>
+ <parameter>name</parameter>
+ <parameter>on|off</parameter>
+ </term>
+ <listitem>
+ <para>
+ Det här används för att sätta booleska inställningar.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <systemitem role="directive">php_admin_value</systemitem>
+ <parameter>name</parameter>
+ <parameter>value</parameter>
+ </term>
+ <listitem>
+ <para>
+ Det här tilldelar den specificerade variabeln ett värde.
+ "Admin"-inställningar kan bara ändras inuti Apache's
+ konfigurationsfil och inte i .htaccess-filer.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <systemitem role="directive">php_admin_flag</systemitem>
+ <parameter>name</parameter>
+ <parameter>on|off</parameter>
+ </term>
+ <listitem>
+ <para>
+ Det här används för att sätta booleska inställningar.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ <example>
+ <title>Konfigurationsexempel för Apache</title>
+ <programlisting role="ini">
<![CDATA[
<IfModule mod_php4.c>
php_value include_path ".:/usr/local/lib/php"
@@ -142,68 +155,186 @@
php3_safe_mode on
</IfModule>
]]>
-</programlisting>
- </example>
+ </programlisting>
+ </example>
- <note>
- <para>
- PHP-konstanter existerar inte utanför PHP. T.ex. kan du inte
- använda PHP-konstanter såsom <constant>E_ALL</constant> eller
- <constant>E_NOTICE</constant> i <filename>httpd.conf</filename>
- för att sätta
- <link linkend="ini.error-reporting">error_reporting</link>-direktivet.
- De kommer, om du gör så, inte få någon annan än betydelse än
- <emphasis>0</emphasis>. Använd bitmaskar för att sätta värdena
- istället. Följande konstanter kan användas i &php.ini;
- </para>
- </note>
- </para>
+ <note>
+ <para>
+ PHP-konstanter existerar inte utanför PHP. T.ex. kan du inte
+ använda PHP-konstanter såsom <constant>E_ALL</constant> eller
+ <constant>E_NOTICE</constant> i <filename>httpd.conf</filename>
+ för att sätta
+ <link linkend="ini.error-reporting">error_reporting</link>-direktivet.
+ De kommer, om du gör så, inte få någon annan än betydelse än
+ <emphasis>0</emphasis>. Använd bitmaskar för att sätta värdena
+ istället. Följande konstanter kan användas i &php.ini;
+ </para>
+ </note>
+ </para>
+ </sect2>
- <simpara>
- Du kan se dina inställningar med hjälp av det som skrivs ut av
- <function>phpinfo</function>. Du kan också kontrollera specifika
- direktiv genom <function>ini_get</function> eller
- <function>get_cfg_var</function>.
- </simpara>
-
- <sect2 id="ini.sect.general">
- <title>Generella konfigurationsdirektiv</title>
+ <sect2 id="configuration.changes.other">
+ <title>Other interfaces to <literal>PHP</literal></title>
+ <para>
+ Regardless of the interface to <literal>PHP</literal> you can change
+ certain values at runtime of your scripts through
+ <function>ini_set</function>. The following table provides an overview
+ at which level a directive can be set/changed.
+ </para>
+ <para>
+ <table>
+ <title>Definition of PHP_INI_* constants</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Constant</entry>
+ <entry>Value</entry>
+ <entry>Meaning</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>PHP_INI_USER</entry>
+ <entry>1</entry>
+ <entry>Entry can be set in user scripts</entry>
+ </row>
+ <row>
+ <entry>PHP_INI_PERDIR</entry>
+ <entry>2</entry>
+ <entry>
+ Entry can be set in &php.ini;, <filename>.htaccess</filename> or
+ <filename>httpd.conf</filename>
+ </entry>
+ </row>
+ <row>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>4</entry>
+ <entry>
+ Entry can be set in &php.ini; or <filename>httpd.conf</filename>
+ </entry>
+ </row>
+ <row>
+ <entry>PHP_INI_ALL</entry>
+ <entry>7</entry>
+ <entry>Entry can be set anywhere</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
<para>
+ Du kan se dina inställningar med hjälp av det som skrivs ut av
+ <function>phpinfo</function>. Du kan också kontrollera specifika
+ direktiv genom <function>ini_get</function> eller
+ <function>get_cfg_var</function>.
+ </para>
+ </sect2>
+ </sect1>
+
+ <sect1 id="configuration.directives">
+ <title>Configuration directives</title>
+
+ <sect2 id="ini.sect.httpd-options">
+ <title>Httpd Options</title>
+ <para>
+ <table>
+ <title>Httpd Options</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default</entry>
+ <entry>Changeable</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>async_send</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ </para>
+ </sect2>
+
+ <sect2 id="ini.sect.language-options">
+ <title>Language Options</title>
+ <para>
+ <table>
+ <title>Language and Misc Configuration Options</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default</entry>
+ <entry>Changeable</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>
+ <para>
+ Here is a short explanation of the configuration directives.
<variablelist>
- <varlistentry id="ini.allow-url-fopen">
+ <varlistentry id="ini.short-open-tag">
<term>
- <parameter>allow_url_fopen</parameter>
+ <parameter>short_open_tag</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
- Det här direktivet bestämmer huruvida fopen-packare som tar
- URL:er ska kunna användas eller inte. Standardpackare medföljer
- som gör det möjligt att komma åt
- <link linkend="features.remote-files">externa filer</link> med
- hjälp av ftp- och http-protokollen. Vissa tillägg, såsom t.ex.
- zlib kan registrera extra packare.
+ Tells whether the short form (<userinput><? ?></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><?xml ?></userinput> inline. Otherwise, you
+ can print it with PHP, for example: <userinput><?php echo '<?xml
+ version="1.0"'; ?></userinput>. Also if disabled, you must use the
+ long form of the PHP open tag (<userinput><?php ?></userinput>).
</para>
-
<note>
<para>
- Det här direktivet introducerades direkt efter att version 4.0.3
- släppts. För versioner upp till och med 4.0.3 kan du endast stänga
- av det vid kompileringen med hjälp av konfigurationsväxeln
- <link linkend="install.configure.disable-url-fopen-wrapper"><parameter>
- --disable-url-fopen-wrapper</parameter></link>.
+ This directive also affects the shorthand <userinput><?=</userinput>,
+ which is identical to <userinput><? echo</userinput>. Use of this
+ shortcut requires <systemitem role="directive">short_open_tag</systemitem>
+ to be on.
</para>
</note>
- <warning>
- <para>
- Under Windows-versioner äldre än PHP 4.3 stödjer följande funktioner inte åtkomst av
- externa filer: <function>include</function>,
- <function>include_once</function>, <function>require</function> och
- <function>require_once</function> samt imagecreatefromXXX-funktionerna
- i <xref linkend="ref.image"/>bild-tillägget.
- </para>
- </warning>
-
</listitem>
</varlistentry>
@@ -220,268 +351,375 @@
För mer information, se
<link linkend="language.basic-syntax.phpmode">Växla från HTML</link>.
</simpara>
-
<note>
<para>
Stöd för ASP-liknande taggar lades till i version 3.0.4.
- </para>
+ </para>
</note>
-
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.auto-append-file">
- <term>
- <parameter>auto_append_file</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Specificerar namnet på en fil som inkluderas direkt efter
- huvudfilen. Filen inkluderas på samma sätt som om den hade
- inkluderats med funktionen <function>include</function>, vilket
- betyder att <link linkend="ini.include-path">include_path</link>
- används.</para>
- <para>
- Specialvärdet <systemitem class="constant">none</systemitem>
- stänger av den här funktionen.
- <note>
- <simpara>
- Om scriptet termineras med hjälp av <function>exit</function>,
- kommer filen <emphasis>inte</emphasis> att inkluderas.</simpara>
- </note>
- </para>
</listitem>
</varlistentry>
- <varlistentry id="ini.auto-prepend-file">
+ <varlistentry id="ini.precision">
<term>
- <parameter>auto_prepend_file</parameter>
- <type>string</type>
+ <parameter>precision</parameter>
+ <type>integer</type>
</term>
<listitem>
- <para>
- Specificerar namnet på en fil som inkluderas direkt före
- huvudfilen. Filen inkluderas på samma sätt som om den hade
- inkluderats med funktionen <function>include</function>, vilket
- betyder att <link linkend="ini.include-path">include_path</link>
- används.</para>
- <para>
- Specialvärdet <systemitem class="constant">none</systemitem>
- stänger av den här funktionen.
- </para>
+ <simpara>
+ Antalet signifikanta siffror visade av flyttal.
+ </simpara>
</listitem>
</varlistentry>
- <varlistentry id="ini.disable-functions">
+ <varlistentry id="ini.y2k-compliance">
<term>
- <parameter>disable_functions</parameter>
- <type>string</type>
+ <parameter>y2k_compliance</parameter>
+ <type>boolean</type>
</term>
<listitem>
<simpara>
- Med det här direktivet kan vissa funktioner göras oåtkomliga
- på grund av <link linkend="security">säkerhetsrisker</link>.
- Direktivet tar en kommaseparerad lista över funktionsnamn.
- disable_functions påverkas inte av s k
- <link linkend="ini.safe-mode">Safe Mode</link>.
- </simpara>
- <simpara>
- Det här direktivet måste defineras i &php.ini; Du kan t.ex.
- inte ange det i <filename>httpd.conf</filename>.
+ Enforce year 2000 compliance (will cause problems with non-compliant browsers)
</simpara>
</listitem>
</varlistentry>
-
- <varlistentry id="ini.display-errors">
+
+
+ <varlistentry id="allow-call-time-pass-reference">
<term>
- <parameter>display_errors</parameter>
+ <parameter>allow_call_time_pass_reference</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
- Det här direktivet bestämmer huruvida felmeddelanden ska
- skrivas ut som en del av HTML-koden eller inte.
+ Whether to enable the ability to force arguments to be passed by reference
+ at function call time. This method is deprecated and is likely to be
+ unsupported in future versions of PHP/Zend. The encouraged method of
+ specifying which arguments should be passed by reference is in the function
+ declaration. You're encouraged to try and turn this option Off and make
+ sure your scripts work properly with it in order to ensure they will work
+ with future versions of the language (you will receive a warning each time
+ you use this feature, and the argument will be passed by value instead of by
+ reference).
</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.doc-root">
- <term>
- <parameter>doc_root</parameter>
- <type>string</type>
- </term>
- <listitem>
<para>
- PHP's "rotkatalog" på servern. Används bara om den
- inte är tom. Om s k
- <link linkend="ini.safe-mode">safe mode</link> är aktivt
- kan inga filer utanför den här katalogen kommas åt.
+ See also <link linkend="language.references">References Explained</link>.
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.error-log">
+ <varlistentry id="expose-php">
<term>
- <parameter>error_log</parameter>
- <type>string</type>
+ <parameter>expose_php</parameter>
+ <type>boolean</type>
</term>
<listitem>
<para>
- Namn på filen där script-fel ska loggas. Om specialvärdet
- <literal>syslog</literal> anges, skickas felmeddelanden
- till systemloggen istället. Under UNIX betyder det syslog(3)
- och under Windows NT betyder det händelseloggen.
- Det finns inte stöd för systemloggen under Windows 95.
+ Decides whether PHP may expose the fact that it is installed on the server
+ (e.g. by adding its signature to the Web server header). It is no security
+ threat in any way, but it makes it possible to determine whether you use PHP
+ on your server or not.
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
+
+ <sect2 id="ini.sect.resource-limits">
+ <title>Resource Limits</title>
+ <para>
+ <table>
+ <title>Resource Limits</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default</entry>
+ <entry>Changeable</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>memory_limit</entry>
+ <entry>"8M"</entry>
+ <entry>PHP_INI_ALL</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ Here is a short explanation of the configuration directives.
+ <variablelist>
+
+ <varlistentry id="ini.memory-limit">
+ <term>
+ <parameter>memory_limit</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <para>
+ Detta sätter hur mycket minne i bytes som ett script maximalt
+ tillåts allokera. Direktivet förebygger att dåligt skrivna script
+ äter upp allt minne på severn.
+ In order to
+ use this directive you must have enabled it at compile time. So,
+ your configure line would have included:
+ <literal>--enable-memory-limit</literal>. Note that you have to set
+ it to -1 if you don't want any limit for your memory.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ <para>
+ See also: <link linkend="ini.max-execution-time">max_execution_time</link>.
+ </para>
+ </sect2>
- <varlistentry id="ini.error-reporting">
+ <sect2 id="ini.sect.data-handling">
+ <title>Data Handling</title>
+ <para>
+ <table>
+ <title>Data Handling Configuration Options</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Name</entry>
+ <entry>Default</entry>
+ <entry>Changeable</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>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>
+ <para>
+ Here is a short explanation of the configuration directives.
+ <variablelist>
+ <varlistentry id="ini.track-vars">
<term>
- <parameter>error_reporting</parameter>
- <type>integer</type>
+ <parameter>track_vars</parameter>
+ <type>boolean</type>
</term>
<listitem>
<para>
- Bestämmer felrapporteringsnivån. Värdet är antingen ett heltal
- eller en namngiven konstant. De olika nivåerna samt konstanterna
- finns beskrivna under
- <link linkend="features.error-handling">felhantering</link> samt
- i &php.ini;. För att definera vid körning kan du använda
- <function>error_reporting</function>-funktionen. Se även
- <link linkend="ini.display-errors">display_errors</link>-direktivet.
+ If enabled, then Environment, GET, POST, Cookie, and Server
+ variables can be found in the global associative arrays
+ <varname>$_ENV</varname>,
+ <varname>$_GET</varname>,
+ <varname>$_POST</varname>,
+ <varname>$_COOKIE</varname>, and
+ <varname>$_SERVER</varname>.
</para>
<para>
- Standardvärdet visar inte fel på <constant>E_NOTICE</constant>-nivå.
- Det kan vara idé att visa dem då du utvecklar.
+ Note that as of PHP 4.0.3, <systemitem
+ role="directive">track_vars</systemitem> is always turned on.
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.file-uploads">
- <term>
- <parameter>file_uploads</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- Huruvida du vill tillåta <link linkend="features.file-upload">filuppladdning</link>
- via HTTP eller inte. Se även
- <link linkend="ini.upload-max-filesize">upload_max_filesize</link>-,
- <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link>- och
- <link linkend="ini.post-max-size">post_max_size</link>-direktiven.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.html-errors">
+ <varlistentry id="ini.arg-separator.output">
<term>
- <parameter>html_errors</parameter>
- <type>boolean</type>
+ <parameter>arg_separator.output</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Stäng av HTML-taggar i felmeddelanden. Det nya formatet för
- HTML-felmeddelanden skapar länkar i meddelanden som skickar
- användaren till en sida som beskriver felet eller funktionen
- som orsakar felet. De här referenserna påverkas av
- <link linkend="ini.docref-root">docref_root</link> och
- <link linkend="ini.docref-ext">docref_ext</link>.
+ The separator used in PHP generated URLs to separate arguments.
</para>
</listitem>
</varlistentry>
-
- <varlistentry id="ini.docref-root">
+
+ <varlistentry id="arg-separator.input">
<term>
- <parameter>docref_root</parameter>
+ <parameter>arg_separator.input</parameter>
<type>string</type>
</term>
<listitem>
<para>
- Den nya typen av felmeddelanden innehåller en referens till en sida som
- beskriver felet eller funktionen som orsakar felet. Om det handlar om
- manualsidor kan du ladda hem manualen på svenska (eller något annat språk)
- och sätta direktivet till adressen till din lokala kopia. Om din lokala
- kopia kan nås via '/manual/' kan du helt enkelt skriva
- <userinput>docref_root=/manual/</userinput>. Du behöver även sätta
- docref_ext så att den matchar filtypen på din kopia av manualen, t.ex.
- <userinput>docref_ext=.html</userinput>. Det är även möjligt att använda
- externa referenser. Du kan t.ex. använda
- <userinput>docref_root=http://manual/en/</userinput>.
+ List of separator(s) used by PHP to parse input URLs into variables.
</para>
<note>
<para>
- Värdet på docref_root måste avslutas med ett snedstreck '/'.
+ Every character in this directive is considered as separator!
</para>
</note>
</listitem>
</varlistentry>
- <varlistentry id="ini.docref-ext">
+ <varlistentry id="ini.variables-order">
<term>
- <parameter>docref_ext</parameter>
+ <parameter>variables_order</parameter>
<type>string</type>
</term>
<listitem>
<para>
- Se <link linkend="ini.docref-root">docref_root</link>.
+ Bestäm ordningen för vilka EGPCS (Environment, GET, POST, Cookie,
+ Server) ska defineras. Standardvärdet för det här direktivet
+ är "EGPCS". Om du t.ex. sätter värdet till "GP" kommer
+ PHP helt att ignorera cookie-, server- och miljö-variabler
+ och skriva över alla GET-värden med POST-värden i de fall
+ då de har samma namn.
+ </para>
+ <para>
+ Se även <link linkend="ini.register-globals">register_globals</link>.
</para>
- <note>
- <para>
- Värdet på docref_ext måste börja med en punkt '.'.
- </para>
- </note>
</listitem>
</varlistentry>
-
- <varlistentry id="ini.open-basedir">
+
+ <varlistentry id="ini.register-globals">
<term>
- <parameter>open_basedir</parameter>
- <type>string</type>
+ <parameter>register_globals</parameter>
+ <type>boolean</type>
</term>
<listitem>
<para>
- Begränsa PHP's rättigheter att öppna filer till
- det specifika katalogträdet.
+ Tells whether or not to register the EGPCS (Environment, GET,
+ POST, Cookie, Server) variables as global variables. For example;
+ if register_globals = on, the url
+ <literal>http://www.example.com/test.php?id=3</literal> will produce
+ <varname>$id</varname>. Or, <varname>$DOCUMENT_ROOT</varname> from
+ <varname>$_SERVER['DOCUMENT_ROOT']</varname>. You may want to turn
+ this off if you don't want to clutter your scripts' global scope with
+ user data. As of PHP <ulink url="&url.php.release4.2.0;">4.2.0</ulink>,
+ this directive defaults to <emphasis>off</emphasis>. It's preferred to
+ go through PHP <link linkend="reserved.variables">Predefined Variables
+ </link> instead, such as the
+ <link linkend="language.variables.superglobals">superglobals</link>:
+ <varname>$_ENV</varname>, <varname>$_GET</varname>,
+ <varname>$_POST</varname>, <varname>$_COOKIE</varname>, and
+ <varname>$_SERVER</varname>. Please read the security chapter on
+ <link linkend="security.registerglobals">Using register_globals</link>
+ for related information.
</para>
<para>
- När ett script försöker öppna en fil med t.ex. fopen eller
- gzopen kontrolleras sökvänge till filen. Om filen befinner
- sig utanför katalogträdet kommer PHP att neka åtkomst till
- filen. Alla symboliska länkar kontrolleras så det är inte
- möjligt att gå förbi restriktionen med hjälp av sådana.
- </para>
- <para>
- Specialvärdet <systemitem class="constant">.</systemitem>
- betyder att katalogen i vilket script befinner sig används som
- baskatalog.
- </para>
- <para>
- Under Windows separeras kataloger med semikolon. På alla andra
- system används vanligt kolon. Då PHP körs som Apache-modul ärvs
- open_basedir-sökvägar från föregående kataloger per automatik.
- </para>
- <para>
- Definitionen av värdet på open_basedir är egentligen
- prefix och inte katalog. Det betyder att om värdet för
- open_basedir är satt till "/dir/incl" kan filer som heter
- t.ex. "/dir/include" och "/dir/incls" inkluderas (förutsatt
- att de existerar). Du kan undvika de möjligheterna genom
- att lägga still ett snedstreck på slutet av värdet. T.ex.:
- "open_basedir = /dir/incl/"
+ Please note that <systemitem role="directive">register_globals</systemitem>
+ cannot be set at runtime (<function>ini_set</function>). Although, you can
+ use <filename>.htaccess</filename> if your host allows it as described
+ above. An example <filename>.htaccess</filename> entry:
+ <userinput>php_flag register_globals on</userinput>.
</para>
<note>
<para>
- Stöd för flera kataloger lades till i version 3.0.7.
+ <systemitem role="directive">register_globals</systemitem> is affected
+ by the <link linkend="ini.variables-order">variables_order</link>
+ directive.
</para>
</note>
- <para>
- Standard är att tillåta att all filer får öppnas.
- </para>
</listitem>
</varlistentry>
-
+
+ <varlistentry id="ini.register-argc-argv">
+ <term>
+ <parameter>register_argc_argv</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <simpara>
+ Talar om för PHP huruvida det ska deklarera argv- och
+ argc-variablerna (vilka skulle innehålla GET-information).
+ </simpara>
+ <simpara>
+ Se även <link linkend="features.commandline">kommandorad</link>.
+ Det här direktivet kom i och med PHP 4.0.0 och var alltid
+ påslaget i tidigare versioner.
+ </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>
@@ -495,78 +733,178 @@
ignorera cookies samt skriva över alla GET-värden med
POST-värden i de fall då de har samma namn.
</para>
+ <note>
+ <para>
+ Notera att det direktivet är inte tillgängligt i PHP 4.
+ Använd <link linkend="ini.variables-order">variables_order</link>
+ istället.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.auto-prepend-file">
+ <term>
+ <parameter>auto_prepend_file</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
<para>
- Notera att det direktivet är inte tillgängligt i PHP 4.
- Använd <link linkend="ini.variables-order">variables_order</link>
- istället.
+ Specificerar namnet på en fil som inkluderas direkt före
+ huvudfilen. Filen inkluderas på samma sätt som om den hade
+ inkluderats med funktionen <function>include</function>, vilket
+ betyder att <link linkend="ini.include-path">include_path</link>
+ används.</para>
+ <para>
+ Specialvärdet <systemitem class="constant">none</systemitem>
+ stänger av den här funktionen.
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.variables-order">
+ <varlistentry id="ini.auto-append-file">
<term>
- <parameter>variables_order</parameter>
+ <parameter>auto_append_file</parameter>
<type>string</type>
</term>
<listitem>
<para>
- Bestäm ordningen för vilka EGPCS (Environment, GET, POST, Cookie,
- Server) ska defineras. Standardvärdet för det här direktivet
- är "EGPCS". Om du t.ex. sätter värdet till "GP" kommer
- PHP helt att ignorera cookie-, server- och miljö-variabler
- och skriva över alla GET-värden med POST-värden i de fall
- då de har samma namn.
- </para>
+ Specificerar namnet på en fil som inkluderas direkt efter
+ huvudfilen. Filen inkluderas på samma sätt som om den hade
+ inkluderats med funktionen <function>include</function>, vilket
+ betyder att <link linkend="ini.include-path">include_path</link>
+ används.</para>
<para>
- Se även <link linkend="ini.register-globals">register_globals</link>.
+ Specialvärdet <systemitem class="constant">none</systemitem>
+ stänger av den här funktionen.
+ <note>
+ <simpara>
+ Om scriptet termineras med hjälp av <function>exit</function>,
+ kommer filen <emphasis>inte</emphasis> att inkluderas.</simpara>
+ </note>
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.ignore-user-abort">
+ <varlistentry id="ini.default-mimetype">
<term>
- <parameter>ignore_user_abort</parameter>
- <type>boolean</type>
+ <parameter>default_mimetype</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- &true; som standard. Om det ändras till &false; kommer script att
- avslutas om de försöker skriva ut något efter det att klienten
- stängt sin anslutning.
</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.default-charset">
+ <term>
+ <parameter>default_charset</parameter>
+ <type>string</type>
+ </term>
+ <listitem>
<para>
- Se även <function>ignore_user_abort</function>.
+ 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.implicit-flush">
+ <varlistentry id="ini.always-populate-raw-post-data">
<term>
- <parameter>implicit_flush</parameter>
+ <parameter>always_populate_raw_post_data</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
- &false; som standard. Om du sätter detta direktiv till &true; betyder
- det att PHP kommer skriva ut det som finns i output-buffern efter varje
- output-block. Det här ger samma effekt som anvädandet av
- <literal>PHP</literal>-funktionen <function>flush</function> efter varje
- <function>print</function>- eller <function>echo</function>-anrop samt
- varje <literal>HTML</literal>-block.
+ 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>
- Att ha detta direktiv satt till &true; i en webbmiljö har
- allvarliga effekter på exekveringshastigheten för script och
- det rekommenderas därför att detta endast används vid
- bugg-letande. Standardvärdet är &true; för detta direktiv
- då <literal>PHP</literal> körs som <literal>CLI SAPI</literal>.
- </para>
- <para>
- Se även <function>ob_implicit_flush</function>.
+ 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>
+ </sect2>
+
+ <sect2 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.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>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <para>
+ Here is a short explanation of the configuration directives.
+ <variablelist>
+
<varlistentry id="ini.include-path">
<term>
<parameter>include_path</parameter>
@@ -580,289 +918,202 @@
filer. Formatet är detsamma som operativsystemets
<envar>PATH</envar>-miljövariabel: listan separeras med
kolon under UNIX och med semikolon under Windows.
+ </para>
+ <para>
<example>
<title>UNIX include_path</title>
- <programlisting role="php3.ini">
+ <programlisting role="php.ini">
<![CDATA[
-include_path=.:/home/httpd/php-lib
+include_path=".:/php/includes"
]]>
- </programlisting>
+ </programlisting>
</example>
+ </para>
+ <para>
<example>
<title>Windows include_path</title>
- <programlisting role="php3.ini">
+ <programlisting role="php.ini">
<![CDATA[
-include_path=".;c:\www\phplib"
+include_path=".;c:\php\includes"
]]>
- </programlisting>
+ </programlisting>
</example>
+ </para>
+ <para>
Standardvärdet för det här direktivet är <literal>.</literal>
(bara nuvarande katalog).</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.log-errors">
- <term>
- <parameter>log_errors</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- Bestämmer huruvida ett scripts felmeddelanden ska loggas
- till serverns fellogg eller inte. Det här direktivet är
- därmed serverspecifikt.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.magic-quotes-gpc">
- <term>
- <parameter>magic_quotes_gpc</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- Bestämmer magic_quotes' värde för GPC-operationer
- (Get/Post/Cookie). Då magic_quotes är påslaget, föregås
- alla ' (enkelt citattecken), " (citationstecken),
- \ (omvänt snedstreck) och NUL's av omvänt snedstreck. Om även
- magic_quotes_sybase är påslaget föregås enkelt citattecken
- av ett enkelt citattecken istället för ett omvänt snedstreck.
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.magic-quotes-runtime">
+ <varlistentry id="ini.doc-root">
<term>
- <parameter>magic_quotes_runtime</parameter>
- <type>boolean</type>
+ <parameter>doc_root</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Om <parameter>magic_quotes_runtime</parameter> är aktiverat,
- kommer de flesta funktioner som returnerar data från någon
- extern källa, inkluderat databaser och text-filer, att
- ha omvända snedstreck framför alla citationstecken. Om
- även <parameter>magic_quotes_sybase</parameter> är påslaget
- kommer enkla citationstecken att föregås av just enkla
- citationstecken istället för omvända snedstreck.
+ PHP's "rotkatalog" på servern. Används bara om den
+ inte är tom. Om s k
+ <link linkend="ini.safe-mode">safe mode</link> är aktivt
+ kan inga filer utanför den här katalogen kommas åt.
+ If PHP was not compiled with FORCE_REDIRECT, you SHOULD 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.magic-quotes-sybase">
+ <varlistentry id="ini.user-dir">
<term>
- <parameter>magic_quotes_sybase</parameter>
- <type>boolean</type>
+ <parameter>user_dir</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Om också <parameter>magic_quotes_sybase</parameter> är
- påslaget kommer enkla citationstecken att föregås av just
- enkla citationstecken istället för omvända snedstreck,
- förutsatt att någon av direktiven
- <parameter>magic_quotes_gpc</parameter> och
- <parameter>magic_quotes_runtime</parameter> också är påslagna.
+ The base name of the directory used on a user's home
+ directory for <literal>PHP</literal> files, for example
+ <literal>public_html</literal>.
</para>
</listitem>
</varlistentry>
- <varlistentry id="ini.max-execution-time">
+ <varlistentry id="ini.extension-dir">
<term>
- <parameter>max_execution_time</parameter>
- <type>integer</type>
+ <parameter>extension_dir</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Detta direktiv sätter den maximala tid som ett script tillåts
- exekveras, före PHP-motorn avbryter det. Det här är en bra
- idé att använda för att undvika att servern alla resurser går
- till ett illa skrivet script. Standardvärdet är <literal>30</literal>.
- </para>
- <para>
- Den maximala exekveringstid påverkas inte av systemanrop,
- funktionen <function>sleep</function>, etc. Vänligen se
- funktionen <function>set_time_limit</function> för fler
- detaljer.
+ 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.memory-limit">
+
+ <varlistentry id="ini.extension">
<term>
- <parameter>memory_limit</parameter>
- <type>integer</type>
+ <parameter>extension</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Detta sätter hur mycket minne i bytes som ett script maximalt
- tillåts allokera. Direktivet förebygger att dåligt skrivna script
- äter upp allt minne på severn.
+ Which dynamically loadable extensions to load when PHP starts
+ up.
</para>
</listitem>
</varlistentry>
-
- <varlistentry id="ini.precision">
- <term>
- <parameter>precision</parameter>
- <type>integer</type>
- </term>
- <listitem>
- <simpara>
- Antalet signifikanta siffror visade av flyttal.
- </simpara>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.register-argc-argv">
- <term>
- <parameter>register_argc_argv</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <simpara>
- Talar om för PHP huruvida det ska deklarera argv- och
- argc-variablerna (vilka skulle innehålla GET-information).
- </simpara>
- <simpara>
- Se även <link linkend="features.commandline">kommandorad</link>.
- Det här direktivet kom i och med PHP 4.0.0 och var alltid
- påslaget i tidigare versioner.
- </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 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 <link
- linkend="ini.post-max-size">post_max_size</link>.
- </simpara>
- </listitem>
- </varlistentry>
- <varlistentry id="ini.register-globals">
+ <varlistentry id="ini.cgi.force-redirect">
<term>
- <parameter>register_globals</parameter>
+ <parameter>cgi.force_redirect</parameter>
<type>boolean</type>
</term>
- <listitem>
- <para>
- Tells whether or not to register the EGPCS (Environment, GET,
- POST, Cookie, Server) variables as global variables. For example;
- if register_globals = on, the url
- <literal>http://www.example.com/test.php?id=3</literal> will produce
- <varname>$id</varname>. Or, <varname>$DOCUMENT_ROOT</varname> from
- <varname>$_SERVER['DOCUMENT_ROOT']</varname>. You may want to turn
- this off if you don't want to clutter your scripts' global scope with
- user data. As of PHP <ulink url="&url.php.release4.2.0;">4.2.0</ulink>,
- this directive defaults to <emphasis>off</emphasis>. It's preferred to
- go through PHP <link linkend="reserved.variables">Predefined Variables
- </link> instead, such as the
- <link linkend="language.variables.superglobals">superglobals</link>:
- <varname>$_ENV</varname>, <varname>$_GET</varname>,
- <varname>$_POST</varname>, <varname>$_COOKIE</varname>, and
- <varname>$_SERVER</varname>. Please read the security chapter on
- <link linkend="security.registerglobals">Using register_globals</link>
- for related information.
- </para>
+ <listitem>
<para>
- Please note that <systemitem role="directive">register_globals</systemitem>
- cannot be set at runtime (<function>ini_set</function>). Although, you can
- use <filename>.htaccess</filename> if your host allows it as described
- above. An example <filename>.htaccess</filename> entry:
- <userinput>php_flag register_globals on</userinput>.
+ 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>
- <systemitem role="directive">register_globals</systemitem> is affected
- by the <link linkend="ini.variables-order">variables_order</link>
- directive.
+ Windows Users: You CAN safely turn this off for IIS, in fact, you MUST.
+ To get OmniHTTPD or Xitami to work you MUST turn it off.
</para>
</note>
</listitem>
</varlistentry>
- <varlistentry id="ini.short-open-tag">
+ <varlistentry id="ini.cgi.redirect-status-env">
<term>
- <parameter>short_open_tag</parameter>
- <type>boolean</type>
+ <parameter>cgi.cgi.redirect_status_env</parameter>
+ <type>string</type>
</term>
<listitem>
<para>
- Tells whether the short form (<userinput><? ?></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><?xml ?></userinput> inline. Otherwise, you
- can print it with PHP, for example: <userinput><?php echo '<?xml
- version="1.0"'; ?></userinput>. Also if disabled, you must use the
- long form of the PHP open tag (<userinput><?php ?></userinput>).
+ If cgi.force_redirect is turned on, and you are not running under
+ Apache or Netscape (iPlanet) web servers, you MAY need to set an
+ environment variable name that PHP will look for to know it is OK
+ to continue execution.
</para>
<note>
<para>
- This directive also affects the shorthand <userinput><?=</userinput>,
- which is identical to <userinput><? echo</userinput>. Use of this
- shortcut requires <systemitem role="directive">short_open_tag</systemitem>
- to be on.
+ Setting this variable MAY cause security issues,
+ KNOW WHAT YOU ARE DOING FIRST.
</para>
</note>
</listitem>
</varlistentry>
- <varlistentry id="ini.sql.safe-mode">
+ <varlistentry id="fastcgi.impersonate">
<term>
- <parameter>sql.safe_mode</parameter>
- <type>boolean</type>
+ <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>
+ </variablelist>
+ </para>
+ </sect2>
- <varlistentry id="ini.track-errors">
- <term>
- <parameter>track_errors</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- If enabled, the last error message will always be present in the
- global variable <varname>$php_errormsg</varname>.</para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.track-vars">
+ <sect2 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>
+ <para>
+ Here is a short explanation of the configuration directives.
+ <variablelist>
+ <varlistentry id="ini.file-uploads">
<term>
- <parameter>track_vars</parameter>
+ <parameter>file_uploads</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
- If enabled, then Environment, GET, POST, Cookie, and Server
- variables can be found in the global associative arrays
- <varname>$_ENV</varname>,
- <varname>$_GET</varname>,
- <varname>$_POST</varname>,
- <varname>$_COOKIE</varname>, and
- <varname>$_SERVER</varname>.
- </para>
- <para>
- Note that as of PHP 4.0.3, <systemitem
- role="directive">track_vars</systemitem> is always turned on.
+ Huruvida du vill tillåta <link linkend="features.file-upload">filuppladdning</link>
+ via HTTP eller inte. Se även
+ <link linkend="ini.upload-max-filesize">upload_max_filesize</link>-,
+ <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link>- och
+ <link linkend="ini.post-max-size">post_max_size</link>-direktiven.
</para>
</listitem>
</varlistentry>
@@ -875,8 +1126,8 @@
<listitem>
<para>
The temporary directory used for storing files when doing
- file upload. Must be writable by whatever user PHP is
- running as.
+ file upload. Must be writable by whatever user <literal>PHP</literal>
+ is running as. If not specified PHP will use the system's default.
</para>
</listitem>
</varlistentry>
@@ -888,117 +1139,54 @@
</term>
<listitem>
<para>
- The maximum size of an uploaded file. The value is
- in bytes.
- </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
- <literal>public_html</literal>.
+ The maximum size of an uploaded file.
</para>
</listitem>
</varlistentry>
+ </variablelist>
+ </para>
+ </sect2>
- <varlistentry id="ini.warn-plus-overloading">
+ <sect2 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>
+ <para>
+ Here is a short explanation of the configuration directives.
+ <variablelist>
+ <varlistentry id="ini.sql.safe-mode">
<term>
- <parameter>warn_plus_overloading</parameter>
+ <parameter>sql.safe_mode</parameter>
<type>boolean</type>
</term>
<listitem>
<para>
- If enabled, this option makes PHP output a warning when the
- plus (<literal>+</literal>) operator is used on strings.
- This is to make it easier to find scripts that need to be
- rewritten to using the string concatenator instead
- (<literal>.</literal>).
</para>
</listitem>
</varlistentry>
-
</variablelist>
</para>
</sect2>
- <sect2 id="ini.sect.safe-mode">
- <title>Safe Mode Configuration Directives</title>
- <variablelist>
-
- <varlistentry id="ini.safe-mode">
- <term>
- <parameter>safe_mode</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- Whether to enable PHP's safe mode. Read the
- <link linkend="security">Security</link> and
- <link linkend="features.safe-mode">Safe Mode</link> chapters for
- more information.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.safe-mode-gid">
- <term>
- <parameter>safe_mode_gid</parameter>
- <type>boolean</type>
- </term>
- <listitem>
- <para>
- Whether to use <literal>UID</literal> (&false;) or
- <literal>GID</literal> (&true;) checking upon file
- access. See <link linkend="features.safe-mode">Safe Mode</link> for
- more information.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.safe-mode-exec-dir">
- <term>
- <parameter>safe_mode_exec_dir</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- If PHP is used in safe mode, <function>system</function> and
- the other functions executing system programs refuse to start
- programs that are not in this directory.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.safe-mode-include-dir">
- <term>
- <parameter>safe_mode_include_dir</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- <literal>UID</literal>/<literal>GID</literal> checks are bypassed when
- including files from this directory and its subdirectories (directory
- must also be in <link linkend="ini.include-path">include_path</link>
- or full path must including).
- </para>
- <simpara>
- As of PHP 4.2.0, this directive can take on a semi-colon separated
- path in a similar fashion to the include_path directive, rather than
- just a single directory.
- </simpara>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect2>
-
<sect2 id="ini.sect.debugger">
<title>Debugger Configuration Directives</title>
<variablelist>
@@ -1042,153 +1230,6 @@
</variablelist>
</sect2>
- <sect2 id="ini.sect.extension">
- <title>Extension Loading Directives</title>
- <variablelist>
-
- <varlistentry 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
- the safe_mode and open_basedir restrictions.
- </para>
- <para>
- The default is to allow dynamic loading, except when using
- safe-mode. In safe-mode, it's always imposible to use
- <function>dl</function>.
- </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.
- </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>
-
- </variablelist>
- </sect2>
-
- <sect2 id="ini.sect.sesam">
- <title>SESAM Configuration Directives</title>
- <variablelist>
-
- <varlistentry id="ini.sesam-oml">
- <term>
- <parameter>sesam_oml</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Name of BS2000 PLAM library containing the loadable SESAM
- driver modules. Required for using SESAM functions. The
- BS2000 PLAM library must be set ACCESS=READ,SHARE=YES
- because it must be readable by the apache server's user id.
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.sesam-configfile">
- <term>
- <parameter>sesam_configfile</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Name of SESAM application configuration file. Required for
- using SESAM functions. The BS2000 file must be readable by
- the apache server's user id.
- </para>
- <para>
- The application configuration file will usually contain a
- configuration like (see SESAM
- reference manual):
- <informalexample>
- <programlisting role="bs2000">
-<![CDATA[
-CNF=B
-NAM=K
-NOTYPE
-]]>
- </programlisting>
- </informalexample>
- </para>
- </listitem>
- </varlistentry>
-
- <varlistentry id="ini.sesam-messagecatalog">
- <term>
- <parameter>sesam_messagecatalog</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Name of SESAM message catalog file. In most cases, this
- directive is not neccessary. Only if the SESAM message file
- is not installed in the system's BS2000 message file table,
- it can be set with this directive.
- </para>
- <para>
- The message catalog must be set ACCESS=READ,SHARE=YES because
- it must be readable by the apache server's user id.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect2>
-
- <sect2 id="ini.sect.browscap">
- <title>Browser Capability Configuration Directives</title>
- <variablelist>
-
- <varlistentry id="ini.browscap">
- <term>
- <parameter>browscap</parameter>
- <type>string</type>
- </term>
- <listitem>
- <para>
- Name of browser capabilities file. See also
- <function>get_browser</function>.
- </para>
- </listitem>
- </varlistentry>
-
- </variablelist>
- </sect2>
-
</sect1>
</chapter>
@@ -1213,3 +1254,4 @@
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
+