组成扩展的文件
不管是通过手工,通过ext_skel ,还是通过另外的扩展生成器,例如 » CodeGen,所有的扩展都会有至少四个文件:
- config.m4
-
UNIX 构建系统配置 (见 与 UNIX 构建系统交互: config.m4)
- config.w32
-
Windows 构建系统配置 (见 使用 Windows 构建系统:config.w32)
- php_counter.h
-
当将扩展作为静态模块构建并放入 PHP 二进制包时,构建系统要求用 php_ 加扩展的名称命名的头文件包含一个对扩展模块结构的指针定义。就象其他头文件,此文件经常包含附加的宏、原型和全局量。
- counter.c
-
主要的扩展源文件。按惯例,此文件名就是扩展的名称,但不是必需的。此文件包含模块结构定义、INI 条目、管理函数、用户空间函数和其它扩展所需的内容。
构建系统的文件在别处讨论,本节关注于其余的部分。扩展应包含任意数量的头文件、源文件、单元测试和其他支持文件,此四个文件仅够组成最小的扩展。counter 扩展的文件列表如下所示:
Example #1 counter 扩展中的文件,未特别排序
ext/ counter/ .cvsignore config.m4 config.w32 counter_util.h counter_util.c php_counter.h counter.c package.xml CREDITS tests/ critical_function_001.phpt critical_function_002.phpt optional_function_001.phpt optional_function_002.phpt
非源文件
.cvsignore 文件用于已检入一个 PHP CVS 资源库(通常是 » PECL)的扩展,由 ext_skel 生成的这个文件内容如下:
.deps *.lo *.la
这几行告诉 CVS 要忽略由 PHP 构建系统生成的临时文件。这只是惯例,可以被完全省略掉且无不良影响。
CREDITS 文件用纯文本格式列出了扩展的贡献者和(或 )维护者。此文件的主要用途是为已捆绑的扩展生成被 phpcredits() 所使用的荣誉信息。按惯例,文件的第一行应保存扩展的名称,第二行是用逗号分隔的贡献者名单。贡献者通常是按其贡献物的时间顺序排序。例如,在 » PECL 包中,此信息已经维护在 package.xml 中了。这就是可以被省略且无不良影响的其他文件。
package.xml 文件是基于 » PECL 的扩展特有的,是一个元信息文件,记录了扩展的信赖关系、作者、安装需求和其他有价值的信息。对于不是基于 » PECL 的扩展来说,此文件就无关紧要了。