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

eduardcapell		Thu Aug  4 06:08:58 2005 EDT

  Added files:                 
    /phpdoc-ca/install/unix	gentoo.xml 
  Log:
  
  

http://cvs.php.net/co.php/phpdoc-ca/install/unix/gentoo.xml?r=1.1&p=1
Index: phpdoc-ca/install/unix/gentoo.xml
+++ phpdoc-ca/install/unix/gentoo.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.1 Maintainer: eduardcapell Status: ready -->
<sect1 id="install.unix.gentoo">
 <title>Notes d'instal·lació en Gentoo</title>
 <para>
  Aquesta secció contè notes i consells específics per la instal·lació de 
  PHP en <ulink url="&url.gentoo;">Gentoo Linux</ulink>.
 </para>
 <sect2 id="install.unix.gentoo.portage">
  <title>Utilització de Portage (emerge)</title>
   <simpara>
    Tot i que podeu descarregar el codi font de PHP i compilar-lo pel 
    vostre compte, l'ús del sistema de paquets de Gentoo és el mètode 
    més simple i net per a instal·lar el PHP. Si no esteu familiaritzats amb 
    el muntatge de programari en Linux, aquesta és l'opció més adequada.
   </simpara>
   <simpara>
    Si heu muntat el sistema Gentoo, probablement ja esteu familiaritzats amb 
    Portage. La instal·lació d'Apache i PHP no és diferent de la instal·lació de la
    resta d'eines de sistema.
   </simpara>
   <simpara>
    La primera decisió que heu de prendre és si voleu instal·lar 
    Apache 1.3.x o bé Apache 2.x. Tot i que tots dos es poden fer servir amb PHP, els 
    passos que es donen a continuació utilitzaran Apache 1.3.x. Una altra consideració 
    que heu de tenir en compte és si l'arbre Portage el teniu al dia. Si no l'heu 
    actualitzat recentment, cal que executeu <command>emerge sync</command>
    abans de començar. D'aquesta manera, utilitzareu la versió estable més 
    recent d'Apache i PHP.
   </simpara>
   <simpara>
    Ara que tot és al seu lloc, podeu utilitzar el següent exemple 
    per a instal·lar Apache i PHP:
   </simpara>
   <example id="install.unix.gentoo.portage.example">
    <title>Exemple d'Instal·lació en Gentoo amb Apache 1.3</title>
    <programlisting role="shell">
<![CDATA[
# emerge \<apache-2
# USE="-*" emerge php mod_php
# ebuild /var/db/pkg/dev-php/mod_php-<la_vostra_versió_PHP>/mod_php-<la_vostra_versió_PHP>.ebuild config
# nano /etc/conf.d/apache
  Add "-D PHP4" to APACHE_OPTS
  
# rc-update add apache default
# /etc/init.d/apache start
]]>
    </programlisting>
   </example>
   <simpara>
    Podeu llegir més sobre emerge en l'excel·lent 
    <ulink url="&url.gentoo.portage;">Portage Manual</ulink> disponible al 
    lloc de Gentoo.
   </simpara>
   <simpara>
    Si heu d'utilitzar Apache 2, podeu utilitzar <command>emerge apache</command>
    en el darrer exemple.
   </simpara>
 </sect2>
 <sect2 id="install.unix.gentoo.config">
  <title>Millor control de la configuració</title>
   <simpara>
    En la darrera secció, vam fer l'emerge del PHP sense cap mòdul 
    activat. En el moment de la redacció d'aquest document, l'únic 
    mòdul activat per defecte amb Portage és XML, que fa falta per 
    <ulink url="&url.php.pear;">PEAR</ulink>.
    Això potser no és el que voleu, i aviat us adonareu que 
    necessiteu activar més mòduls, com MySQL, gettext, GD, etc.
   </simpara>
   <simpara>
    Quan compileu el PHP pel vostre compte des de codi font, cal que activeu 
    els mòduls per mitjà de la comanda <command>configure</command>. A Gentoo, 
    podeu passar els senyaladors USE que configuraran la seqüència de forma 
    automàtica. Per veure quins senyaladors USE podeu utilitzar amb 
    emerge, proveu amb:
   </simpara>
   <example id="install.unix.gentoo.config.example">
    <title>Llista de senyaladors USE vàlids</title>
    <programlisting role="shell">
<![CDATA[
# USE="-*" emerge -pv php

[ebuild  N    ] dev-php/php-4.3.6-r1  -X -berkdb -crypt -curl -debug -doc 
-fdftk -firebird -flash -freetds -gd -gd-external -gdbm -gmp -hardenedphp 
-imap -informix -ipv6 -java -jpeg -kerberos -ldap -mcal -memlimit -mssql 
-mysql -ncurses -nls -oci8 -odbc -pam -pdflib -png -postgres -qt -readline 
-snmp -spell -ssl -tiff -truetype -xml2 -yaz  3,876 kB
]]>
    </programlisting>
   </example>
   <simpara>
    Com podeu veure, PHP considera molts senyaladors USE. Fixeu-vos-hi bé, i 
    trieu els que necessiteu. Si trieu un senyalador pel qual no teniu les 
    biblioteques apropiades, Portage les compilarà automàticament. 
    Sempre és una bona idea d'utilitzar <command>emerge -pv</command> una altra 
    vegada per veure allò que Portage compilarà, i comparar-ho amb els 
    senyaladors USE que heu triat. Com a exemple, si no teniu X instal·lat i 
    trieu d'incloure X en els senyaladors USE, Portage compilarà X abans 
    del PHP, la qual cosa pot trigar un parell d'hores.
   </simpara>
   <simpara>
    Si trieu de compilar PHP amb suport MySQL, cURL and GD, la comanda
    serà més o menys com la següent:
   </simpara>  
   <example id="install.unix.gentoo.config.example2">
    <title>Instal·lació de PHP amb senyaladors USE</title>
    <programlisting role="shell">
<![CDATA[
# USE="-* curl mysql gd" emerge php mod_php
]]>
    </programlisting>
   </example>
   <simpara>
    Com en el darrer exemple, no us oblideu de fer emerge php i mod_php.
    php és el responsable de la versió de PHP en línia de comanda, i mod_php 
    ho és de la versió en mòdul Apache.
   </simpara>
 </sect2>
 <sect2 id="install.unix.gentoo.faq">
  <title>Problemes Freqüents</title>
  <itemizedlist>
   <listitem>
    <simpara>
     Si veieu el codi font de PHP enlloc del resultat que la seqüència 
     hauria de generar, probablament us heu oblidat d'editar el fitxer 
     <filename>/etc/conf.d/apache</filename>.
     Apache s'ha d'iniciar amb el senyalador -D PHP4. Per veure si el 
     senyalador és present, hauríeu de veure'l utilitzant 
     <command>ps ax | grep apache</command> mentre l'Apache s'està executant.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Degut a problemes d'assignació, podríeu acabar tenint més d'una versió 
     de PHP instal·lada al sistema. Si és el cas, hauríeu de fer unmerge de les 
     versions antigues de forma manual, utilitzant 
     <command>emerge unmerge mod_php-&lt;versio antiga&gt;</command>.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Si no podeu fer emerge PHP degut al Java, intenteu de posar <command>-*</command>
     abans dels senyaladors USE en els exemples anteriors.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Si teniu problemes configurant l'Apache i el PHP, sempre podeu buscar 
     els <ulink url="&url.gentoo.forums;">Fòrums de Gentoo</ulink>.
     Mireu de cercar amb les paraules clau "Apache PHP".
    </simpara>
   </listitem>
  </itemizedlist>
 </sect2>
</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
-->