cvs: phpdoc-ca /install/windows building.xml

eduardcapell Sun Aug 7 12:52:51 2005 EDT Added files: /phpdoc-ca/install/windows building.xml Log:

http://cvs.php.net/co.php/phpdoc-ca/install/windows/building.xml?r=1.1&p=1 Index: phpdoc-ca/install/windows/building.xml +++ phpdoc-ca/install/windows/building.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: eduardcapell Status: ready --> <sect1 id="install.windows.building"> <title>Muntatge des del codi font</title> <para> Abans de començar, val la pena que ens fem una pregunta: "Per què és tan complicat el muntatge en Windows?" Bàsicament, per dues raons: </para> <orderedlist> <listitem> <simpara> Windows (encara) no gaudeix d'una gran comunitat de desenvolupadors que tinguin la intenció de compartir lliurement el seu codi. Com a conseqüència, la inversió necessària en la investigació de la infrastructura requerida per a donar suport a aquest desenvolupament no s'ha fet. El que està disponible ha estat majoritàriament fet possible gràcies al trasllat de les utilitats necessàries des de Unix. No us sorprengueu si aquesta herència es nota de tant en tant. </simpara> </listitem> <listitem> <simpara> La majoria d'instruccions següents ens les hem de creure i punt. Per tant, procureu fer un acte de fe per a seguir-les. </simpara> </listitem> </orderedlist> <sect2 id="install.windows.building.requirement"> &reftitle.required; <para> Per a compilar i muntar el PHP necessiteu un Entorn de Desenvolupament de Microsoft. Es recomana el Microsoft Visual C++ 6.0. Per a extraure els fitxers descarregats necessiteu una utilitat d'extracció (per exemple, Winzip). Si no teniu una utilitat d'extraccio, en podeu obtenir una de franc a <ulink url="&url.infozip;">InfoZip</ulink>. </para> <para> Abans de començar, us heu de descarregar... </para> <itemizedlist> <listitem> <simpara> ..les eines de muntatge en win32 de la pàgina de PHP a <ulink url="&url.win32.buildtools;">&url.win32.buildtools;</ulink>. </simpara> </listitem> <listitem> <simpara> ..el codi font del servei per resoldre noms DNS utilitzat pel PHP des de <ulink url="&url.win32.dnsresolver;"> &url.win32.dnsresolver;</ulink>. Aquest substitueix la biblioteca <filename>resolv.lib</filename> inclosa a <filename>win32build.zip</filename>. </simpara> </listitem> <listitem> <simpara> Si teniu intenció de compilar el PHP com un mòdul d'Apache, també us faran falta els <ulink url="&url.apache.source;">Codis font de l'Apache</ulink>. </simpara> </listitem> </itemizedlist> <simpara> Finalment, també necessitareu el codi font del propi PHP. En podeu obtenir la darrera versió de desenvolupament fet servir <ulink url="&url.php.anoncvs;">anonymous CVS</ulink>, una <ulink url="&url.php.snapshots;">imatge fixa</ulink> o el <ulink url="&url.php.downloads;">paquet de codi</ulink> alliberat més recentment. </simpara> </sect2> <sect2 id="install.windows.building.install"> <title>Putting it all together</title> <para> Després de descarregar els paquets requerits, els heu d'extraure a una ubicació adequada. <itemizedlist> <listitem> <simpara> Creeu un directori de treball, on hi posarem tots els fitxers després d'haver-los extret, per exemple: <filename class="directory">C:\work</filename>. </simpara> </listitem> <listitem> <simpara> Creeu el directori <filename>win32build</filename> dins del directori de treball, (<filename class="directory">C:\work</filename>) i descomprimiu-hi el fitxer <filename>win32build.zip</filename>. </simpara> </listitem> <listitem> <simpara> Creeu el directori <filename>bindlib_w32</filename> dins del directori de treball, (<filename class="directory">C:\work</filename>) i descomprimiu-hi el fitxer <filename>bindlib_w32.zip</filename>. </simpara> </listitem> <listitem> <simpara> Extraieu el codi font de PHP dins del directori de treball (<filename class="directory">C:\work</filename>). </simpara> </listitem> </itemizedlist> Si heu seguit aquests passos correctament, l'estructura de directori hauria de ser la següent: <informalexample> <programlisting> <![CDATA[ +--c:\work | | | +--bindlib_w32 | | | | | +--arpa | | | | | +--conf | | | | | +--... | | | +--php-4.x.x | | | | | +--build | | | | | +--... | | | | | +--win32 | | | | | +--... | | | +--win32build | | | | | +--bin | | | | | +--include | | | | | +--lib ]]> </programlisting> </informalexample> Creeu els directoris <filename class="directory">c:\usr\local\lib</filename>. Copieu el fitxer <filename>bison.simple</filename> des de <filename class="directory">c:\work\win32build\bin</filename> a <filename class="directory">c:\usr\local\lib</filename>. </para> <note> <simpara> Els usuaris de <ulink url="&url.cygwin;">Cygwin</ulink> poden saltar-se el darrer pas. Un entorn de Cygwin correctament instal·lat ja contè els fitxers obligatoris <filename>bison.simple</filename> i <filename>bison.exe</filename>. </simpara> </note> </sect2> <sect2 id="install.windows.building.configure"> <title>Configuració de MVC ++</title> <para> El següent pas és la configuració de MVC ++ per a preparar la compilació. Executeu el Microsoft Visual C++, i aneu a Eines =&gt; Opcions. Al quadre de diàleg que us apareix, trieu la pestanya de directoris. Canvieu seqüencialment la llista desplegable a Executables, Includes, i Biblioteques. Els valors haurien de ser els següents: <itemizedlist> <listitem> <simpara> Fitxers Executables: <filename class="directory">c:\work\win32build\bin</filename>, Usuaris users: <filename>cygwin\bin</filename> </simpara> </listitem> <listitem> <simpara> Fitxers Include: <filename class="directory">c:\work\win32build\include</filename> </simpara> </listitem> <listitem> <simpara> Fitxers de Biblioteques: <filename class="directory">c:\work\win32build\lib</filename> </simpara> </listitem> </itemizedlist> </para> </sect2> <sect2 id="install.windows.building.resolvlib"> <title>Muntatge de resolv.lib</title> <para> Heu de muntar la biblioteca <filename>resolv.lib</filename>. Decidiu si voleu disposar dels símbols de depuració (bindlib - Win32 Debug) o bo (bindlib - Win32 Release). Munteu la configuració apropiada: <itemizedlist> <listitem> <simpara> Per usuaris de la Interfície Gràfica d'Usuari, arrenqueu VC++ i llavors trieu Fitxer =&gt; Obrir Espai de Treball, navegueu a <filename class="directory">c:\work\bindlib_w32</filename> i trieu <filename>bindlib.dsw</filename>. Llavors trieu Muntatge=&gt;Establir Configuració Activa i seleccioneu la configuració que desitgeu. Finalment, trieu Muntatge=&gt;Tornar a Muntar-ho Tot. </simpara> </listitem> <listitem> <simpara> Per usuaris de la línia de comanda, assegureu-vos que teniu les variables d'entorn de C++ registrades, o bé que heu executat <command>vcvars.bat</command>, i llavors executeu una de les següents comandes: </simpara> <itemizedlist> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Debug"</userinput> </simpara> </listitem> <listitem> <simpara> <userinput>msdev bindlib.dsp /MAKE "bindlib - Win32 Release"</userinput> </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> En aquest punt, hauríeu de tenir un fitxer <filename>resolv.lib</filename> vàlid en la carpeta <filename class="directory">c:\work\bindlib_w32\Debug</filename> o <filename>Release</filename>. Copieu aquest fitxer al directori <filename class="directory">c:\work\win32build\lib</filename> a sobre del mateix fitxer que ja existeix en la ruta de destinació. </para> </sect2> <sect2 id="install.windows.building.compile"> <title>Compilació</title> <simpara> La millor manera per començar és el muntatge de la versió CGI. </simpara> <itemizedlist> <listitem> <simpara> Els usuaris de la Interfície Gràfica d'Usuari, obriu VC++, i trieu Arxiu =&gt; Obrir Espai de Treball i seleccioneu <filename>c:\work\php-4.x.x\win32\php4ts.dsw</filename>. Llavors trieu Muntar=&gt;Establir Configuració Activa i trieu la configuració desitjada, que serà <literal>php4ts - Win32 Debug_TS</literal> o bé <literal>php4ts - Win32 Release_TS</literal>. Finalment, trieu Muntatge=&gt;Tornar-ho a Muntar Tot. </simpara> </listitem> <listitem> <simpara> Els usuaris de línia de comandes, assegureu-vos que teniu les variables d'entorn de C++ registrades, o bé que heu executat <command>vcvars.bat</command>, i llavors executeu una de les següents comandes del directori <filename class="directory">c:\work\php-4.x.x\win32 </filename>: </simpara> <itemizedlist> <listitem> <simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Debug_TS"</userinput> </simpara> </listitem> <listitem> <simpara> <userinput>msdev php4ts.dsp /MAKE "php4ts - Win32 Release_TS"</userinput> </simpara> </listitem> <listitem> <simpara> En aquest moment, hauríeu de tenir un fitxer <filename>php.exe</filename> vàlid a la carpeta <filename class="directory">c:\work\php-4.x.x.\Debug_TS</filename> o <filename>Release_TS</filename>. </simpara> </listitem> </itemizedlist> </listitem> </itemizedlist> <simpara> És possible de fer algunes petites personalitzacions en el procés de muntatge, editant el fitxer <filename>main/config.win32.h</filename> . Per exemple, podeu canviar la ubicació per defecte del fitxer &php.ini;, les extensions per defecte, i la ubicació per defecte de les extensions. </simpara> <simpara> Ara potser voleu muntar la versió CLI, que està pensada per a utilitzar <link linkend="features.commandline">PHP des de la línia de comandes</link>. Els passos són els mateixos que en el muntatge de la versió CGI, excepte pel fet que heu de triar el fitxer de projecte <literal>php4ts_cli - Win32 Debug_TS</literal> o <literal>php4ts_cli - Win32 Release_TS</literal>. Després d'una compilació satisfactòria, trobareu el fitxer <filename>php.exe</filename> a la carpeta <filename class="directory">Release_TS\cli\</filename> o <filename class="directory">Debug_TS\cli\</filename>. </simpara> <note> <simpara> Si voleu utilitzar PEAR i el còmode instal·lador de línia de comanda, és imprescindible CLI-SAPI. Per més informació sobre PEAR i l'instal·lador, llegiu la documentació al lloc web de <ulink url="&url.php.pear;manual/">PEAR</ulink>. </simpara> </note> <simpara> Si voleu muntar el mòdul SAPI (<filename>php4isapi.dll</filename>), per la integració de PHP amb Microsoft IIS, especifiqueu la configuració activa a <filename>php4isapi-la-config-que-sigui</filename> i munteu la dll desitjada. </simpara> </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 -->