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