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:gui@php.net">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 -->