码云创建php项目,【php扩展开发】扩展生成器

什么是扩展生成器

每个PHP的扩展都包含一些非常公共的并且非常单调的结构和文件，这些文件对所有扩展来说都是通用的。当开始一个新扩展开发的时候，如果这些公共的结构已经存在，而不需要费力去复制每个文件的内容，我们只需考虑填充功能代码那心情一定会愉快很多。

扩展生成器就是实现这些功能的脚本，帮助我们完成初始化工作.PHP源码中提供一个自带的生成器ext_skel。他在ext目录下。

ext_skel

它是一个shell脚本，仅有300多行。我们来看下关键部分代码

＃生成config.m4配置文件

cat> config.m4 << eof

dnl $ Id $

dnl config.m4 用于扩展名$ extname

dnl 此文件中的注释以字符串'dnl'开头。

DNL删除其中必要的。此文件无效

dnl没有编辑。

dnl如果你的扩展引用了外部的东西，请使用：

DNL PHP_ARG_WITH($ extname，为 $ extname支持，

dnl确保注释已对齐：

dnl [--with- $ extname 包括$ extname support])

dnl否则使用enable：

PHP_ARG_ENABLE($ extname，是否启用 $ extname支持，

dnl确保注释已对齐：

[--enable- $ extname 启用$ extname支持])

.....省略一大串

EOF

＃生成核心文件

$ ECHO_N “ $ extname .c $ ECHO_C ”

echo “s / extname / $ extname / g” > sedscript

echo “s / EXTNAME / $ EXTNAME / g” >> sedscript

echo '/ __ function_entries_here __ / r function_entries' >> sedscript

echo ' / __ function_stubs_here __ / r function_stubs' >> sedscript

echo '/ __ header_here __ / r ../../header' >> sedscript

echo '/ __ footer_here __ / r ../../footer' >> sedscript

echo '/ __ function_entries_here __ / D' >>

sedscript echo '/ __ function_stubs_here __ / D' >> sedscript

echo '/ __ header_here __ / D' >> sedscript

echo '/ __ footer_here __ / D' >> sedscript

if [！-z “ $ no_help ” ]; 然后

回显 “/ confirm_ $ extname_compiled / D” >> sedscript

echo '/删除以下/，/ ^ * // D' >> sedscript

echo 's / [[：space：]] / *。 + * ///' >> sedscript

echo 的/^/*.**/$//' >> sedscript

echo '/ ^ [[：space：]] * / * / ，/ ^ [[：space：]] * * // D' >>

sed -f sedscript < $ skel_dir /skeleton.c> $ extname .c

帮助说明

./ext_skel --help

它提示了我们脚本的命令行格式和支持的参数

./ext_skel --extname = module [--proto = file] [--stubs = file] [--xml [= file]]

[--skel = dir] [--full-xml] [ - no-help]

--extname = module 扩展名称，全为小写字母的标识符，仅包含字母和下划线，保证在php源码ext目录下的文件夹名唯一

--proto = file允许开发人员指定一个头文件，由此创建一系列PHP函数，表面上看就是要开发基于一个函数库的扩展，很少用

--stubs = file仅生成文件中的函数存根，生成IDE提示文件可能有用

--xml 生成要添加到phpdoc-svn没用的xml文档

--skel = dir路径到骨架目录指定扩展骨架目录，如果你想在ext目录以外的地方生成，那这个有用

--full-XML 生成 XML文档用于自包含的延伸部(未尚未实现)没用

--no的帮助不尝试是好的，并创建代码中的注释和辅助功能测试，如果该模块编译去除生成测试函数和注释等内容，除非你很熟练，不建议操作

示例

/ usr / local / src / php- 7.2。15 / ext / ext_skel --extname = twinkle_log --skel = / usr / local / src / php- 7.2。15 /分机/骨架/