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

--eduardcapell1123433571
Content-Type: text/plain

eduardcapell		Sun Aug  7 12:52:51 2005 EDT

  Added files:                 
    /phpdoc-ca/install/windows	building.xml 
  Log:
  
  
--eduardcapell1123433571
Content-Type: text/plain
Content-Disposition: attachment; filename="eduardcapell-20050807125251.txt"


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

--eduardcapell1123433571--