标签:
1、生成描述文件,包含对函数等的定义
[chengyi@localhost php-extension]$ cat hello_cy.def
string self_concat(string str, int n);
2、进入PHP源码的ext目录
[chengyi@localhost ext]$ pwd
/home/chengyi/centos_soft_install/php-5.2.5/ext
3、查看ext_skel的帮助,我们主要用到的是 --extname=module 定义将要生成的模块名称; --proto=file 指向刚才的描述函数定义的文件。
[chengyi@localhost ext]$ ./ext_skel --help
./ext_skel --extname=module [--proto=file] [--stubs=file] [--xml[=file]]
[--skel=dir] [--full-xml] [--no-help]
--extname=module module is the name of your extension
--proto=file file contains prototypes of functions to create
--stubs=file generate only function stubs in file
--xml generate xml documentation to be added to phpdoc-cvs
--skel=dir path to the skeleton directory
--full-xml generate xml documentation for a self-contained extension
(not yet implemented)
--no-help don‘t try to be nice and create comments in the code
and helper functions to test if the module compiled
4、执行ext_skel,生成空模块
[chengyi@localhost ext]$ ./ext_skel --extname=hello_cy --proto=/home/chengyi/test-all/php-extension/hello_cy.def
Creating directory hello_cy
awk: /home/chengyi/centos_soft_install/php-5.2.5/ext/skeleton/create_stubs:56: warning: escape sequence `/|‘ treated as plain `|‘
Creating basic files: config.m4 config.w32 .cvsignore hello_cy.c php_hello_cy.h CREDITS EXPERIMENTAL tests/001.phpt hello_cy.php [done].
To use your new extension, you will have to execute the following steps:
1. $ cd ..
2. $ vi ext/hello_cy/config.m4
3. $ ./buildconf
4. $ ./configure --[with|enable]-hello_cy
5. $ make
6. $ ./php -f ext/hello_cy/hello_cy.php
7. $ vi ext/hello_cy/hello_cy.c
8. $ make
Repeat steps 3-6 until you are satisfied with ext/hello_cy/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.
5、将生成的空模块mv到自己的目录下去(这里我们没有按照上面ext_skel的说明来做)
[chengyi@localhost ext]$ mv hello_cy/ ~/test-all/php-extension/
6、进入到空模块下,查看都生成了哪些文件
[chengyi@localhost hello_cy]$ ls -p
config.m4 config.w32 CREDITS EXPERIMENTAL hello_cy.c hello_cy.php php_hello_cy.h tests/
可以看到,有一个tests目录。
7、修改config.m4文件,打开编译选项
PHP_ARG_ENABLE(hello_cy, whether to enable hello_cy support,
[ --enable-hello_cy Enable hello_cy support])
if test "$PHP_HELLO_CY" != "no"; then
AC_DEFINE(HAVE_HELLO_CY, 1, [Whether you have Hello World])
PHP_NEW_EXTENSION(hello_cy, hello_cy.c, $ext_shared)
fi
8、执行phpize生成更多文件,为编译做准备
[chengyi@localhost hello_cy]$ phpize
Configuring for:
PHP Api Version: 20041225
Zend Module Api No: 20060613
Zend Extension Api No: 220060519
[chengyi@localhost hello_cy]$ ls
acinclude.m4 build config.m4 configure.in EXPERIMENTAL install-sh missing run-tests.php
aclocal.m4 config.guess config.sub config.w32 hello_cy.c ltmain.sh mkinstalldirs tests
autom4te.cache config.h.in configure CREDITS hello_cy.php Makefile.global php_hello_cy.h
9、开始编译
./configure --enable-hello_cy
make
make test
sudo make install (有时php ext路径不对,就手工cp过去)
10、测试
[chengyi@localhost hello_cy]$ php hello_cy.php
Functions available in the test extension:
confirm_hello_cy_compiled
self_concat
Congratulations! You have successfully modified ext/hello_cy/config.m4. Module hello_cy is now compiled into PHP.
11、如果想要重新获取到一个干净的目录,执行 phpize --clean
12、将扩展加载,修改php.ini文件
如果不确定php.ini的位置,执行如下:
[chengyi@localhost hello_cy]$ php -i|grep "php.ini"
Configuration File (php.ini) Path => /usr/local/php/lib
Loaded Configuration File => /usr/local/php/lib/php.ini
可以看到,该文件在/usr/local/php/lib/php.ini。
在该文件中添加: extension=hello_cy.so
然后重启apache,如果需要在web端执行的话(如果仅在本地脚本执行,则不用重启apache,因为压根没关系)。
-----------------------------------------------------
探求代码为什么这么写呢?
首先要声明,探求这些只能去PHP的源码看了。源码中比较重要的两个目录是main和Zend。
1、PHP_FUNCTION(self_concat){} 是个什么东西?为什么要用它来定义我们的函数呢?
我们在里面找寻PHP_FUNCTION的定义,在main/下:
php.h:#define PHP_FUNCTION ZEND_FUNCTION
然后我们去Zend/目录下,发现了 ZEND_FUNCTION的定义:
zend_API.h:#define ZEND_FUNCTION(name) ZEND_NAMED_FUNCTION(ZEND_FN(name))
然后继续由 ZEND_NAMED_FUNCTION, ZEND_FN的定义追查下去得到: void zif_name(INTERNAL_FUNCTION_PARAMETERS)
再看INTERNAL_FUNCTION_PARAMETERS (其实php源码下都有tags,直接ctrl+]就可以跟踪定义了),得到完整的函数定义:
void zif_name(int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC); // 其实我还蛮好奇这几个参数为什么要这样设置的,等有空去仔细看源码
2、怎样返回值?
我们经常使用的返回值的宏是 RETURN_STRING之类的,去Zend/下找它的定义:
#define RETURN_STRING(s, duplicate) { RETVAL_STRING(s, duplicate); return; }
#define RETVAL_STRING(s, duplicate) ZVAL_STRING(return_value, s, duplicate)
可以看出,是给函数定义的参数return_value赋值了,然后估计是由PHP内部的机制,直接把return_value返回。
标签:
原文地址:http://www.cnblogs.com/wudan7/p/4183219.html