在Windows系统中使用VC9、VC11编译32位、64位PHP及其扩展

项目中需要使用runkit模块实现AOP，但是团队成员的开发环境都是Windows，而runkit模块官方没有提供Windows环境下的dll扩展，只能自己编译。

下面是编译过程的分类总结。（操作系统环境为Windows 10 64位中文旗舰版）

• PHP的编译版本 这里的版本指的不是PHP的发行版本，如5.3、7.0，而是指编译时所使用的编译器、程序架构和是否为线程安全。 这些信息可以在phpinfo中打印出来。 上图中所使用的PHP，是使用Miscrosoft Visual 2012中的MSVC11编译的，程序架构为x86（即32位），非线程安全（NTS）。 上图中的PHP，是使用Miscrosoft Visual 2012中的MSVC11编译的，程序架构为x64（即64位），线程安全（TS）。 上图略有不同，没有专门的列表项说明编译器版本、程序架构，只能从编译时的配置中看到相关信息。这里的PHP，是使用Miscrosoft Visual 6中的MSVC6编译的，程序架构为x86（即32位），线程安全（Thread Safety = enabled）。 最后这一张，是使用Miscrosoft Visual 2008中的MSVC9编译的，程序架构为x86（即32位），线程安全（TS）。 本文只讨论MSVC9和MSVC11编译两种情况。
• 准备PHP-SDK和PHP源码 以下步骤无论编译哪种版本的PHP，都是必须的。
  • 下载PHP-SDK： 下载地址在 http://windows.php.net/downloads/php-sdk/ 中可以找到，下载其中的 php-sdk-binary-tools-20110915.zip
  • 解压到C:\php-sdk文件夹
  • 打开命令行，执行如下命令：

    cd c:\php-sdk\

    bin\phpsdk_buildtree.bat phpdev

    会在c:\php-sdk文件夹下生成phpdev文件夹，其中包含vc6、vc8、vc9子文件夹。

    如果使用MSVC11编译PHP，就复制c:\php-sdk\phpdev\vc9到c:\php-sdk\phpdev\vc11。

    如果使用MSVC14编译PHP，就复制c:\php-sdk\phpdev\vc9到c:\php-sdk\phpdev\vc14。

  • 下载相应版本的PHP的编译时依赖包，下载地址见 http://windows.php.net/downloads/php-sdk/ 。 将其解压至相应编译文件夹下的x86或x64文件夹下，覆盖其中的deps文件夹。注意要与要编译的PHP发行版本和程序架构一致，如编译php5.4.x的32位版本则解压deps-5.4-vc9-x86.7z，如编译php5.5.x的64位版本则解压deps-5.6-vc11-x64.7z，依此类推。 php5.4.x和php5.3.x通常需要使用vc9编译，因此其依赖文件解压到c:\php-sdk\phpdev\vc9\x86或c:\php-sdk\phpdev\vc9\x64。 php5.5.x和php5.6.x通常需要使用vc11编译，因此其依赖文件解压到c:\php-sdk\phpdev\vc11\x86或c:\php-sdk\phpdev\vc11\x64。 而php7.0.x则需要vc14编译，因此其依赖文件解压到c:\php-sdk\phpdev\vc14\x86或c:\php-sdk\phpdev\vc14\x64。
  • 下载所需要的PHP源文件，下载地址在 http://windows.php.net/download/ 、 http://php.net/downloads.php 、 http://php.net/releases/ 、 http://windows.php.net/downloads/releases/archives/ 几处都可以找到。 将其解压制相应的编译文件夹下。 例如： 将 php-5.4.45.tar.gz 解压到c:\php-sdk\phpdev\vc9\x86\php-5.4.45或c:\php-sdk\phpdev\vc9\x64\php-5.4.45下，以分别编译其32位和64位版本。 将 php-5.6.16.tar.gz 则解压到c:\php-sdk\phpdev\vc11\x86\php-5.6.16或c:\php-sdk\phpdev\vc11\x64\php-5.6.16下。
  • 如果是编译PHP扩展，则到相应的地址下载源码，本文是以runkit为例，下载地址在 http://pecl.php.net/package/runkit 。 将下载到的源码解压到PHP源码的ext文件夹下，本例是分别解压到c:\php-sdk\phpdev\vc9\x86\php-5.4.45\ext\runkit、c:\php-sdk\phpdev\vc9\x64\php-5.4.45\ext\runkit、c:\php-sdk\phpdev\vc11\x86\php-5.6.16\ext\runkit、c:\php-sdk\phpdev\vc11\x64\php-5.6.16\ext\runkit。
• 准备编译环境：
  • 使用MSVC9编译PHP，需要下载安装 Windows SDK 6.1 ，此地址下载的是在线安装版。也可以在

    http://download.microsoft.com/download/a/4/2/a4282359-1d35-4648-a7a7-d85e3bfe81ac/6.0.6001.16621.148.WindowsSDK_LonghornServer_IDS04_idw.WindowsSDK.DVD.Release.iso 下载离线安装包。

    如需编译32位版本，在安装Windows SDK 6.1时，要注意选择安装x86编译器，否则会出现找不到cl.exe的问题。
  • 使用MSVC11编译PHP，可以下载 Visual Studio 2012 Express for Windows Desktop ，有在线安装版和离线安装版（ISO）。
  • 两个工具不冲突，可以同时安装在同一系统下。

下面是具体的编译步骤，有些内容会出现重复，是为了让偷懒的同学按图索骥，有样学样:)

• 使用MSVC9编译PHP5.4.33的32位版（本例为编译runkit.dll）
  • 安装 Windows SDK 6.1 ，注意安装时选择x86编译器。
  • 将下载的 php-sdk-binary-tools-20110915.zip 解压到c:\php-sdk。
  • 打开Windows命令行，输入如下命令： cd c:\php-sdk bin\phpsdk_buildtree.bat phpdev
  • 将下载的 php-5.4.45.tar.gz 解压到c:\php-sdk\phpdev\vc9\x86\php-5.4.45。
  • 将下载的 deps-5.4-vc9-x86.7z 解压到c:\php-sdk\phpdev\vc9\x86\deps覆盖原deps文件夹。
  • 将下载的 http://pecl.php.net/get/runkit-1.0.4.tgz 解压到c:\php-sdk\phpdev\vc9\x86\php-5.4.45\ext文件夹，注意文件夹的名称不要带版本号，本例应为runkit，而非runkit-1.0.4。
  • 在c:\php-sdk\phpdev\vc9\x86下建立obj文件夹，用于存放最终的php.exe及相关的dll文件。
  • 点击开始菜单，选择Microsoft Windows SDK V6.1>CMD Shell，启动编译命令行。
  • 输入如下指令： setenv /x86 /xp /release（此行命令执行成功，命令行的文字将变为绿色） cd c:\php-sdk bin\phpsdk_setvars.bat cd phpdev\vc9\x86\php-5.4.45 buildconf configure --disable-all --enable-cli --enable-runkit=shared --enable-object-out-dir=..\obj 如需编译非线程安全版 （nts版），将上面最后一行换成 configure --disable-all --enable-cli --enable-runkit=shared --disable-zts --enable-object-out-dir=..\obj 最终执行 nmake
  • 在obj中有Release（线程安全版-ts版）或Release_nts（非线程安全版-nts版）文件夹，其中的php.exe及php-runkit.dll即为编译结果。
  • 将php-runkit.dll文件放入PHP安装文件夹的ext文件夹中，修改php.ini，加入extension=php_runkit.dll，重新启动PHP服务即可。
• 使用MSVC9编译PHP5.4.33的64位版（本例为编译runkit.dll）
  • 安装 Windows SDK 6.1 ，注意安装时选择x86编译器。
  • 将下载的 php-sdk-binary-tools-20110915.zip 解压到c:\php-sdk。
  • 打开Windows命令行，输入如下命令： cd c:\php-sdk bin\phpsdk_buildtree.bat phpdev
  • 将下载的 php-5.4.45.tar.gz 解压到c:\php-sdk\phpdev\vc9\x64\php-5.4.45。
  • 将下载的 deps-5.4-vc9-x86.7z 解压到c:\php-sdk\phpdev\vc9\x64\deps覆盖原deps文件夹。
  • 将下载的 http://pecl.php.net/get/runkit-1.0.4.tgz 解压到c:\php-sdk\phpdev\vc9\x64\php-5.4.45\ext文件夹，注意文件夹的名称不要带版本号，本例应为runkit，而非runkit-1.0.4。
  • 在c:\php-sdk\phpdev\vc9\x64下建立obj文件夹，用于存放最终的php.exe及相关的dll文件。
  • 点击开始菜单，选择Microsoft Windows SDK V6.1>CMD Shell，启动编译命令行。
  • 输入如下指令： 与上面编译32位程序明显不同的是，不需要执行 setenv /x86 /xp /release cd c:\php-sdk bin\phpsdk_setvars.bat cd phpdev\vc9\x64\php-5.4.45 buildconf configure --disable-all --enable-cli --enable-runkit=shared --enable-object-out-dir=..\obj 如需编译非线程安全版 （nts版），将上面最后一行换成 configure --disable-all --enable-cli --enable-runkit=shared --disable-zts --enable-object-out-dir=..\obj 最终执行 nmake
  • 在obj中有Release（线程安全版-ts版）或Release_nts（非线程安全版-nts版）文件夹，其中的php.exe及php-runkit.dll即为编译结果。
  • 将php-runkit.dll文件放入PHP安装文件夹的ext文件夹中，修改php.ini，加入extension=php_runkit.dll，重新启动PHP服务即可。
• 使用MSVC11编译PHP5.4.33的32位版（本例为编译runkit.dll）
  • 安装 Visual Studio 2012 Express for Windows Desktop 。
  • 将下载的 php-sdk-binary-tools-20110915.zip 解压到c:\php-sdk。
  • 打开Windows命令行，输入如下命令： cd c:\php-sdk bin\phpsdk_buildtree.bat phpdev
  • 将下载的 php-5.6.16.tar.gz 解压到c:\php-sdk\phpdev\vc11\x64\php-5.6.16。
  • 将下载的 deps-5.6-vc11-x64.7z 解压到c:\php-sdk\phpdev\vc11\x64\deps覆盖原deps文件夹。
  • 将下载的 http://pecl.php.net/get/runkit-1.0.4.tgz 解压到c:\php-sdk\phpdev\vc11\x64\php-5.6.16\ext文件夹，注意文件夹的名称不要带版本号，本例应为runkit，而非runkit-1.0.4。
  • 在c:\php-sdk\phpdev\vc11\x64下建立obj文件夹，用于存放最终的php.exe及相关的dll文件。
  • 点击开始菜单，选择Microsoft Visual Studio 2012>Visual Studio Tools>VS2012 x64 Cross Tools Command Prompt，启动编译命令行。
  • 输入如下指令： cd c:\php-sdk bin\phpsdk_setvars.bat cd phpdev\vc11\x64\php-5.6.16 buildconf configure --disable-all --enable-cli --enable-runkit=shared --enable-object-out-dir=..\obj 如需编译非线程安全版 （nts版），将上面最后一行换成 configure --disable-all --enable-cli --enable-runkit=shared --disable-zts --enable-object-out-dir=..\obj 最终执行 nmake
  • 在obj中有Release（线程安全版-ts版）或Release_nts（非线程安全版-nts版）文件夹，其中的php.exe及php-runkit.dll即为编译结果。
  • 将php-runkit.dll文件放入PHP安装文件夹的ext文件夹中，修改php.ini，加入extension=php_runkit.dll，重新启动PHP服务即可。
• 使用MSVC11编译PHP5.4.33的64位版（本例为编译runkit.dll）
  • 安装 Visual Studio 2012 Express for Windows Desktop 。
  • 将下载的 php-sdk-binary-tools-20110915.zip 解压到c:\php-sdk。
  • 打开Windows命令行，输入如下命令： cd c:\php-sdk bin\phpsdk_buildtree.bat phpdev
  • 将下载的 php-5.6.16.tar.gz 解压到c:\php-sdk\phpdev\vc11\x86\php-5.6.16。
  • 将下载的 deps-5.6-vc11-x86.7z 解压到c:\php-sdk\phpdev\vc11\x86\deps覆盖原deps文件夹。
  • 将下载的 http://pecl.php.net/get/runkit-1.0.4.tgz 解压到c:\php-sdk\phpdev\vc11\x86\php-5.6.16\ext文件夹，注意文件夹的名称不要带版本号，本例应为runkit，而非runkit-1.0.4。
  • 在c:\php-sdk\phpdev\vc11\x86下建立obj文件夹，用于存放最终的php.exe及相关的dll文件。
  • 点击开始菜单，选择Microsoft Visual Studio 2012>Visual Studio Tools>VS2012 x86 Native Tools Command Prompt，启动编译命令行。
  • 输入如下指令： cd c:\php-sdk bin\phpsdk_setvars.bat cd phpdev\vc11\x86\php-5.6.16 buildconf configure --disable-all --enable-cli --enable-runkit=shared --enable-object-out-dir=..\obj 如需编译非线程安全版 （nts版），将上面最后一行换成 configure --disable-all --enable-cli --enable-runkit=shared --disable-zts --enable-object-out-dir=..\obj 最终执行 nmake
  • 在obj中有Release（线程安全版-ts版）或Release_nts（非线程安全版-nts版）文件夹，其中的php.exe及php-runkit.dll即为编译结果。
  • 将php-runkit.dll文件放入PHP安装文件夹的ext文件夹中，修改php.ini，加入extension=php_runkit.dll，重新启动PHP服务即可。

可能遇到的问题：

• 如果遇到There is no script engine for file extension ".js"错误，说明Windows的jscript引擎没有正确注册，可按如下步骤解决：
  • 以管理员身份打开命令行：
  • 执行如下指令：

    regsvr32 %WINDIR%\System32\jscript.dllregsvr32 %WINDIR%\SysWOW64\jscript.dll

  • 生成一个jscript.reg的文件，内容如下：

    Windows Registry Editor Version 5.00

    [HKEY_CLASSES_ROOT\.js]@="jsfile"

    [HKEY_CLASSES_ROOT\.js\PersistentHandler]@="{5e941d80-bf96-11cd-b579-08002b30bfeb}"

    [HKEY_CLASSES_ROOT\JSFile]

    "FriendlyTypeName"=hex(2):40,00,25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,\

    00,6f,00,6f,00,74,00,25,00,5c,00,53,00,79,00,73,00,74,00,65,00,6d,00,33,00,\

    32,00,5c,00,77,00,73,00,68,00,65,00,78,00,74,00,2e,00,64,00,6c,00,6c,00,2c,\

    00,2d,00,34,00,38,00,30,00,34,00,00,00

    [HKEY_CLASSES_ROOT\JSFile\ScriptEngine]@="JScript"

    [HKEY_CLASSES_ROOT\JSFile\ScriptHostEncode]@="{85131630-480C-11D2-B1F9-00C04F86C324}"

    [HKEY_CLASSES_ROOT\JSFile\Shell]@="Open"

    [HKEY_CLASSES_ROOT\JSFile\Shell\Open\Command]

    @=hex(2):25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,00,6f,00,74,00,25,\

    00,5c,00,53,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,5c,00,57,00,53,00,\

    63,00,72,00,69,00,70,00,74,00,2e,00,65,00,78,00,65,00,20,00,22,00,25,00,31,\

    00,22,00,20,00,25,00,2a,00,00,00

    [HKEY_CLASSES_ROOT\JSFile\Shell\Open2]

    @=hex(2):4f,00,70,00,65,00,6e,00,20,00,26,00,77,00,69,00,74,00,68,00,20,00,43,\

    00,6f,00,6d,00,6d,00,61,00,6e,00,64,00,20,00,50,00,72,00,6f,00,6d,00,70,00,\

    74,00,00,00

    "MUIVerb"=hex(2):40,00,25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,00,\

    6f,00,74,00,25,00,5c,00,53,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,5c,\

    00,77,00,73,00,68,00,65,00,78,00,74,00,2e,00,64,00,6c,00,6c,00,2c,00,2d,00,\

    34,00,35,00,31,00,31,00,00,00

    [HKEY_CLASSES_ROOT\JSFile\Shell\Open2\Command]

    @=hex(2):25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,00,6f,00,74,00,25,\

    00,5c,00,53,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,5c,00,43,00,53,00,\

    63,00,72,00,69,00,70,00,74,00,2e,00,65,00,78,00,65,00,20,00,22,00,25,00,31,\

    00,22,00,20,00,25,00,2a,00,00,00

    [HKEY_CLASSES_ROOT\JSFile\Shell\Print\Command]

    @=hex(2):25,00,53,00,79,00,73,00,74,00,65,00,6d,00,52,00,6f,00,6f,00,74,00,25,\

    00,5c,00,53,00,79,00,73,00,74,00,65,00,6d,00,33,00,32,00,5c,00,4e,00,6f,00,\

    74,00,65,00,70,00,61,00,64,00,2e,00,65,00,78,00,65,00,20,00,2f,00,70,00,20,\

    00,25,00,31,00,00,00

    [HKEY_CLASSES_ROOT\JSFile\ShellEx\DropHandler]@="{60254CA5-953B-11CF-8C96-00AA00B8708C}"

    [HKEY_CLASSES_ROOT\JSFile\ShellEx\PropertySheetHandlers\WSHProps]@="{60254CA5-953B-11CF-8C96-00AA00B8708C}"

    [HKEY_CLASSES_ROOT\JScript]@="JScript Language"

    [HKEY_CLASSES_ROOT\JScript\CLSID]@="{f414c260-6ac0-11cf-b6d1-00aa00bbbb58}"

    [HKEY_CLASSES_ROOT\JScript\OLEScript]

  • 双击该文件，点击确定，将其导入注册表即可。
• 如果在使用MSVC9编译32位PHP时，遇到Checking for cl.exe ... 错误，就表示在安装 Windows SDK 6.1 时，忘记选择x86编译器。

PS：

• 以上的步骤中，其实有很多是不需要按部就班的，尤其是文件夹结构。c:\php-sdk，其实可以放在任意盘符下。只要在开始编译前，执行一上：x:\php-sdk\bin\php-setvars.bat就可以了（x:为php-sdk所在盘符）。
• phpdev及其下的各级文件夹也是不需要的，尤其是x86和x64文件夹，并不是放错了就不行的，那只是方便辨识最后编译的结果。只要将deps和php源码放在同一个文件夹下，比如在d:建立php-source文件夹，其下放置desp、obj和php-5.6.16子文件夹（嗯，obj放哪儿也无所谓，在编译时直接将输出结果的位置指向到obj就行了），进入php-5.6.16文件夹进行编译即可。

实践过程中，主要参考如下三篇文章，仅向原作者致谢：

• Build your own PHP on Windows
• windows环境下php和Php扩展编译,扩展dll文件编译
• 解决Win7下There is no script engine for file extension ".js"