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

eduardcapell Wed Aug 3 04:25:37 2005 EDT Added files: /phpdoc-ca/install intro.xml pecl.xml Log:

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:cvsread@cvs.php.net:/repository login $ cvs -d:pserver:cvsread@cvs.php.net:/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 -->