PHP扩展编写点滴 技巧收集
程序员文章站
2022-05-14 12:08:36
红色部分是我的注释。 更多信息参看： 1.常用的通用功能已经封装好了，在如zen_api.h 头文件中，不用费力查看内部细节，浪费时间。（参考：extending and...
红色部分是我的注释。
更多信息参看：
1.常用的通用功能已经封装好了，在如zen_api.h 头文件中，不用费力查看内部细节，浪费时间。（参考：extending and embedding php 的附录a）
2.在terminal中运行测试程序，可以看到扩展的内部错误输出，这一点对于解决内存泄漏问题尤其重要。（编译一个debug 的 lib）
3.开发过程中修改makefile中的“cflags = -g -o2”，去掉优化选项，增加-wall和-pedantic，便于调试和显示编译警告；
4.某zval*，但其strval非拷贝的，不可用zval_ptr_dtor(zval**)，要用efree(void*)。
5.terminal中的$_server['pwd']有值，但是无法通过zend_getenv()取得，原因应该是该值无意义或不可靠。
6.调用“导出函数”，可利用internal_function_param_passthru传参；声明的非导出函数可通过internal_function_param使用“导出函数”的参数。
7.注意：return_type用在选择分之和循环等处时，最好置于花括号中，
或者不用分号，因为：#define return_bool(b) { retval_bool(b); return; }。
8.如果函数的参数是引用的，且非标量，要先析构，以防内存泄露。
9.抛出异常前最好判断eg(exception)中是否已经存在异常，否则会造成内存泄露。
10.当web服务器api是isapi (iis)的时候，zend_getenv函数是不起作用的。
11.向zend_stack_push()传入数据指针，实际存储(copy)的是该指针指向的数据，换句话说，传入的应该是要存储的数据的指针。
zend_api int zend_stack_push(zend_stack *stack, void *element, int size);
zend_api int zend_stack_top(zend_stack *stack, void **element);
其中，size == sizeof(*element);
类似地，zend_hash也是如此，比较zend_hash_update和zend_hash_find。
12.使用add_assoc_zval(hashtable*, const char*, zval*)存储的是zval*，而非zval，因此，
存储用户传入的参数时候，要先拷贝一份新的zval，否则会发生不可预料的事情。
13.zval_dtor(zval*)释放变量及其内部的引用内存，zval_ptr_dtor(zval**)先检查refcount
再决定是否调用zval_dtor(zval*)，zval_copy_dtor(zval*)仅执行深层的拷贝，即只拷贝
起内部引用的内存，而不拷贝zval；
14.如使用vc编译win的动态链接库，而且代码中调用了zend函数，如zend_getenv，在zend.h中定义为：
extern "c" {
extern zend_api char *(*zend_getenv)(char *name, size_t name_len tsrmls_dc);
}
需要引入该函数，如要使用zend_api，需要事先取消libzend_exports（包括vc“设置”中的预处理定义），或者使用zend_dlimport，
zend_dlimport char *(*zend_getenv)(char *name, size_t name_len tsrmls_dc);
下面取自：zend_config.w32.h
#ifdef libzend_exports
# define zend_api __declspec(dllexport)
#else
# define zend_api __declspec(dllimport)
#endif
#define zend_dlexport __declspec(dllexport)
#define zend_dlimport __declspec(dllimport)
executor_globals_id也需要作如下声明：
zend_dlimport int executor_globals_id；
（这个比较有用，如果你要手工编译某些扩展的时候，比如我在编译sqlite3这个扩展的时候，就遇到这个问题。）
更多信息参看：
1.常用的通用功能已经封装好了，在如zen_api.h 头文件中，不用费力查看内部细节，浪费时间。（参考：extending and embedding php 的附录a）
2.在terminal中运行测试程序，可以看到扩展的内部错误输出，这一点对于解决内存泄漏问题尤其重要。（编译一个debug 的 lib）
3.开发过程中修改makefile中的“cflags = -g -o2”，去掉优化选项，增加-wall和-pedantic，便于调试和显示编译警告；
4.某zval*，但其strval非拷贝的，不可用zval_ptr_dtor(zval**)，要用efree(void*)。
5.terminal中的$_server['pwd']有值，但是无法通过zend_getenv()取得，原因应该是该值无意义或不可靠。
6.调用“导出函数”，可利用internal_function_param_passthru传参；声明的非导出函数可通过internal_function_param使用“导出函数”的参数。
7.注意：return_type用在选择分之和循环等处时，最好置于花括号中，
或者不用分号，因为：#define return_bool(b) { retval_bool(b); return; }。
8.如果函数的参数是引用的，且非标量，要先析构，以防内存泄露。
9.抛出异常前最好判断eg(exception)中是否已经存在异常，否则会造成内存泄露。
10.当web服务器api是isapi (iis)的时候，zend_getenv函数是不起作用的。
11.向zend_stack_push()传入数据指针，实际存储(copy)的是该指针指向的数据，换句话说，传入的应该是要存储的数据的指针。
zend_api int zend_stack_push(zend_stack *stack, void *element, int size);
zend_api int zend_stack_top(zend_stack *stack, void **element);
其中，size == sizeof(*element);
类似地，zend_hash也是如此，比较zend_hash_update和zend_hash_find。
12.使用add_assoc_zval(hashtable*, const char*, zval*)存储的是zval*，而非zval，因此，
存储用户传入的参数时候，要先拷贝一份新的zval，否则会发生不可预料的事情。
13.zval_dtor(zval*)释放变量及其内部的引用内存，zval_ptr_dtor(zval**)先检查refcount
再决定是否调用zval_dtor(zval*)，zval_copy_dtor(zval*)仅执行深层的拷贝，即只拷贝
起内部引用的内存，而不拷贝zval；
14.如使用vc编译win的动态链接库，而且代码中调用了zend函数，如zend_getenv，在zend.h中定义为：
extern "c" {
extern zend_api char *(*zend_getenv)(char *name, size_t name_len tsrmls_dc);
}
需要引入该函数，如要使用zend_api，需要事先取消libzend_exports（包括vc“设置”中的预处理定义），或者使用zend_dlimport，
zend_dlimport char *(*zend_getenv)(char *name, size_t name_len tsrmls_dc);
下面取自：zend_config.w32.h
复制代码 代码如下:
#ifdef libzend_exports
# define zend_api __declspec(dllexport)
#else
# define zend_api __declspec(dllimport)
#endif
#define zend_dlexport __declspec(dllexport)
#define zend_dlimport __declspec(dllimport)
executor_globals_id也需要作如下声明：
zend_dlimport int executor_globals_id；
（这个比较有用，如果你要手工编译某些扩展的时候，比如我在编译sqlite3这个扩展的时候，就遇到这个问题。）