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

eduardcapell		Thu Aug  4 05:13:34 2005 EDT

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

http://cvs.php.net/co.php/phpdoc-ca/install/unix/debian.xml?r=1.1&p=1
Index: phpdoc-ca/install/unix/debian.xml
+++ phpdoc-ca/install/unix/debian.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.2 Maintainer: eduardcapell Status: ready -->
<sect1 id="install.unix.debian">
 <title>Notes de la instal·lació en Debian GNU/Linux</title>
 <para>
  Aquesta secció contè notes i consells especifícs per la 
  instal·lació de PHP en <ulink url="&url.debian;">Debian GNU/Linux</ulink>.
 </para>
 <sect2 id="install.unix.debian.apt">
  <title>Utilització d'APT</title>
   <simpara>
    Tot i que podeu descarregar el codi font PHP i compilar-lo per vosaltres 
    mateixos, l'ús del sistema de paquets Debian és el mètode més simple i més net
    d'instal·lar PHP. Si no esteu familiaritzats amb el muntatge de 
    programari en Linux, aquesta és la manera més adequada.
   </simpara>
   <simpara>
    La primera decisió que heu de prendre és sobre si instal·lareu 
    Apache 1.3.x o bé Apache 2.x. Els paquets PHP s'anomenen respectivament 
    libapache-mod-php* i libapache2-mod-php*. Els passos que s'indiquen a 
    continuació utilitzaran Apache 1.3.x.
    Observeu que, en el moment de la redacció d'aquest document, no 
    hi ha paquets oficials Debian de PHP 5. Per tant, els passos que 
    s'indiquen són per a instal·lar PHP 4.
   </simpara>
   <simpara>
    El PHP també està disponible en Debian com a CGI o CLI, anomenats 
    respectivament php4-cgi i php4-cli. Si els necessiteu, només caldrà que 
    reproduïu els següents passos amb els noms correctes dels paquets.
    Un altre paquet especial que potser us interessarà d'instal·lar és php4-pear. Contè 
    una instal·lació mínima de PEAR i la utilitat de línia de comanda 
    <command>pear</command>.
   </simpara>
   <simpara>
    Si necessiteu paquets de PHP més recents que els estables de Debian, o bé si 
    alguns mòduls no són al repositori oficial de Debian, potser hauríeu de fer 
    una ullada a <ulink url="&url.apt-get;">http://www.apt-get.org/</ulink>. 
    Un dels resultats trobats hauria de ser 
    <ulink url="http://www.dotdeb.org/">Dotdeb</ulink>. Aquest repositori 
    no oficial el mantè <ulink url="mailto:[email protected]">en Guillaume Plessis</ulink> i 
    contè paquets Debian de les versions més recents de PHP 4 i PHP 5.
    Per a utilitzar-lo, senzillament afegiu les següents dues línies al 
    vostre fitxer <filename>/etc/apt/sources.lists</filename> i executeu 
    <command>apt-get update</command> :
   </simpara>
   <example>
    <title>Les dues línies de Dotdeb</title>
    <programlisting role="shell">
<![CDATA[
deb http://packages.dotdeb.org stable all
deb-src http://packages.dotdeb.org stable all
]]>
    </programlisting>
   </example>
   <simpara>
    La darrera cosa a tenir en compte és l'actualització de la llista de 
    paquets. Si no la teniu al dia, heu d'executar <command>apt-get update</command>
    abans de fer qualsevol altra cosa. D'aquesta manera, fareu servir la 
    versió estable més recent dels paquets 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.debian.apt.example">
    <title>Exemple d'Instal·lació de Debian amb Apache 1.3</title>
    <programlisting role="shell">
<![CDATA[
# apt-get install libapache-mod-php4
]]>
    </programlisting>
   </example>
   <simpara>
    APT instal·larà i activarà automàticament el mòdul de PHP 4 per Apache 1.3, i 
    totes les seves dependències. Si el procés no us demana de reiniciar l'Apache 
    durant la instal·lació, ho haureu de fer manualment:
   </simpara>
   <example id="install.unix.debian.apt.example2">
    <title>Aturar i iniciar l'Apache un cop s'ha instal·lat el PHP 4</title>
    <programlisting role="shell">
<![CDATA[
# /etc/init.d/apache stop
# /etc/init.d/apache start
]]>
    </programlisting>
   </example>
 </sect2>
 <sect2 id="install.unix.debian.config">
  <title>Millor control de la configuració</title>
   <simpara>
    A la darrera secció, el PHP s'ha instal·lat només amb els mòduls bàsics. 
    Això potser no és el que voleu, i aviat us adonareu que necessiteu activar 
    més mòduls, com ara MySQL, cURL, GD, etc.
   </simpara>
   <simpara>
    Quan compileu PHP pel vostre compte des del codi font, cal que activeu els 
    mòduls amb la comanda <command>configure</command>. Amb APT, només cal que 
    instal·leu els paquets addicionals. Tots s'anomenen 'php4-*' (o 'php5-*' si 
    heu instal·lat PHP 5 d'un repositori no oficial).
   </simpara>
   <example id="install.unix.debian.config.example">
    <title>Obtenir la llista de paquets addicionals de PHP</title>
    <programlisting role="shell">
<![CDATA[
# dpkg -l 'php4-*'
]]>
    </programlisting>
   </example>
   <simpara>
    Com podreu veure en la sortida de la darrera comanda, hi ha molts mòduls que 
    podeu instal·lar (excepte els paquets especials php4-cgi, php4-cli o php4-pear).
    Llegiu la llista atentament, i escolliu el que necessiteu. Si trieu un mòdul i 
    no teniu les biblioteques apropiades, APT instal·larà automàticament totes les 
    dependències.
   </simpara>
   <simpara>
    Si trieu d'instal·lar el suport MySQL, cURL i GD al PHP, la comanda serà 
    semblant a:
   </simpara>  
   <example id="install.unix.debian.config.example2">
    <title>Instal·lació de PHP amb MySQL, cURL and GD</title>
    <programlisting role="shell">
<![CDATA[
# apt-get install php4-mysql php4-curl php4-gd
]]>
    </programlisting>
   </example>
   <simpara>
    APT afegirà de forma automàtica les línies necessàries als 
    diferents &php.ini; (<filename>/etc/php4/apache/php.ini</filename>,
    <filename>/etc/php4/cgi/php.ini</filename>, etc).
   </simpara>
   <example id="install.unix.debian.config.example3">
    <title>Aquestes línies activen MySQL, cURL and GD en el PHP</title>
    <programlisting role="shell">
<![CDATA[
extension=mysql.so
extension=curl.so
extension=gd.so
]]>
    </programlisting>
   </example>
   <simpara>
    Només caldrà aturar/iniciar l'Apache com s'ha indicat prèviament per tal d'activar els mòduls.
   </simpara>
 </sect2>
 <sect2 id="install.unix.debian.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 produir, l'APT probablement no ha inclòs el fitxer 
     <filename>/etc/apache/conf.d/php4</filename> en la configuració de 
     l'Apache 1.3. Assegureu-vos que la línia següent és al fitxer 
     <filename>/etc/apache/httpd.conf</filename> file i tot seguit atureu/inicieu l'Apache:
    </simpara>
   <example id="install.unix.debian.faq.example">
    <title>Aquesta línia activa el PHP 4 en l'Apache</title>
    <programlisting role="shell">
<![CDATA[
# Include /etc/apache/conf.d/
]]>
    </programlisting>
   </example>
   </listitem>
   <listitem>
    <simpara>
     Si heu instal·lat un mòdul addicional i les seves funcions no estan 
     disponibles en les vostres seqüències, assegureu-vos que la línia apropiada 
     existeix al vostre fitxer &php.ini;, com s'ha indicat prèviament. 
     L'APT pot fallar durant la instal·lació del mòdul addicional, degut a 
     una configuració confosa del debconf.
    </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
-->