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

From: 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 =&gt; 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>

« previous php.doc.cvs (#1454) next »