PHP扩展开发系列01 - 我要成为一名老司机

1. 关于扩展的教程貌似挺全了，为啥还写？

1. 记录下我写扩展的历程

2. 自认为会写的更容易理解

3. 我的宗旨就是 "先用再识" 代码写着写着就知道原理了 或者说边写边学， 边学边写

2. 那么你首先要具备哪些预备知识？ 答：你需要先过科目一

1. C 为啥放第一位？

2. PHP 不会？那写什么PHP扩展？

3. PHP的编译安装

4. phpize 和 php-config 这个靠你们自己去了解了

5. 关于PHP编译 前期非必须，但是要知道的 (no-debug, non-zts, debug, zts)

6. 问？搜？ -- 有时候不一定要问或者搜才能找到解决的答案。

7. 找！ --- 找出别人扩展真么写的 (php-src/ext)。不但有答案，还有思想。

至于 PHP ZEND 原理啥的, 很重要, 很重要, 很重要, 但是这里暂时放一边，没事可以去了解了解。

3. 先看看刚上车的司机是什么样的？ (示例代码) 最后有注释版的

代码说明

1. 这是一个很简单的扩展， 简单到没有功能

2. 扩展名称 laosiji

3. 目前看来 这只是一个只会装B(啥都不会)的司机

4. 三个文件

5. config.m4

6. php_laosiji.h

7. laosiji.c

config.m4

PHP_ARG_ENABLE(laosiji, whether to enable laosiji support,[  --enable-laosiji           Enable laosiji support]
)if test "$PHP_LAOSIJI" != "no"; thenPHP_NEW_EXTENSION(laosiji, laosiji.c, $ext_shared)
fi

php_laosiji.h

#define PHP_LAOSIJI_EXTNAME "laosiji"
#define PHP_LAOSIJI_VERSION "1.0.0"// 加载config.h，如果配置了的话
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif// 加载php头文件
#include "php.h"

laosiji.c

#include "php_laosiji.h"// module entry
zend_module_entry laosiji_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901STANDARD_MODULE_HEADER,
#endifPHP_LAOSIJI_EXTNAME, /* 扩展名称 */NULL,                /* Functions */NULL,                /* MINIT */NULL,                /* MSHUTDOWN */NULL,                /* RINIT */NULL,                /* RSHUTDOWN */NULL,                /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901PHP_LAOSIJI_VERSION, /* 扩展版本 */
#endifSTANDARD_MODULE_PROPERTIES};#ifdef COMPILE_DL_LAOSIJI
ZEND_GET_MODULE(laosiji)
#endif

5. 作为司机的一本基本开车动作 (扩展的编译安装等)

1. phpize

2. ./configure 这里要注意下 php-config

3. make

4. make install

5. 加载 .so 扩展文件

6. 点火启动 试试我们的扩展

<?php
var_dump(extension_loaded('laosiji'));// 自己去了解下 dl 函数
// @ 只是为了不出现那烦人的 提示
// 为了避免不必要的麻烦 建议在 php.ini 加载 扩展
@dl('laosiji.so');var_dump(extension_loaded('laosiji'));

7. 小节

差不多就到这里了。这次主要说了下写PHP扩展要准备的一些基本知识。当然有些人可能对上面提到部分概念没深入了解。
比如 PHP不同编译方式(debug, nts..)<这个你看别的扩展源码的时候就会注意到>、phpize、php-config 具体作用。
phpize、php-config 一定要注意，这里提醒你这回遇到坑。

后面再来慢慢学习老司机的各种姿势。包括，函数，函数参数，函数返回值，对象，类，命名空间等等等。

8. 注释版代码

config.m4

dnl dnl 开头的语句 属于注释内容dnl PHP_ARG_ENABLE 函数有三个参数
dnl 第一个参数 laosiji 扩展名称 (不用加引号)
dnl 第二个参数 运行 ./configure 脚本时显示的内容
dnl 第三个参数 调用 ./configure --help 显示的帮助信息dnl 最后去了接下 PHP_ARG_WITH 这里就先不提了PHP_ARG_ENABLE(laosiji, whether to enable laosiji support,[  --enable-laosiji           Enable laosiji support]
)if test "$PHP_LAOSIJI" != "no"; thendnl PHP_NEW_EXTENSION 函数声明 扩展的名称、需要的源文件名、扩展的编译形式dnl 第一个参数 扩展的名称dnl 第 2 。。 n-1 个参数  需要的源文件名dnl 最后的$ext_shared参数用来声明这个扩展不是一个静态模块，而是在php运行时动态加载的。dnl 如果我们的扩展使用了多个文件，便可以将这多个文件名罗列在函数的参数里，如：dnl PHP_NEW_EXTENSION(laosiji, laosiji.c, laosiji_2.c, laosiji_3.c, $ext_shared)PHP_NEW_EXTENSION(laosiji, laosiji.c, $ext_shared)
fi

php_laosiji.h

// 定义 扩展相关的宏 比如版本号 扩展名称等等。。
#define PHP_LAOSIJI_EXTNAME "laosiji"
#define PHP_LAOSIJI_VERSION "1.0.0"// 加载config.h，如果配置了的话
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif// 加载php头文件
// 这个 很有必要哈
#include "php.h"

laosiji.c

#include "php_laosiji.h"// module entry
// 1. laosiji_module_entry  扩展名称_module_entry
// 2. PHP_LAOSIJI_EXTNAME   /* 扩展名称 */
// 3. PHP_LAOSIJI_VERSION, /* 扩展版本 */
// 那些 NULL ？
// 第一个你要记住 /* Functions */ 这行 想想 php 中的函数
// 第二个你要记住 /* MINIT */ 想想 class && object
// 第三个你要记住 MINIT MSHUTDOWN RINIT RSHUTDOWN MINFO 慢慢来 不着急zend_module_entry laosiji_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901STANDARD_MODULE_HEADER,
#endifPHP_LAOSIJI_EXTNAME, /* 扩展名称 */NULL,                /* Functions */NULL,                /* MINIT */NULL,                /* MSHUTDOWN */NULL,                /* RINIT */NULL,                /* RSHUTDOWN */NULL,                /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901PHP_LAOSIJI_VERSION, /* 扩展版本 */
#endifSTANDARD_MODULE_PROPERTIES};#ifdef COMPILE_DL_LAOSIJI
ZEND_GET_MODULE(laosiji)
#endif

参考

简单扩展 https://github.com/imlaosiji/...