cvs: phpdoc-ca /install intro.xml pecl.xml

http://cvs.php.net/co.php/phpdoc-ca/install/intro.xml?r=1.1&p=1
Index: phpdoc-ca/install/intro.xml
+++ phpdoc-ca/install/intro.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.1 Maintainer: eduardcapell Status: ready -->
<!-- $Revision: 1.1 $ -->
  <chapter id="install.general">
   <title>Consideracions Generals d'Instal·lació</title>
   <para>
    Abans de començar la instal·lació, heu de saber per què voleu utilitzar PHP. Hi ha tres camps principals on podeu utilitzar PHP, tal com es descriu a la secció <link linkend="intro-whatcando">Què pot fer PHP?</link>:
    <itemizedlist>
     <listitem><simpara>Scripts en el servidor</simpara></listitem>
     <listitem><simpara>Scripts en línia de comanda</simpara></listitem>
     <listitem><simpara>Aplicacions gràfiques de client</simpara></listitem>
    </itemizedlist>
   </para>
   <para>
    Per la primera i més comú de les opcions, necessiteu tres coses:
    El propi PHP, un servidor web, i un navegador web. Probablement ja teniu un navegador web, i depenent del vostre sistema operatiu, potser també teniu un servidor web (p.e. Apache en Linux i MacOS X; IIS en Windows).
    O potser preferiu llogar un espai web en una empresa. D'aquesta manera, no caldrà que instal·leu res pel vostre compte, sinó que només haureu d'escriure els vostres scripts PHP, pujar-los cap al servidor que heu contractat, i veure els resultats en el vostre navegador. 
   </para>
   <para>
    Si configureu el servidor i el PHP pel vostre compte, teniu dues opcions pel mètode de connexió entre PHP i el servidor. Per molts servidors PHP té un mòdul directe (també anomenat SAPI). Entre aquests servidors hi trobem Apache, Microsoft Internet Information Server, Netscape i iPlanet. Molts d'altres servidors tenen suport ISAPI, el modul directe de Microsoft (OmniHTTPd, per exemple). Si PHP no té suport de mòduls directes pel vostre servidor web, sempre podeu utilitzar-lo com a processador CGI o bé FastCGI. Això vol dir que configurareu el vostre servidor per a utilitzar l'executable CGI de PHP per a processar totes les peticions de fitxers PHP.
   </para>
   <para>
    Si també esteu interessats a utilitzar PHP per a scripts en línia de comanda (per exemple, scripts que autogeneren imatges per a ser utilitzades fora de línia, o processament de fitxers de text en base a paràmetres que els passeu), sempre caldrà que tingueu l'executable en línia de comanda. Per més informació, llegiu la secció sobre <link linkend="features.commandline">escriure aplicacions PHP en línia de comanda</link>. En aquest cas, no necessiteu ni el servidor, ni el navegador web.
   </para>
   <para>
    Amb PHP també podeu escriure aplicacions gràfiques d'escriptori, utilitzant l'extensió PHP-GTK. Aquesta és una aproximació completament diferent de la programació de pàgines web, ja que no es genera cap HTML, sinó que el que cal gestionar són finestres i objectes dins d'aquestes finestres. Per més informació sobre PHP-GTK, si us plau 
    <ulink url="&url.php.gtk;">visiteu el lloc web dedicat a aquesta extensió</ulink>. PHP-GTK no està inclòs en la distribució oficial PHP.
   </para>
   <para>
    D'ara endavant, aquesta secció tracta de la configuració de PHP en servidors web en Unix i Windows amb mòduls directes de servidors i executables CGI. També trobareu informació sobre l'executable de línia de comanda en les seccions següents.
   </para>
   <para>
    El codi font i els arxius binaris de PHP per Windows podeu trobar-los a 
    <ulink url="&url.php.downloads;">&url.php.downloads;</ulink>.
    Us reconamem quue utilitzeu una <ulink url="&url.mirrors;">rèplica</ulink> el més propera possible per a descarregar les distribucions.
   </para>
  </chapter>

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

http://cvs.php.net/co.php/phpdoc-ca/install/pecl.xml?r=1.1&p=1
Index: phpdoc-ca/install/pecl.xml
+++ phpdoc-ca/install/pecl.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- EN-Revision: 1.8 Maintainer: eduardcapell Status: ready -->

<chapter id="install.pecl">
 <title>Instal·lació d'extensions PECL</title>

 <sect1 id="install.pecl.intro">
  <title>Introducció a les Instal·lacions PECL</title>
  <simpara>
   Les extensions PHP poden ser instal·lades de diverses maneres. 
   <ulink url="&url.pecl;">PECL</ulink> és un repositori d'extensions PHP 
   hostatjat en l'estructura <ulink url="&url.php.pear;">PEAR</ulink>, i  
   a continuació us demostrem com s'instal·len aquestes extensions.
  </simpara>
  <simpara>
   Aquestes instruccions assumeixen que <literal>/your/phpsrcdir/</literal> és la ruta 
   del codi font PHP, i que <literal>extname</literal> és el nom de l'extensió
   PECL.  Feu els ajustos necessaris en funció de la vostra configuració.  Aquestes instruccions
   també assumeixen que esteu familiaritzats amb la <ulink url="&url.php.pear.cli;">comanda pear</ulink>.
  </simpara>
  <simpara>
   Es poden instal·lar extensions compartides incloent-les en &php.ini; utilitzant
   la directiva PHP <link linkend="ini.extension">extension</link>. Vegeu també les directives 
   <link linkend="ini.extension-dir">extensions_dir</link>, i 
   <function>dl</function>. Els mètodes d'instal·lació descrits més avall no configuren PHP 
   de manera automàtica per a incloure aquestes extensions, i això caldrà fer-ho manualment.
  </simpara>
  <simpara>
   En el procés de muntatge dels mòduls PHP, és important de tenir les versions apropiades
   de les eines requerides (autoconf, automake, libtool, etc.) Vegeu les  
   <ulink url="&url.php.anoncvs;">Instruccions per CVS Anònim</ulink> per més 
   detalls sobre les eines i versions requerides.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.downloads">
  <title>Descàrrega de les extensions PECL</title>
  <simpara>
   Hi ha diverses opcions per la descàrrega de les extensions PECL, com ara:
  </simpara>
  <itemizedlist>
   <listitem>
    <simpara>
     <ulink url="&url.pecl;">&url.pecl;</ulink>
    </simpara>
    <simpara>
     Hi podeu trobar la informació com el ChangeLog, informació de versió, 
     requeriments, revisions, etc. Tot i que no totes les extensions PECL tenen 
     una pàgina web, la majoria sí que en tenen.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <literal>extname de descàrrega de pear</literal>
    </simpara>
    <simpara>
     La <ulink url="&url.php.pear.cli;">comanda pear</ulink> també es pot utilitzar 
     per a descarregar fitxers font. També es poden especificar revisions específiques.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     <acronym>CVS</acronym>
    </simpara>
    <simpara>
     Tots els fitxers PECL resideixen in <acronym>CVS</acronym>.  Una visió en format web 
     es pot trobar a <ulink url="&url.php.cvs;pecl/">&url.php.cvs;pecl/</ulink>.  
     Per a descarregar-se directament des de <acronym>CVS</acronym>, feu-ho de la següent
     manera, on <emphasis>phpfi</emphasis> és la paraula de pas per l'usuari  
     <emphasis>cvsread</emphasis>:
    </simpara>
    <para>
     <screen>
$ cvs -d:pserver:[email protected]:/repository login 
$ cvs -d:pserver:[email protected]:/repository co pecl/extname
     </screen>
    </para>
   </listitem>
   <listitem>
    <simpara>
     Descàrregues Windows
    </simpara>
    <simpara>
     Els usuaris de Windows poden trobar arxius binaris de PECL compilats, descarregant la
     <emphasis>Col·lecció de mòduls PECL</emphasis> des de la pàgina de   
     <ulink url="&url.php.downloads;">Descàrregues PHP</ulink>, i 
     recuperant una <ulink url="&url.php.snapshots;">Imatge Fixa PECL</ulink>.  Per a 
     compilar PHP sota Windows, llegiu el document  
     <ulink url="&url.php.win32.build.readme;">README del muntatge en Win32</ulink>.
    </simpara>
   </listitem>
  </itemizedlist>
 </sect1>

 <sect1 id="install.pecl.windows">
  <title>PECL per usuaris de Windows</title>
  <simpara>
   Com en qualsevol altra extensió de PHP en format <acronym>DLL</acronym>, 
   per a instal·lar-la, moveu les DLLs de les extensions PECL a la carpeta 
   <link linkend="ini.extension-dir">extension_dir</link> i incloeu-les a &php.ini;. 
   Per exemple:
  </simpara>
  <para>
   <screen>
extension=php_extname.dll
   </screen>
  </para>
  <simpara>
   Després d'haver fet això, reiniceu el servidor
  </simpara>
 </sect1>
 
 <sect1 id="install.pecl.pear">
  <title>Utilització de PEAR per a la compilació d'extensions PECL compartides</title>
  <simpara>
   PEAR facilita la creació d'extensions PHP compartides. Utilizant la 
   <ulink url="&url.php.pear.cli;">comanda pear</ulink>, feu el següent:
  </simpara>
  <para>
   <screen>
$ pear install extname
   </screen>
  </para>
  <simpara>
   Això descarregarà el codi font per <emphasis>extname</emphasis>, i el 
   compilarà en el sistema. Això resultarà en un fitxer 
   <filename>extname.so</filename> que llavors pot ser inclòs en el fitxer &php.ini;
  </simpara>
  <simpara>
   En el cas que el valor de sistema <emphasis>preferred_state</emphasis> estigui establert 
   a un valor superior que una versió <emphasis>extname</emphasis> disponible (per exemple, quan 
   el valor està posat a stable, i l'extensió encara és en beta, teniu dues opcions: 
   modifiqueu el valor de <emphasis>preferred_state</emphasis> via <literal>pear config-set</literal> 
   o bé especifiqueu una versió específica de l'extensió PECL. Per exemple:
  </simpara>
  <para>
   <screen>
$ pear install extname-0.1.1
   </screen>
  </para>
  <simpara>
   En qualsevol dels casos, pear copiarà aquest fitxer <filename>extname.so</filename> dins del 
   <link linkend="ini.extension-dir">directori d'extensions</link>. Feu els ajustaments necessaris
   en &php.ini;.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.phpize">
  <title>Compilació d'extensions compartides PECL amb phpize</title>
  <simpara>
   Si l'ús de pear no és possible, per exemple per a muntar extensions compartides PECL
   des de <acronym>CVS</acronym>, o bé per paquets PECL no alliberats, llavors la creació d'una
   extensió compartida es pot fer manualment, utilizant la comanda <literal>phpize</literal>. 
   La comanda pear, essencialment, fa això, però es pot fer de forma manual. 
   Suposant que el fitxer font es diu <filename>extname.tgz</filename>, i que va ser descarregat 
   en la carpeta activa, caldria fer el següent:
  </simpara>
  <para>
   <screen>
<![CDATA[
$ pear download extname
$ gzip -d < extname.tgz | tar -xvf -
$ cd extname
$ phpize
$ ./configure && make
]]>
   </screen>
  </para>
  <simpara>
   Quan s'ha fet correctament aquesta seqüència de comandes, es crearà el 
   fitxer <filename>extname.so</filename> i es desarà en la ubicació 
   <filename>modules/</filename> i/o la ubicació <filename>.libs/</filename> 
   directory. Moveu aquesta extensió compartida (<filename>extname.so</filename>) 
   a la <link linkend="ini.extension-dir">carpeta d'extensions</link> de PHP, i ajusteu
   el fitxer &php.ini; com correspongui.
  </simpara>
 </sect1>

 <sect1 id="install.pecl.static">
  <title>Compilació d'extensions PECL estàticament en PHP</title>
  <simpara>
   Per a incloure l'extensió de forma estàtica dins de PHP, poseu el codi de 
   les extensions en la carpeta <filename>ext/</filename> que es troba en  
   la ruta del codi font de PHP. Per exemple:
  </simpara>
  <para>
   <screen>
<![CDATA[
$ cd /your/phpsrcdir/ext
$ pear download extname
$ gzip -d < extname.tgz | tar -xvf -
$ mv extname-x.x.x extname
$ rm package.xml
]]>
   </screen>
  </para>
  <simpara>
   El resultat d'això serà la següent carpeta:
  </simpara>
  <para>
   <screen>
    /your/phpsrcdir/ext/extname
   </screen>
  </para>
  <simpara>
   Des d'aquí, munteu PHP amb normalitat:
  </simpara>
  <para>
   <screen>
$ cd /your/phpsrcdir 
$ rm configure
$ ./buildconf --force
$ ./configure --help
$ ./configure --with-extname --enable-someotherext --with-foobar
$ make
$ make install
   </screen>
  </para>
  <note>
   <simpara>
    Per a executar l'script 'buildconf', necessiteu autoconf 2.13 i automake 1.4+
    (versions més recents d'autoconf poden funcionar, però no estan suportades).
   </simpara>
  </note>
  <simpara>
   Si s'utilitza <literal>--enable-extname</literal> o bé <literal>--with-extname
   </literal> depèn de l'extensió. Típicament una extensió que no requereix biblioteques 
   externes utiliza <literal>--enable</literal>. Per estar-ne segur, executeu el següent 
   després de buildconf:
  </simpara>
  <para>
   <screen>
$ ./configure --help | grep extname
   </screen>
  </para>
 </sect1>
</chapter>   

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