cvs: phpdoc /en/install/windows building.xml

nlopess Sun Sep 25 06:29:11 2005 EDT Modified files: /phpdoc/en/install/windows building.xml Log: finish documenting the new Windows build system http://cvs.php.net/diff.php/phpdoc/en/install/windows/building.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc/en/install/windows/building.xml diff -u phpdoc/en/install/windows/building.xml:1.5 phpdoc/en/install/windows/building.xml:1.6 --- phpdoc/en/install/windows/building.xml:1.5 Sun Sep 18 13:01:12 2005 +++ phpdoc/en/install/windows/building.xml Sun Sep 25 06:29:10 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <sect1 id="install.windows.building"> <title>Building from source</title> <para> @@ -83,9 +83,18 @@ (<filename class="directory">C:\work</filename>). </simpara> </listitem> + <listitem> + <simpara> + Build the libraries you are going to need (or download the binaries if + available) and place the headers and libs in the <filename + class="directory">C:\work\win32build\include</filename> and <filename + class="directory">C:\work\win32build\lib</filename> directories, + respectively. + </simpara> + </listitem> </itemizedlist> Following this steps your directory structure looks like this: - <screen> + <screen> <![CDATA[ +--C:\work | | @@ -115,16 +124,24 @@ | | | | | +--lib ]]> - </screen> - </para> - <para> - If you aren't using <ulink url="&url.cygwin;">Cygwin</ulink>, you must also - create the directories <filename - class="directory">C:\usr\local\lib</filename> and then copy - <filename>bison.simple</filename> from <filename - class="directory">C:\work\win32build\bin </filename> to <filename - class="directory">C:\usr\local\lib</filename>. + </screen> + </para> + <para> + If you aren't using <ulink url="&url.cygwin;">Cygwin</ulink>, you must also + create the directories <filename + class="directory">C:\usr\local\lib</filename> and then copy + <filename>bison.simple</filename> from <filename + class="directory">C:\work\win32build\bin </filename> to <filename + class="directory">C:\usr\local\lib</filename>. </para> + <note> + <simpara> + If you want to use PEAR and the comfortable command line installer, the + CLI-SAPI is mandatory. For more information about PEAR and the installer + read the documentation at the <ulink + url="&url.php.pear.manual;">PEAR</ulink> website. + </simpara> + </note> </sect2> <sect2 id="install.windows.building.resolvlib"> @@ -186,6 +203,12 @@ </para> </note> <para> + Before starting, be sure you have read <xref + linkend="install.windows.building.install"/> and you have built all needed + libraries, like <ulink url="&url.libxml;">Libxml</ulink> or <ulink + url="&url.icu;">ICU</ulink> (needed for PHP &gt;= 6). + </para> + <para> First you should open a Visual Studio Command Prompt, which should be available under the Start menu. A regular Command Prompt window shouldn't work, as probably it doesn't have the necessary environment variables set. @@ -199,8 +222,8 @@ search in the following directories: <filename class="directory">pecl; ..\pecl; pecl\rpc; ..\pecl\rpc</filename>. Since PHP 5.1.0, you can change this behaviour by using the <literal>--add-modules-dir</literal> argument - (e.g. <command>buildconf --add-modules-dir=../php-gtk2 - --add-modules-dir=../pecl</command>). + (e.g. <command>cscript /nologo win32/build/buildconf.js + --add-modules-dir=../php-gtk2 --add-modules-dir=../pecl</command>). </para> <para> The third step is configuring. To view the list of the available @@ -240,10 +263,10 @@ <title>Building PHP using DSW files [PHP 4]</title> <para> Compiling PHP using the DSW files isn't supported as of PHP 5, as a much - more flexible system was made available. Anyway, you can still use them, - but keep in mind that they are not maintained very often, so you can have - compiling problems. To compile PHP 4 for windows, this is the only - available way though. + <link linkend="install.windows.building.new">more flexible system was made + available</link>. Anyway, you can still use them, but keep in mind that + they are not maintained very often, so you can have compiling problems. To + compile PHP 4 for windows, this is the only available way though. </para> <sect3 id="install.windows.building.dsw.configure"> @@ -300,7 +323,7 @@ environment variables registered, or have run <command>vcvars.bat</command>, and then execute one of the following commands from the <filename - class="directory">c:\work\php-4.x.x\win32</filename> directory: + class="directory">C:\work\php-4.x.x\win32</filename> directory: </simpara> <itemizedlist> <listitem> @@ -340,14 +363,6 @@ <filename class="directory">Release_TS\cli\</filename> or <filename class="directory">Debug_TS\cli\</filename>. </simpara> - <note> - <simpara> - If you want to use PEAR and the comfortable command line installer, the - CLI-SAPI is mandatory. For more information about PEAR and the installer - read the documentation at the <ulink - url="&url.php.pear.manual;">PEAR</ulink> website. - </simpara> - </note> <simpara> In order to build the SAPI module (<filename>php4isapi.dll</filename>) for integrating PHP with Microsoft IIS, set your active configuration to