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

eduardcapell Wed Aug 3 09:38:07 2005 EDT Added files: /phpdoc-ca/install/unix apache1.xml Log:

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