擴展入口相關函數
| 名稱 | 說明 |
|---|---|
| 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變量，區(qū)別在于后者增加了計算和賦值，浪費了更多的資源 |
特殊符號示例
//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 /* 靜態(tài)方法 */
#define ZEND_ACC_ABSTRACT 0x02 /* 抽象方法 */
#define ZEND_ACC_FINAL 0x04 /* 終態(tài)方法 */
#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 */
...
