cvs: phpdoc /en/install/windows building.xml
| From: | Gwynne Raskind | Date: | Wed, 09 Apr 2008 06:59:59 +0000 |
| Subject: | cvs: phpdoc /en/install/windows building.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-1454@lists.php.net to get a copy of this message | ||
gwynne Wed Apr 9 06:59:59 2008 UTC
Modified files:
/phpdoc/en/install/windows building.xml
Log:
quick start guide for Windows builds
http://cvs.php.net/viewvc.cgi/phpdoc/en/install/windows/building.xml?r1=1.15&r2=1.16&diff_format=u
Index: phpdoc/en/install/windows/building.xml
diff -u phpdoc/en/install/windows/building.xml:1.15 phpdoc/en/install/windows/building.xml:1.16
--- phpdoc/en/install/windows/building.xml:1.15 Sun Nov 11 19:05:21 2007
+++ phpdoc/en/install/windows/building.xml Wed Apr 9 06:59:59 2008
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.15 $ -->
+<!-- $Revision: 1.16 $ -->
<sect1 xml:id="install.windows.building" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Building from source</title>
<para>
@@ -7,6 +7,159 @@
Microsoft's tools. To compile PHP with cygwin, please refer to <xref
linkend="install.unix"/>.
</para>
+
+ <sect2 xml:id="install.windows.building.quick-guide">
+ <title>Quick Guide to Building On Windows</title>
+
+ <para>
+ This step-by-step quick-start guide was written in March of 2008, running
+ Windows XP Service Pack 2 with all the latest updates and building PHP 5.2.5
+ and PHP 5.3. Experiences using different tools may differ.
+ </para>
+
+ <orderedlist>
+ <listitem>
+ <para>
+ Download and install:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <link xlink:href="http://www.microsoft.com/express/download/">Microsoft
+ Visual C++ 2008 Express Edition</link>
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <link xlink:href="http://www.microsoft.com/downloads/details.aspx?FamilyID=E6E1C3DF-A74F-4207-8586-711EBE331CDC">
+ Windows SDK for Windows Server 2008 and .NET Framework 3.5</link>
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Copy <filename>C:\Program Files\Microsoft
SDKs\Windows\6.1\Include\WinResrc.h</filename>
+ to <filename>C:\Program Files\Microsoft
SDKs\Windows\6.1\Include\winres.h</filename>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Create the directory <filename>C:\work</filename>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Download <link xlink:href="&url.win32.buildtools;">the Windows build
+ tools</link> and unzip the contents into <filename>C:\work</filename>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Create the directory <filename>C:\usr\local\lib</filename>. Copy the
+ <filename>C:\work\win32build\bin\bison.simple</filename> into the new
+ directory.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Download <link xlink:href="&url.win32.dnsresolver;">the Windows DNS
+ resolver library</link> and unzip the contents into
+ <filename>C:\work</filename>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Open <filename>C:\work\bindlib_w32\bindlib.dsw</filename>. If and when
+ asked whether to update the project, choose Yes. Choose either Debug or
+ Release configuration in the top toolbar, then choose Build => Build
+ Solution.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Obtain a copy of the PHP source and extract it into the
+ <filename>C:\work</filename> directory. At this point, that directory
+ should look something like this:
+ </simpara>
+ <screen>
+<![CDATA[
++-C:\work
+| +-bindlib_w32
+| | +-Debug
+| | | +-resolv.lib
+| | | +-...
+| | +-...
+| +-win32build
+| | +-bin
+| | +-include
+| | +-lib
+| +-php-5.2.5
+| | +-build
+| | +-win32
+| | +-...]]></screen>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Open a shell using the Visual Studio 2008 Command Prompt shortcut in the
+ Start menu.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Execute the command:
+ </simpara>
+ <screen>
+<![CDATA[
+C:\Program Files\Microsoft Visual Studio 9.0\VC> set
"PATH=C:\work\win32build\bin;%PATH%"
+C:\Program Files\Microsoft Visual Studio 9.0\VC>]]></screen>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Enter the <filename>C:\work\php-5.2.5</filename> directory.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Run <command>cscript /nologo win32\build\buildconf.js</command>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Run <command>cscript /nologo configure.js --disable-all --enable-cli
+ --enable-cgi --enable-object-out-dir=.. --disable-ipv6</command>. To
+ enable debugging, add <command>--enable-debug</command> to the end.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ Run <command>nmake</command>.
+ </simpara>
+ </listitem>
+
+ <listitem>
+ <simpara>
+ If all went well, there will now be a working PHP CLI executable at
+ <filename>C:\work\Debug_TS\php.exe</filename>, or
+ <filename>C:\work\Release_TS\php.exe</filename>.
+ </simpara>
+ </listitem>
+
+ </orderedlist>
+ </sect2>
<sect2 xml:id="install.windows.building.environment">
<title>Build Environment</title>