cvs: phpdoc-ca /install/unix apache1.xml

http://cvs.php.net/co.php/phpdoc-ca/install/unix/apache1.xml?r=1.1&p=1
Index: phpdoc-ca/install/unix/apache1.xml
+++ phpdoc-ca/install/unix/apache1.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.3 Maintainer: eduardcapell Status: ready -->
   <sect1 id="install.unix.apache">
    <title>Apache 1.3.x en sistemes Unix</title>
    <para>
     Aquesta secció contè notes i consells específics per instal·lacions 
     de PHP sobre Apache en plataformes Unix. També tenim <link
     linkend="install.unix.apache2">instruccions i notes per Apache 2
     en una pàgina diferent</link>.
    </para>   
    <para>
     En el llistat següent, a la línia 10, podeu triar els arguments que podeu 
     passar a la comanda <command>configure</command> en la <link
     linkend="configure">llista d'opcions bàsiques de configuració</link> i
     també els podeu triar en la llista d'opcions específiques de cada 
     extensió, descrites als seus llocs corresponents del manual. Els números
     de versió s'han omès, per assegurar-nos que les instruccions no són incorrectes. 
     Caldrà que substituïu 'xxx' pels valors correctes dels vostres fitxers.
    </para>

    <example id="install.unix.apache.example">
     <title>
      Instruccions d'Instal·lació (Versió del Mòdul Compartit d'Apache) per PHP
     </title>
     <screen>
<![CDATA[
1.  gunzip apache_xxx.tar.gz
2.  tar -xvf apache_xxx.tar
3.  gunzip php-xxx.tar.gz
4.  tar -xvf php-xxx.tar
5.  cd apache_xxx
6.  ./configure --prefix=/www --enable-module=so
7.  make
8.  make install
9.  cd ../php-xxx

10. Ara, configureu el vostre PHP. Aquí és on personalitzeu el vostre PHP
    amb diverses opcions, com ara quines extensions s'habilitaran. Executeu 
    ./configure --help per veure una llista d'opcions disponibles. En el nostre exemple
    farem una configuració simple amb Apache 1 i suport per MySQL.  Les 
    rutes a les vostres apxs poden ser diferents de les de l'exemple.

      ./configure --with-mysql --with-apxs=/www/bin/apxs

11. make
12. make install

    Si decidiu de canviar les opcions de configuració després de la instal·lació, 
    només cal que repetiu els darrers tres passos. Llavors caldrà que 
    reiniceu apache per tal que el nou mòdul tingui efecte. No cal que 
    recompileu Apache
    
    Observeu que, si no es diu el contrari, 'make install' també instal·larà PEAR, 
    diverses eines PHP com ara phpize, la línia de comanda PHP (PHP CLI), i d'altres eines.

13. Configureu el vostre fitxer php.ini:

      cp php.ini-dist /usr/local/lib/php.ini


    Aquí podeu editar el vostre fitxer .ini per tal d'establir les opcions de 
    PHP. Si preferiu que el fitxer php.ini estigui en una altra ubicació, utilitzeu 
    --with-config-file-path=/la/ruta/alternativa en el pas número 10.
    
    Si, per contra, trieu el fitxer php.ini-recommended, assegureu-vos de llegir-ne la 
    llista de canvis, ja que afectaran la manera com es comportarà PHP.
    
14. Editeu el fitxer httpd.conf per a carregar el mòdul PHP. La ruta a la banda dreta 
    de la sentència LoadModule ha d'apuntar a la ruta del mòdul PHP en el vostre sistema. El 
    make install fet anteriorment pot haver afegir això, però assegureu-vos que ho 
    comproveu.
        
    Per PHP 4:
            
      LoadModule php4_module libexec/libphp4.so

    Per PHP 5:
                      
      LoadModule php5_module libexec/libphp5.so
      
15. I en la secció AddModule de httpd.conf, en algun lloc dins de 
    ClearModuleList, afegiu el següent:
    
    Per PHP 4:
    
      AddModule mod_php4.c
      
    Per PHP 5:
    
      AddModule mod_php5.c

16. Ara li diem a l'Apache que tracti certes extensions de fitxers com a PHP. Per exemple, 
    li direm que tracti l'extensió .php com a PHP. Podem fer que tracti tantes extensions 
    com vulguem, només cal que les separem per un espai. Afegirem també l'extensió .phtml 
    com a demostració.

      AddType application/x-httpd-php .php .phtml

    També és habitual d'establir l'extensió .phps per a mostrar codi font PHP ressaltat, 
    de la manera següent:
    
      AddType application/x-httpd-php-source .phps

17. Utilitzeu el procediment habitual per tal d'iniciar el servidor Apache. (Heu d'aturar i 
    iniciar el servidor, no només reiniciar-lo amb senyals HUP o USR1).
]]>
     </screen>
    </example>

    <para>
     Alternativament, per a instal·lar PHP com un objecte estàtic:
    </para>

    <example id="install.unix.apache.example-static">
     <title>
      Instruccions d'Instal·lació (Instal·lació del Mòdul Estàtic per Apache) per PHP
     </title>
     <screen>
<![CDATA[
1.  gunzip -c apache_1.3.x.tar.gz | tar xf -
2.  cd apache_1.3.x
3.  ./configure
4.  cd ..

5.  gunzip -c php-4.x.y.tar.gz | tar xf -
6.  cd php-4.x.y
7.  ./configure --with-mysql --with-apache=../apache_1.3.x
8.  make
9.  make install

10. cd ../apache_1.3.x

11. ./configure --prefix=/www --activate-module=src/modules/php4/libphp4.a
    (La línia 11 és correcta! Sí, ja sabem que libphp4.a no existeix en aquest 
    moment. De fet, se suposa que no existeix, i serà creada pel procés.)

12. make
    (ara hauríeu de tenir un fitxer binari httpd, que podeu copiar al directori bin d'Apache. 
    Si és la primera instal·lació, caldrà que feu un "make install" també)

13. cd ../php-4.x.y
14. cp php.ini-dist /usr/local/lib/php.ini

15. Podeu editar el fitxer /usr/local/lib/php.ini per tal d'establir les opcions PHP.
    Editeu el fitxer httpd.conf o bé el fitxer srm.conf i afegiu-hi:
    AddType application/x-httpd-php .php
]]>
      </screen>
     </example>

     <para>
      Segons la vostra instal·lació d'Apache, i la vostra variant de Unix, hi ha moltes 
      maneres d'aturar i reiniciar el servidor. A continuació 
      
      A continuació veureu una llista de diferents maneres de reiniciar el servidor, 
      per diferents instal·lacions d'apache/unix. Substituïu el literal 
      <literal>/ruta/a/</literal> amb la ruta a les aplicacions corresponents 
      en el vostre sistema.
     </para>
     <para>
      <example>
       <title>Exemples de comandes per reiniciar l'Apache</title>
       <programlisting role="shell">
<![CDATA[
1. Algunes variants de Linux i SysV:
/etc/rc.d/init.d/httpd restart

2. Utilització dels scripts apachectl:
/ruta/a/apachectl stop
/ruta/a/apachectl start

3. httpdctl i httpsdctl (Utilitzant OpenSSL), semblant a apachectl:
/ruta/a/httpsdctl stop
/ruta/a/httpsdctl start

4. Utilitzant mod_ssl, o algun altre servidor SSL, potser haureu d'editar stop i start
/ruta/a/apachectl stop
/ruta/a/apachectl startssl
]]>
       </programlisting>
      </example>
     </para>
     <para>
      Les ubicacions dels binaris apachetl i http(s)dctl varien sovint. 
      Si el vostre sistema té les comandes <literal>locate</literal> 
      o bé <literal>whereis</literal> o bé <literal>which</literal>,
      us poden ser d'utilitat per a trobar els programes de control del servidor.
     </para>

     <para>
      Exemples de compilació de PHP per apache:
      <informalexample>
       <programlisting role="shell">
<![CDATA[../configure --with-apxs --with-pgsql
]]>
       </programlisting>
      </informalexample>
     </para>
     <para>
      Això crearà una biblioteca compartida, <filename>libphp4.so</filename>,
      que es carregarà en l'Apache utilitzant una línia LoadModule el fitxer
      &httpd.conf;. El suport per PostgreSQL està inclòs en aquesta 
      biblioteca, <filename>libphp4.so</filename>.
     </para>
     <para>
      <informalexample>
       <programlisting role="shell">
<![CDATA[../configure --with-apxs --with-pgsql=shared
]]>
       </programlisting>
      </informalexample>
     </para>
     <para>
      Això crearà una biblioteca compartida <filename>libphp4.so</filename> 
      per Apache, però també crearà una biblioteca compartida 
      <filename>pgsql.so</filename> que es carregarà en el PHP, sigui 
      a través de la directiva extension en el fitxer &php.ini; o sigui 
      carregant-la explícitament en un script, utilitzant la 
      funció <function>dl</function>.
     </para>
     <para>
      <informalexample>
       <programlisting role="shell">
<![CDATA[../configure --with-apache=/ruta/a/apache_source --with-pgsql
]]>
       </programlisting>
      </informalexample>
     </para>
     <para>
      Això crearà una biblioteca compartida <filename>libmodphp4.a</filename>, un 
      fitxer <filename>mod_php4.c</filename> i alguns altres fitxers més 
      d'acompanyament, i els copiarà en el directori <literal>src/modules/php4</literal> 
      dins de la ruta del codi font de l'Apache. Després s'ha de compilar l'Apache, 
      utilitzant <literal>--activate-module=src/modules/php4/libphp4.a</literal>
      i el sistema de muntatge d'Apache crearà el fitxer <filename>libphp4.a</filename> 
      i l'enllaçarà estàticament en el binari <filename>httpd</filename> binary. 
      El suport per PostgreSQL estarà inclòs directament en aquest 
      fitxer binari <filename>httpd</filename>, de manera que el resultat final és 
      un únic fitxer binari <filename>httpd</filename> que inclou tot 
      l'Apache i tot el PHP.
     </para>
     <para>
      <informalexample>
       <programlisting role="shell">
<![CDATA[../configure --with-apache=/ruta/a/apache_source --with-pgsql=shared
]]>
       </programlisting>
      </informalexample>
     </para>
     <para>
      Igual que abans, excepte que, enlloc d'incloure el suport per PostgreSQL
      directament en el fitxer final <filename>httpd</filename>, obtindreu una biblioteca
      compartida <filename>pgsql.so</filename> que podeu carregar a PHP, ja sigui des del 
      fitxer &php.ini;, ja sigui de manera directa, utilitzant la funció <function>dl</function>.
     </para>
     <para>
      Quan s'ha d'escollir entre diferents maneres d'instal·lar PHP, s'han de considerar
      els avantatges i desavantatges de cada mètode. El muntatge com a objecte
      compartit significa que es pot compilar l'apache separadament, i no s'ha de 
      recompilar tot cada cop que s'afegeix o es modifica el PHP.
      El muntatge de PHP dins de l'apache (mètode estàtic) implica que el PHP 
      es carregarà i s'executarà més ràpidament. Per més informació, vegeu la 
      <ulink url="&url.apachedso;">pàgina web de suport DSO (Objectes Dinàmics Compartits)</ulink> 
      d'Apache.
     </para>
    <note>
     <para>
      El fitxer &httpd.conf; que ve per defecte amb l'Apache, té una secció com aquesta:
      <informalexample>
       <programlisting role="apache-conf">
<![CDATA[
User nobody
Group "#-1"
]]>
       </programlisting>
      </informalexample>
      Mentre no ho substituïu per "Group nogroup" o per alguna cosa similar ("Group daemon" també 
      és força freqüent) PHP no podrà obrir els fitxers.
     </para>
    </note>  
    <note>
     <para>
      Assegureu-vos que especifiqueu la versió instal·lada de les aplicacions quan 
      feu servir l'opció <option role="configure">--with-apxs=/ruta/a/apxs</option>.
      NO heu d'utilitzar la versió de l'aplicació que apareix en els codis fonts 
      de l'Apache, sinó la que està realment instal·lada en el vostre sistema.
     </para>
    </note>   
   </sect1>

<!-- 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
-->