cvs: phpdoc-ca /install ini.xml

http://cvs.php.net/co.php/phpdoc-ca/install/ini.xml?r=1.1&p=1
Index: phpdoc-ca/install/ini.xml
+++ phpdoc-ca/install/ini.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
 <chapter id="configuration">
  <title>Configuració d'execució</title>

  <sect1 id="configuration.file">
   <title>El fitxer de configuració</title>

   <simpara>
    El fitxer de configruació (anomenat <filename>php3.ini</filename> en
    PHP 3, i senzillament &php.ini; des de PHP 4)
    es llegeix quan PHP arrenca. En les versions del mòdul de servidor, 
    això passa només un cop, quan el servidor web arrenca. Per les versions 
    <acronym>CGI</acronym> i <acronym>CLI</acronym>, això passa 
    en cada invocació.
   </simpara>
   <para>
    &php.ini; es cerca en les següents ubicacions (en ordre):
    <itemizedlist>
     <listitem>
      <para>
       Ubicació específica dels mòduls SAPI (directiva <literal>PHPIniDir</literal> 
       en Apache 2, opció de línia de comanda <literal>-c</literal> en CGI i CLI,
       paràmetre <literal>php_ini</literal> en NSAPI,
       variable d'entorn <literal>PHP_INI_PATH</literal> en THTTPD)
      </para>
     </listitem>
     <listitem>
      <para>
       <literal>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath</literal>
       (ubicació del Registre de Windows)
      </para>
     </listitem>
     <listitem>
      <para>
       La variable d'entorn <varname>PHPRC</varname>
      </para>
     </listitem>
     <listitem>
      <para>
       Directory actiu (per CLI)
      </para>
     </listitem>
     <listitem>
      <para>
       El directori del servidor web (pels mòduls SAPI), o el directori de PHP
       (l'un o l'altre, en Windows)
      </para>
     </listitem>
     <listitem>
      <para>
       El directori de Windows (<filename class="directory">C:\windows</filename>
       or <filename class="directory">C:\winnt</filename>) (per Windows), or
       el valor de l'opció de compilació <literal>--with-config-file-path</literal>
      </para>
     </listitem>
    </itemizedlist> 
   </para>
   <para>
    Si el fitxer <filename>php-SAPI.ini</filename> existeix (SAPI indica el mode utilitzat, 
    de manera que el fitxer és, per exemple, <filename>php-cli.ini</filename> o bé 
    <filename>php-apache.ini</filename>), s'utilitzarà aquest enlloc de &php.ini;.
    El nom SAPI es pot determinar amb la funció <function>php_sapi_name</function>.
   </para>
   <note>
    <para>
     El servidor web canvia al directori arrel en el moment de l'arrencanda, 
     la qual cosa provoca que PHP intenti llegir &php.ini; del directori arrel.
    </para>
   </note>
   <para>
    Les directives del fitxer &php.ini; gestionades per extensions estan documentades en les pàgines respectives 
    de les pròpies extensions. La <link linkend="ini">llista de 
    directives incloses</link> està disponible a l'apèndix. Probablement, però, no totes 
    les directives estan documentades en el manual. Per una llista completa de directives 
    disponibles en la vostra versió de PHP, llegiu el prou ben comentat 
    fitxer &php.ini;. Alternativament, també podeu trobar útil 
    <ulink url="&url.php.cvs.phpini;">la darrera versió de &php.ini;</ulink> disponible als repositoris 
    CVS.
   </para>
   <para>
    <example>
     <title>Exemple de &php.ini;</title>
     <programlisting role="ini">
<![CDATA[
; qualsevol text en una línia després d'un punt i coma (;) és ignorada
[php] ; els marcadors de secció (text entre claudàtors) també són ignorats
; Els valors Booleans es poden establir a qualsevol del següents:
;    true, on, yes
; o bé false, off, no, none
register_globals = off
track_errors = yes

; podeu posar les cadenes de text entre cometes dobles
include_path = ".:/usr/local/lib/php"

; les barres invertides es tracten igual que qualsevol altre caràcter
include_path = ".;c:\php\lib"
]]>
</programlisting>
<!-- TODO: add more details about values and expressions -->
    </example>
   </para>
   <para>
    Des de PHP 5.1.0, és possible de referir-se a les variables .ini des de
    dins dels fitxers .ini. Per exemple: <literal>open_basedir = ${open_basedir}
    ":/new/dir"</literal>.
   </para>
  </sect1>

  <sect1 id="configuration.changes">
   <title>Com canviar els paràmetres de la configuració</title>

   <sect2 id="configuration.changes.apache">
    <title>Execució de PHP com un mòdul d'Apache</title>
    <simpara>
     Quan utilitzeu PHP com un mòdul d'Apache, també podeu canviar els
     paràmetres de la configuració utilitzant directives en els fitxers de configuració de
     l'Apache (per exemple, &httpd.conf;) i els fitxers &htaccess;. Necessitareu 
     privilegis de tipus "AllowOverride Options" o bé "AllowOverride All" per a poder-ho fer.
    </simpara>

    <para>
     Amb PHP 4 i PHP 5, hi ha algunes directives d'Apache que us permetran 
     de canviar la configuració de PHP des de dins dels fitxers de configuració de 
     l'Apache. Per obtenir un llistat de quines directives són 
     <constant>PHP_INI_ALL</constant>, <constant>PHP_INI_PERDIR</constant>, 
     o bé <constant>PHP_INI_SYSTEM</constant>, doneu una ullada a l'apèndix 
     <link linkend="ini.list">LLista de directives de php.ini</link>.
    </para>
    
    <note>
     <simpara>
      Amb PHP 3, hi ha directives Apache que corresponen a cada
      paràmetre de la configuració de <filename>php3.ini</filename>, 
      excepte pel nom, que està prefixat ab "php3_".
     </simpara>     
    </note>

    <para>
     <variablelist>
      <varlistentry>
       <term>
        <systemitem role="directive">php_value</systemitem>
        <parameter>name</parameter>
        <parameter>value</parameter>
       </term>
       <listitem>
        <para>
         Estableix el valor de la directiva especificada.
         Només es pot utilitzar amb directives de tipus <constant>PHP_INI_ALL</constant> i 
         <constant>PHP_INI_PERDIR</constant>
         Per a esborrar un valor prèviament establert, utilitzeu el valor <literal>none</literal>.
        </para>
        <note>
         <simpara>
          No utilitzeu <systemitem role="directive">php_value</systemitem> per a establir valors booleans.
          <systemitem role="directive">php_flag</systemitem> (veure més avall) és l'alternativa correcta.
         </simpara>
        </note>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
        <systemitem role="directive">php_flag</systemitem>
        <parameter>nom</parameter>
        <parameter>on|off</parameter>
       </term>
       <listitem>
        <para>
         S'utilitza per a establir una directiva booleana de configuració.
         Només es pot utilitzar amb directives de tipus <constant>PHP_INI_ALL</constant> i 
         <constant>PHP_INI_PERDIR</constant>
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
        <systemitem role="directive">php_admin_value</systemitem>
        <parameter>nom</parameter>
        <parameter>valor</parameter>
       </term>
       <listitem>
        <para>
         Estableix el valor de la directiva especificada.
         Això <emphasis>no pot ser utilitzat</emphasis> en fitxers &htaccess;.
         Qualsevol tipus de directiva establerta amb <systemitem role="directive">php_admin_value</systemitem>
         no pot ser substituïda per les directives &htaccess; o directives virtualhost.
         Per a esborrar un valor prèviament introduït, utilitzeu el valor <literal>none</literal>.
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>
        <systemitem role="directive">php_admin_flag</systemitem>
        <parameter>nom</parameter>
        <parameter>on|off</parameter>
       </term>
       <listitem>
        <para>
         Utilitzada per a establir una directiva booleana de configuració.
         Això <emphasis>no es pot utilitzar </emphasis> en fitxers &htaccess;.
         Qualsevol tipus de directiva establerta amb <systemitem role="directive">php_admin_flag</systemitem>
         no pot ser substituïda per directives &htaccess; o virtualhost.
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     <example>
      <title>Exemple de configuració d'Apache</title>
      <programlisting role="ini">
<![CDATA[
<IfModule mod_php5.c>
  php_value include_path ".:/usr/local/lib/php"
  php_admin_flag safe_mode on
</IfModule>
<IfModule mod_php4.c>
  php_value include_path ".:/usr/local/lib/php"
  php_admin_flag safe_mode on
</IfModule>
<IfModule mod_php3.c>
  php3_include_path ".:/usr/local/lib/php"
  php3_safe_mode on
</IfModule>
]]>
      </programlisting>
     </example>
    </para>
    <caution>
     <para>
      Les constants PHP no esisteixen fora de PHP. Per exemple, en 
      el fitxer &httpd.conf; no podeu utilitzar constants
      com ara <constant>E_ALL</constant> or <constant>E_NOTICE</constant>
      per a establir la directiva <link linkend="ini.error-reporting">error_reporting</link>, 
      ja que no tindran cap significat i s'avaluaran a
      <emphasis>0</emphasis>. Utilitzeu en el seu lloc els valors bitmask associats.
      Aquestes constants poden ser utilitzades en &php.ini;
     </para>
    </caution>
   </sect2>

   <sect2 id="configuration.changes.windows">
    <title>Canvi de la configuració de PHP via registre de Window</title>
     <simpara>
      Quan s'executa PHP en Windows, els valors de configuració poden 
      ser modificats en el registre de Windows, basat en una estructura de directoris. Els 
      valors de configuració estan emmagatzemats en la clau de registre 
      <literal>HKLM\SOFTWARE\PHP\Valors Per Directoris</literal>, 
      en les sub-claus que corresponen als noms de les rutes. Per exemple, els valors
      de configuració pel directori <literal>c:\inetpub\wwwroot</literal> estarien
      emmagatzemats en el directori <literal>HKLM\SOFTWARE\PHP\Valors Per
      Directoris\c\inetpub\wwwroot</literal>. La configuració pel directori
      seria vàlida per qualsevol script executant-se des d'aquest directori o 
      de qualsevol subdirectori d'aquest. Els valors de la clau han de 
      tenir el nom de la directiva de configuració de PHP i el valor literal associat.
      Les constants PHP en els valors no seran tractades. No obstant això, 
      només els valors modificables en PHP_INI_USER poden establir-se d'aquesta 
      manera, els valors PHP_INI_PERDIR no poden ser modificats així.
     </simpara>
   </sect2>
   
   <sect2 id="configuration.changes.other">
    <title>Altres interfícies de PHP</title>
    <para>
     Independentment de com executeu PHP, podeu modificar certs valors en temps 
     d'execució dels vostres scripts a través de <function>ini_set</function>. Vegeu 
     la documentació de la pàgina de la funció <function>ini_set</function> per més informació.    </para>
    <para>
     Si esteu interessats en una llista completa de paràmetres de configuració
     en el vostre sistema amb els valors actuals,  podeu executar la 
     funció <function>phpinfo</function>, i comprovar-ne la pàgina resultant.
     També podeu accedir als valors de directives de configuració individuals en temps 
     d'execució, utilitzant <function>ini_get</function> o bé <function>get_cfg_var</function>.
    </para>
   </sect2>
  </sect1>

 </chapter>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->