cvs: phpdoc-sv /chapters config.xml

jome Sun Jan 5 08:52:54 2003 EDT Modified files: /phpdoc-sv/chapters config.xml Log: sync with english

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>&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;</userinput>. Also if disabled, you must use the + long form of the PHP open tag (<userinput>&lt;?php ?&gt;</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>&lt;?=</userinput>, + which is identical to <userinput>&lt;? 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>"&amp;"</entry> + <entry>PHP_INI_ALL</entry> + </row> + <row> + <entry>arg_separator.input</entry> + <entry>"&amp;"</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), &quot; (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>&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;</userinput>. Also if disabled, you must use the - long form of the PHP open tag (<userinput>&lt;?php ?&gt;</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>&lt;?=</userinput>, - which is identical to <userinput>&lt;? 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 --> +