php扩展开发

扩展入口相关函数

名称	说明
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 */  
...