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

ezyang Sun Nov 11 02:36:37 2007 UTC Modified files: /phpdoc/en/install/windows building.xml Log: Added information on setting up MSVC 2005 Express environment on Windows, based off of Elizabeth Marie Smith's excellent instructions. These changes are part of a larger project that will entail a rewrite of this entire section of the manual. Note: If there are major problems, someone yell at me and revert. http://cvs.php.net/viewvc.cgi/phpdoc/en/install/windows/building.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc/en/install/windows/building.xml diff -u phpdoc/en/install/windows/building.xml:1.13 phpdoc/en/install/windows/building.xml:1.14 --- phpdoc/en/install/windows/building.xml:1.13 Wed Jun 20 22:24:11 2007 +++ phpdoc/en/install/windows/building.xml Sun Nov 11 02:36:37 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> +<!-- $Revision: 1.14 $ --> <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> @@ -8,16 +8,111 @@ linkend="install.unix"/>. </para> - <sect2 xml:id="install.windows.building.requirement"> - &reftitle.required; + <sect2 xml:id="install.windows.building.environment"> + <title>Build Environment</title> <para> To compile and build PHP you need a Microsoft Development Environment. - Microsoft Visual C++ 6.0 is recommended, though Visual C++ .NET versions - will also work. Since PHP 5 the free Microsoft .NET toolchain is also - supported (you need to install Windows Platform SDK, Visual C++ Toolkit and - .NET Framework SDK). + The following environments are supported: + </para> + <itemizedlist> + <listitem> + <simpara> + Microsoft Visual C++ 6.0 (official) + </simpara> + </listitem> + <listitem> + <simpara> + Microsoft Visual C++ .NET + </simpara> + </listitem> + <listitem> + <simpara> + Microsoft Visual C++ 2005, Windows Platform SDK and .NET Framework SDK (current) + </simpara> + </listitem> + </itemizedlist> + <para> + While VC6 (Microsoft Visual C++ 6.0) is used to perform official Windows + builds, it can no longer be downloaded from Microsoft's website. New users + seeking to build PHP for free must use Microsoft Visual C++ 2005 Express + Edition and its auxiliary components. + </para> + + <sect3 xml:id="install.windows.building.environment.express2005"> + <title>Setting up Microsoft Visual C++ 2005 Express</title> + <note> + <simpara> + Combined, these components are very large and will require over one + gigabyte of disk space. + </simpara> + </note> + <para> + Setting up Microsoft Visual C++ 2005 Express is rather involved, + and requires the installation of three separate packages and various + compatibility changes. Be sure to keep track of the paths in which + these programs are installed into. Download and install the following + programs: + </para> + <itemizedlist> + <listitem> + <simpara> + <link xlink:href="&url.win32.msvc2005express;">Microsoft Visual C++ 2005 Express</link> + </simpara> + </listitem> + <listitem> + <simpara> + <link xlink:href="&url.win32.platform-sdk;">Microsoft Windows Server 2005 Platform SDK</link> + </simpara> + </listitem> + <listitem> + <simpara> + <link xlink:href="&url.win32.net2.0-sdk;">.NET Framework 2.0 Software Development Kit</link> + </simpara> + </listitem> + </itemizedlist> + <para> + There are a few post-installation steps: </para> + <itemizedlist> + <listitem> + <simpara> + <link xlink:href="&url.win32.express-and-sdk;">MSVC 2005 Express must + be configured to use Windows Platform SDK</link>. It is not necessary + to perform step two, as PHP does not use the graphical user interface. + </simpara> + </listitem> + <listitem> + <simpara> + Windows Platform SDK contains a file named <filename>WinResrc.h</filename> + usually in <filename>Include</filename> folder inside the SDK's installation + directory. This needs to be copied and renamed to <filename>winres.h</filename>, + the name PHP uses for the file. + </simpara> + </listitem> + </itemizedlist> <para> + Finally, when using MSVC 2005 Express from the command line, several + environment variables must be set up. <filename>vsvars.bat</filename> + usually found in <filename>C:\Program Files\Microsoft Visual Studio 8\Common7\Tools</filename> + (search for the file if otherwise) contains these declarations. The + <varname>PATH</varname>, <varname>INCLUDE</varname> and <varname>LIB</varname> + environment variables need the corresponding <filename>bin</filename>, + <filename>include</filename> and <filename>lib</filename> directories + of the two newly installed SDKs added to them. + </para> + <note> + <simpara> + The .NET SDK paths may already be present in the <filename>vsvars.bat</filename> + file, as this SDK installs itself into the same directory as + Microsoft Visual C++ 2005 Express. + </simpara> + </note> + </sect3> + </sect2> + + <sect2 xml:id="install.windows.building.libraries"> + <title>Libraries</title> + <para> To extract the downloaded files you will also need a ZIP extraction utility. Windows XP and newer already include this functionality built-in. </para>