window下扩展开发 （php5.3.5+vs2010)
由 admin 发表于 23:12http://www.php.net/extra/bindlib_w32.zip
http://www.php.net/extra/win32build.zip
把 这2个包的内容放一起，例如解压缩到 D:\win32build
请使用 Visual Studio Tools 下的 Visual Studio 命令提示 操作
进入D:\php-src\
执行buildconf.bat
建立一个临时环境变量，执行set path=%path%;D:\win32build\bin
执行 cscript /nologo configure.js –with-php-build=”../win32build” –without-libxml –disable-odbc
如果想 要No Thread Safe 模式就在上面的命令最后加上参数 –disable-zts
然后看看是不是main下面多了一个 config.w32.h~
还有一点，config.w32.h 里面 #define PHP_COMPILER_ID 改成和你正在用的 PHP 编译版本相同的编译器ID，例如VC6或者VC9，不然编译出来的扩展没法载入，说实话，这个ID的判断真的很傻很天真….
开发环境的搭建
首先我们需要一个 PHP 的源码包，这个可以到http://www.php.net/downloads.php 去下载，记得我们是要源码包（Complete Source Code）而不是PHP 的二进制代码包（Windows Binaries）。本文所采用是 PHP 5.3.5 的源码包。除此之外我们还需要一个 php5ts.lib 。这在PHP 二进制代码包的 dev 目录（php4ts.lib 则是直接放在二进制代码包的根目录）下可以找到。
将该源码包解压到某个目录（假定是D:\Work\PHP\work\php5，以后我们以 $PHP 指代该源码根目录），我们可以看到main、Zend、win32、TSRM、ext 等目录。在 ext 目录下有 ext_skel 和 ext_skel_win32.php 两个文件。Ext_skel 是在 xNix 环境下的一个用于构建PHP 扩展，生成 PHP 扩展框架的自动化脚本。由于是在 xNix 环境下使用的，并且使用方法也比较简单，故本文不再赘述。具体使用方法可参见源码包根目录（即 $PHP）下的README.EXT_SKEL 文件。ext_skel_win32.php 顾名思义是用来创建 Win32 环境下扩展框架的的脚本。这个脚本需要 Cygwin (http://www.cygwin.com/) 的支持。使用方法和ext_skel 大同小异。本文所采用的是第三种方法：使用 VC 的向导手动创建一个项目文件。这种方法好处就是不需要 Cygwin 的支持，但在编译该扩展的 xNix 版本时仍然需要通过ext_skel 来创建一个相应的框架。
我们在这里使用的 IDE 是 VC++ 2010 Express Edition 。如果你的扩展将来需要分发到更多的地方，建议你使用 VC++ 6.0，这样可增加一定的兼容性。PHP 扩展在 VC++ 6.0 和 VC++ 2010里面的操作都差不多，但在 VC++ 2010 中需要进行一些额外的设置。
现在让我们打开 VC++ 2010，在菜单中选择 【File】 -> 【New】 -> 【Project】 来创建这个扩展的项目文件。
在【项目类型(Project Types)】中选择“Virual C++”，项目【模版（Templates）】为“Win32 Project”。在本例中我们的扩展名字为 phpmore，位于 $PHP\ext目录下。
提示：虽然一个扩展项目的存放位置并没有具体规定，但放到 $PHP\ext 目录下是一个惯例，这会避免很多不必要的麻烦。
在出现的 【Win32 应用程序向导（Win32 Application Wizard）】中点击左面的【应用程序设置（Application Settings）】，设置【程序类型（Application Type）】为“DLL”，并且将其设置为【空项目（Empty Project）】。点击【完成（Finish）】就创建了该扩展的项目文件。此时你应该会在 $PHP\ext\phpmore 目录下找到该扩展的“解决方案(solution)”文件。在$PHP\ext\phpmore\ phpmore 目录下找到扩展的“项目（Project）”文件。
提示：按照 VS 2010 的说法，一个“解决方案(solution)”是由多个“项目（Project）”组成的，因此产生这样的目录结构是十分合理的。但对 PHP 扩展而言，由于需要在各个系统平台下运行，如果把所有平台的项目文件都放在扩展的根目录下面，就会给人一种非常凌乱的感觉。一个值得推荐的解决方法就是为每个平台都建立一个目录，各自包含相应的项目文件，而把源代码文件（*.c 和 *.h 等）放在扩展根目录或其他一个单独的目录。本文为了简单叙述起见，不再额外处理，但在实际应用过程中请注意源代码目录的合理分配。
现在我们将扩展的源代码文件（phpmore.c 和 phpmore.h ，当然此时是空文件）新建/添加到 phpmore 扩展的项目文件当中。
提示：在 VC++ 2010 中添加源代码文件时默认的后缀名为 .cpp，此时需要主动为文件添加上 .c 的扩展名。否则 VC 的编译器会将其默认为 C++ 代码而进行编译（当然这种设置也是可以改变的），这样就可能会产生一些编译错误。
为了能够很方便的引用 PHP 代码的头文件以及对项目进行编译，我们还需要对项目文件进行一些设置。请通过菜单【项目(Project)】-> 【phpmore 属性(Properties)】进入项目的属性设置页。这里我们先对项目的【Release】版进行配置。见图四。
先转到【C++】属性的【General】页填入“Additional Include Directories”： $PHP;$PHP\main;$PHP\win32;$PHP\TSRM;$PHP\Zend。我们这里输入的绝对路径，但实际开发过程中最好填入相对路径。
再转到【C++】属性的【Preprocessor】页补充一些“Preprocessor Definitions”： ZEND_WIN32;PHP_WIN32;ZTS=1; ZEND_DEBUG=0; COMPILE_DL_PHPMORE 。前面3个是在 Win32 环境下开发所必加的预定义；ZEND_DEBUG=0表示扩展不创建为Debug 版本（因为现在是在配置Release 版本嘛～）；COMPILE_DL_PHPMORE 用于是否将本扩展编译为一个“外部扩展（定义见文首）”。
在【C++】属性里面还需要设置的有：【Code Generation】页的“运行库（Runtime Library）”请设置为“Multi-threaded DLL (/MD)”；【Advanced】页的“编译方式（Compile As）”请设置为“Compile as C Code (/TC)”
此外还需要在【连接器(Linker)】属性的【Input】页添加一个“Additional Dependencies”： php5ts.lib 。你可以把 php5ts.lib 放到一个 VC++ 能找到的地方，比如项目文件的目录。当然你若采用的是 PHP 4的源码包，请相应地把php5ts.lib 替换为 php4ts.lib 。
这样，整个扩展项目文件的Release 版本就配置好了。对于 Debug 版本可以有针对性的作一些改动。不过需要注意，一般的 PHP 二进制代码包不允许加载 Debug 版本的扩展，只有将 PHP 编译为 Debug 版本才能加载 Debug 版本的扩展。
提示：如果需要扩展在多种PHP版本中都可布署，那可以先设置一个基本配置（就像上例不设置 php5ts.lib），然后再创建一个继承自基本配置的新的配置－比如Release_PHP5－在这个 Release_PHP5 中额外设置一下 php5ts.lib 就可以了。有的扩展还不事先预定义 ZTS，而是额外再创建一个 Release_TS 的配置，道理是一样的。
OK，现在万事俱备，只欠编码了，让我们这就开始吧！
所有的扩展都大致由4个部分组成：引用相关的头文件、Zend 模块的声明与相关函数实现、get_module() 函数的实现以及导出函数的声明和实现。
为了简单叙述起见，我先列出本文例子的代码：
phpmore.h :
01 |
#ifndef PHPMORE_H |
02 |
#define PHPMORE_H |
03 |
extern zend_module_entry phpmore_module_entry; |
04 |
#define phpext_phpmore_ptr &phpmore_module_entry |
05 |
06 |
/* declaration of functions to be exported */ |
07 |
ZEND_FUNCTION(welcome_to_phpmore); |
08 |
PHP_MINFO_FUNCTION(phpmore); |
09 |
10 |
#define PHPMORE_VERSION "0.1.0" |
11 |
#endif |
phpmore.c :
01 |
#define _USE_32BIT_TIME_T 1 |
02 |
#include "php.h" |
03 |
#include "phpmore.h" |
04 |
05 |
zend_function_entry phpmore_functions[] = |
06 |
{ |
07 |
ZEND_FE(welcome_to_phpmore, NULL) |
08 |
{NULL, NULL, NULL} |
09 |
}; |
10 |
11 |
zend_module_entry phpmore_module_entry = |
12 |
{ |
13 |
STANDARD_MODULE_HEADER, |
14 |
"PHP&More", |
15 |
phpmore_functions, |
16 |
NULL, |
17 |
NULL, |
18 |
NULL, |
19 |
NULL, |
20 |
PHP_MINFO(phpmore), |
21 |
PHPMORE_VERSION, |
22 |
STANDARD_MODULE_PROPERTIES |
23 |
}; |
24 |
25 |
#if COMPILE_DL_PHPMORE |
26 |
ZEND_GET_MODULE(phpmore) |
27 |
#endif |
28 |
29 |
PHP_MINFO_FUNCTION(phpmore) |
30 |
{ |
31 |
php_info_print_table_start(); |
32 |
php_info_print_table_header(2, "PHP&More", "enabled"); |
33 |
php_info_print_table_row(2, "Version", PHPMORE_VERSION); |
34 |
php_info_print_table_end(); |
35 |
} |
36 |
37 |
ZEND_FUNCTION(welcome_to_phpmore) |
38 |
{ |
39 |
zend_printf("Welcome to PHP&More!"); |
40 |
} |
所有扩展都必须至少包含有 php.h ，这是一切的基础，因此必须首先在代码中引用（添加 #define _USE_32BIT_TIME_T 1 这一行是为了去掉 VC++ 2005 中 64 位时间格式的支持，在 VS.NET 2003 或 VC++ 6.0 中均无需这样做）。
接下来是扩展的 Zend 函数块的声明。定义了一个名为 phpmore_functions ，每一个元素都是一个 zend_function_entry 结构的 Zend 函数数组。该数组用来声明本扩展一共对外（即 PHP 脚本）提供了多少可用的（导出）函数。由于没有其他地方可以主动提供（导出）函数的个数，因此数组的最后一个元素必须为 {NULL, NULL, NULL}，以便 Zend Engine 可以获知函数数组的元素列表是否结束。
然后就是整个扩展模块的声明。这是一个扩展“最高”层次的声明。全方位地提供了 Zend Engine 所需要的各种信息。上面所声明的导出函数列表也仅仅是用来填充它的一个字段而已。除此之外，这个模块声明还负责提供扩展名称（就是将来在 phpinfo() 函数中出现的那个扩展的名字，本例为“PHP&More”）、导出函数列表（本例为phpmore_functions）、模块启动函数（PHP_MINIT_FUNCTION，在模块第一次加载时被调用，本例为 NULL）、模块关闭函数（PHP_MSHUTDOWN_FUNCTION，在模块卸载关闭时被调用，本例为 NULL）、请求启动函数（在每个请求启动时被调用，本例为 NULL）、请求关闭函数（PHP_RINIT_FUNCTION，在每个请求关闭时被调用，本例为 NULL）、模块信息函数（PHP_RSHUTDOWN_FUNCTION，用于在 phpinfo() 中显示扩展的信息，本例为“PHP_MINFO_FUNCTION(phpmore)”）和模块版本（本例为 PHPMORE_VERSION ，定义在 phpmore.h ）等其他信息。这几个模块函数的调用关系及顺序见图：
模块声明后面就是 get_module() 函数的实现。这个函数的声明没有手动写出，而是使用了一个宏 ZEND_GET_MODULE(phpmore) 来声明。这也是在扩展开发中常用的一种手段，我们应该尽力地去使用宏。get_module() 函数用于向 Zend Engine 报告这是个外部扩展，这也可以使得我们能够通过 dl() 函数来手动加载它。
剩下的两段代码便是我们前面声明函数的具体实现。一个是模块信息函数，一个是对外导出的 welcome_to_phpmore 函数。模块信息函数对外输出了本扩展的启用状态和版本号，而 welcome_to_phpmore 函数则在 PHP 脚本调用 welcome_to_phpmore() 时对外输出字符串“Welcome to PHP&More!”。
一个扩展的大致结构就是这样。简单编译后我们就得到了一个 phpmore.dll 的文件。相应更改更改 php.ini 及重新启动 Web 服务器后，就可以启用这个扩展了。
