扩展入口相关函数
| 名称 | 说明 |
|---|---|
| PHP_MINIT_FUNCTION | 当PHP被装载时，模块启动函数即被引擎调用。这使得引擎做一些例如资源类型，注册INI变量等的一次初始化 |
| PHP_MSHUTDOWN_FUNCTION | 当PHP完全关闭时，模块关闭函数即被引擎调用。通常用于注销INI条目 |
| PHP_RINIT_FUNCTION | 在每次PHP请求开始，请求前启动函数被调用。通常用于管理请求前逻辑。 |
| PHP_RSHUTDOWN_FUNCTION | 在每次PHP请求结束后，请求前关闭函数被调用。经常应用在清理请求前启动函数的逻辑。 |
| PHP_MINFO_FUNCTION | 调用phpinfo()时模块信息函数被呼叫，从而打印出模块信息 |
变量定义
php代码
<?php
$a = 2;
扩展写法
zval *a_val;
MAKE_STD_ZVAL(a_val);
ZVAL_LONG(a_val,2);
ZEND_SET_SYMBOL(EG(active_symbol_table), "a", a_val);
MAKE_STD_ZVAL展开
(a_val) = (zval *) emalloc(sizeof(a_val));
(a_val)->refcount__gc = 1;
(a_val)->is_ref__gc = 0;
定义一个数组
php代码
<?php
$arr = array(
'a'=>2,
'b'=>array(1,2,3)
)
扩展代码
zval *arr,*b;
MAKE_STD_ZVAL(arr);
array_init(arr);
add_assoc_long(arr,"a",2);
MAKE_STD_ZVAL(b);
array_init(b);
add_next_index_long(b,1);
add_next_index_long(b,2);
add_next_index_long(b,3);
add_index_zval(arr,"b",b);
//释放资源
FREE_ZVAL(&b);
FREE_ZVAL(&arr);
定义一个方法
示例php
<?php
function hello($name){
echo "Hello,{$name}\n";
}
示例扩展写法：
const zend_function_entry hello_functions[] = {
PHP_FE(hello,NULL)
PHP_FE_END
}
PHP_FUNCTION(hello){
chat *name;
int name_len;
if(zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &name, &name_len) == FAILURE){
RETURN_NULL;
}
php_printf("Hello,");
PHPWRITE(name,name_length);
php_printf("\n");
}
参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| b | zend_bool | 布尔型 |
| l | long | 长整型 |
| d | double | 浮点数 |
| s | char*,int len | 二进制字符串，长度 |
| a | zval* | 数组 |
| o | zval* | 对象 |
| O | zval* | 指向实体的类型 |
| z | zval* | 任意类型 |
参数特殊符号
| 名称 | 描述 |
|---|---|
| ｜ | 在|之前的参数为必填参数，在|之后的参数为可选参数 |
| * | 一共>=0个参数 |
| + | 一共>=1个参数 |
| ! | 用来修饰前面一个参数，如果传递过来的参数值为NULL，则直接转化成C语言的NULL，而不是zval的IS_NULL变量，区别在于后者增加了计算和赋值，浪费了更多的资源 |
特殊符号示例
//mixed str_replace ( mixed $search , mixed $replace , mixed $subject [, int &$count ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ZZZ|Z", &search, &replace, &subject, &zcount) == FAILURE)
//在str_replace中，内核用了前3个ZZZ来接受必要的三个参数，接收到的变量是zval**类型，然后有一个|，表示后面的参数是可选的，如果传递了，还是用一个Z(zval**)变量接受它
//int array_push ( array &$array , mixed $var [, mixed $... ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a+", &stack, &args, &argc) == FAILURE)
//在array_push中，内核用了a（zval*）来接受第一个参数，然后用了一个+表示后面至少得有一个参数传递，或者更多。
//array range ( mixed $start , mixed $limit [, number $step = 1 ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/z/|z/", &zlow, &zhigh, &zstep) == FAILURE)
//在range中，一共出现了3个z/，每个z/表示一个参数，说明是用z(zval*)来接受变量，同时对非引用的变量做强制拷贝后再传参
//mixed sscanf ( string $str , string $format [, mixed &$... ] )
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss*", &str, &str_len, &format, &format_len,&args, &num_args) == FAILURE)
//在sscanf中，每个s表示一个字符串，得用两个变量来接受，一个char*类型，指向字符串，另一个是int型，等于字符串的长度。&str, &str_len接受第一个s,&format, &format_len接受第二个s，最后一个*表示后面还可以有0到多个参数
main/php.h
#define PHP_FUNCTION ZEND_FUNCTION
Zend/zend_API.h
#define ZEND_FUNCTION(name) ZEND_NAMED_FUNCTION(ZEND_FN(name))
#define ZEND_NAMED_FUNCTION(name) void name(INTERNAL_FUNCTION_PARAMETERS)
Zend/zend.h
#define INTERNAL_FUNCTION_PARAMETERS int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC
代码展开为
void zif_hello( int ht, zval *return_value, zval **return_value_ptr, zval *this_ptr, int return_value_used TSRMLS_DC)
{
}
定义一个类
php写法
<?php
class myclass{
public function __construct(){
echo "__construct";
}
public function show(){
echo "show";
}
}
$obj = new myclass();
$obj->show();
扩展写法
zend_class_entry *my_class_ce;//定义全局指针变量，指向my_class_ce类
static zend_function_entry my_class_functions[] = {
PHP_ME(my_class,__construct,NULL,ZEND_ACC_CTOR|ZEND_ACC_PUBLIC)
PHP_ME(my_class,show,NULL,ZEND_ACC_PUBLIC)
PHP_FE_END
}
PHP_MINIT_FUNCTION(my_class){
zend_class_entry class_ce;
INIT_CLASS_ENTRY(class_ce,"myClass",my_class_functions);
my_class_ce = zend_register_internal_class(&class_ce TSRMLS_CC);
return SUCCESS;
}
//方法定义
PHP_METHOD(my_class,__construct){
php_printf("__construct");
}
PHP_METHOD(my_class,show){
php_printf("show");
}
类公开范围定义
Zend/zend_compile.h
#define ZEND_ACC_STATIC 0x01 /* 静态方法 */
#define ZEND_ACC_ABSTRACT 0x02 /* 抽象方法 */
#define ZEND_ACC_FINAL 0x04 /* 终态方法 */
#define ZEND_ACC_PUBLIC 0x100 /* PUBLIC */
#define ZEND_ACC_PROTECTED 0x200 /* PROTECTED */
#define ZEND_ACC_PRIVATE 0x400 /* PRIVATE */
#define ZEND_ACC_CTOR 0x2000 /* __construct */
#define ZEND_ACC_DTOR 0x4000 /* __destruct */
#define ZEND_ACC_CLONE 0x8000 /* __clone */
...
