php扩展研究之一（实现a+b）

梦里梦外; 2022-06-11 02:22 182阅读 0赞

系统：centos

php版本：php5.6.3  
安装过程：源码包进行编译

## 1. 生成php扩展骨架 ##

PHP编译好之后，进入PHP源码包ext目录下，有个可执行文件ext\_skel，这个文件是zend开发团队为了  
方便扩展开发者快速构建扩展骨架而编写的，我们使用 --help 看看我们需要的参数

[root@wjw 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

接下来我们使用到的两个参数分别是

extname ：设置扩展模块的名称

proto ：设置函数的原型的文件地址（函数原型是指c语言的函数原型）  
  
  
我们的目的是实现两个整数相加，我们创建一个原型文件 addtest.skel,内容如下

int addtest(int a,int b)

然后我们执行命令：

[root@wjw ext]# ./ext_skel --extname=addtest --proto=./addtest.skel
    Creating directory addtest
    awk: /usr/local/src/php-5.6.3/ext/skeleton/create_stubs:56: 警告: 转义序列“\|”被当作单纯的“|”
    Creating basic files: config.m4 config.w32 .gitignore addtest.c php_addtest.h CREDITS EXPERIMENTAL tests/001.phpt addtest.php [done].
    
    
    To use your new extension, you will have to execute the following steps:
    
    
    1.  $ cd ..
    2.  $ vi ext/addtest/config.m4
    3.  $ ./buildconf
    4.  $ ./configure --[with|enable]-addtest
    5.  $ make
    6.  $ ./sapi/cli/php -f ext/addtest/addtest.php
    7.  $ vi ext/addtest/addtest.c
    8.  $ make
    
    
    Repeat steps 3-6 until you are satisfied with ext/addtest/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.

到这里，我们的扩展骨架就自动生成了。接下来，我们不遵循上面提示的步骤，当然你按照上面的来也可以，只是要重新构建整个php项目 并开启addtest扩展，我觉得没有必要，所以我们直接走了phpize，下面将会提及

## 2. 更改config.m4 ##

我们将下面的三行前面的dnl去掉

dnl PHP_ARG_WITH(addtest, for addtest support,
    dnl Make sure that the comment is aligned:
    dnl [  --with-addtest             Include addtest support])

改成：

PHP_ARG_WITH(addtest, for addtest support,
    Make sure that the comment is aligned:
    [  --with-addtest             Include addtest support])

然后保存

## 3. 修改addtest.c ##

我们找到函数 addtest

PHP_FUNCTION(addtest)
     {
              int argc = ZEND_NUM_ARGS();
              long a;
              long b;
     
              if (zend_parse_parameters(argc TSRMLS_CC, "ll", &a, &b) == FAILURE)
                      return;
     
              php_error(E_WARNING, "addtest: not yet implemented");
      }

更改为：

PHP_FUNCTION(addtest)
     {
              int argc = ZEND_NUM_ARGS();
              long a;
              long b;
              long sum;
     
              if (zend_parse_parameters(argc TSRMLS_CC, "ll", &a, &b) == FAILURE)
                      return;
     
              sum = a + b;
              RETURN_LONG(sum);
      }

## 4.在当前目录下执行phpize ##

会自动生成configure文件

[root@wjw addtest]# /usr/local/php/bin/phpize
    Configuring for:
    PHP Api Version:         20131106
    Zend Module Api No:      20131226
    Zend Extension Api No:   220131226

## 5. configure生成make文件 ##

[root@wjw addtest]# ./configure --with-php-config=/usr/local/php/bin/php-config

## 6. make  ##

[root@wjw addtest]# make

## 7. make test ##

[root@wjw addtest]# make test

## 8. 将扩展加入指定扩展目录 ##

执行完上面的命令，会在当前目录下生成一个modules文件夹  
会生成 addtest.so 扩展文件  
我们看下，php的配置文件中扩展目录的是哪里

[root@wjw addtest]# /usr/local/php/bin/php -i | grep 'extension_dir'
    extension_dir => /usr/local/php/lib/php/extensions/no-debug-non-zts-20131226 => /usr/local/php/lib/php/extensions/no-debug-non-zts-20131226

然后我们将我们的addtest.so 拷贝到扩展目录下

[root@wjw addtest]# cp ./modules/addtest.so /usr/local/php/lib/php/extensions/no-debug-non-zts-20131226/

修改php.ini 文件，加入扩展

extension=“addtest.so”

然后使用php -r测试一下扩展是否编译完成

[root@wjw addtest]# /usr/local/php/bin/php -r "echo addtest(1,2);"
    3

看到了我们期望的结果3，a+b完成。

有兴趣深入研究的可参看：[http://www.cunmou.com/phpbook/preface.md][http_www.cunmou.com_phpbook_preface.md]

[http_www.cunmou.com_phpbook_preface.md]: http://www.cunmou.com/phpbook/preface.md