从dl('xxx.so');函数分析PHP模块开发
author: selfimpr
blog: http://blog.csdn.net/lgg201
mail: lgg860911@yahoo.com.cn
转载请声明出处.
最近在学习PHP模块开发相关的知识, 再看了dl()函数的流程之后, 对模块加载的处理流程做一个总结, 希望可以在PHP模块开发上帮助到大家.
进入正题.
PHP的代码架构
上图摘自Extending and Embedding PHP(Sams).
从图中可以看出, PHP所有的部分都处在一个被称为TSRM的层中, TSRM层是负责线程安全管理的. 最底下的SAPI是对外提供服务的接口, 比如命令行的sapi为cli, php-fpm则是fastcgi的sapi, apache的模块方式也是一种sapi.
中间是PHP内核和Zend 引擎. 从图中的文字可以看出, PHP内核负责请求管理/网络和文件操作, Zend内核则负责编译和执行/内存和资源的分配.
在所有这些之上, 是扩展层, PHP中多数对外接口都是通过扩展层来提供的, 比如, standard, string等语言基础也被以扩展形式提供.
扩展(以后称为模块)加载到PHP中的方式有两种: 静态编译, 动态链接.
静态编译需要重新生成php的configure脚本, 这里不再赘述. 动态链接方式是将模块编译为一个.so文件, 然后动态的加载到php中.
加载.so文件的方式有两种, 一种是将其写到php.ini文件中, 比如: extension=apc.so, 另外一种就是在代码中使用dl(‘xxx.so’).
dl($library)
函数的作用就是把一个模块加载进来, 使其内部提供的能力可用.
dl()函数的源代码在PHP源代码根目录(简写为PHP_SRC_HOME)下, PHP_SRC_HOME/ext/standard/dl.c, 处理关键流程如下:
PHP_FUNCTION(dl)
PHPAPI PHP_FUNCTION(dl)
{
//...
php_dl(filename, MODULE_TEMPORARY, return_value, 0 TSRMLS_CC);
//...
}
php_dl
PHPAPI void php_dl(char *file, int type, zval *return_value, int start_now TSRMLS_DC)
{
if (php_load_extension(file, type, start_now TSRMLS_CC) == FAILURE) {
//...
}
php_load_extension
PHPAPI int php_load_extension(char *filename, int type, int start_now TSRMLS_DC) {
//文件名解析相关
//加载动态链接库
handle = DL_LOAD(libpath);
//加载错误处理
//获取模块的get_module函数(重点, 模块初始入口)
get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "get_module");
//get_module函数获取错误处理
//那个get_module()得到struct zend_module_entry
module_entry = get_module();
//...
//注册模块(重点, 函数在这里被注册)
if ((module_entry = zend_register_module_ex(module_entry TSRMLS_CC)) == NULL) {
//错误处理
}
//模块启动(重点, PHP_MINIT_FUNCTION)
if ((type == MODULE_TEMPORARY || start_now) && zend_startup_module_ex(module_entry TSRMLS_CC) == FAILURE) {
//错误处理
}
//模块请求启动(重点, PHP_RINIT_FUNCTION)
if ((type == MODULE_TEMPORARY || start_now) && module_entry->request_startup_func) {
//错误处理
}
return SUCCESS;
}
流程中的重点问题
get_module函数
get_module = (zend_module_entry *(*)(void)) DL_FETCH_SYMBOL(handle, "get_module");
这一句代码经过宏扩展之后如下:
get_module = (zend_module_entry *(*)(void)) dlsym(handle, "_get_module");
google一下dlsym()函数是干什么的, 我们很容易理解这一句代码, 这是从刚才加载的动态链接库中获取了一个函数指针, 也就是我们在开发模块的时候定义的get_module函数.
大家可以去看看PHP_SRC_HOME/ext/下的扩展主文件中, 都会有类似你的代码:
#ifdef COMPILE_DL_SAMPLE
ZEND_GET_MODULE(sample)
#endif
经过宏展开为(暂不考虑针对GNU的__attribute__和针对C++的extern “C”):
zend_module_entry *get_module(void) { return &sample_module_entry; }
通过把dl()函数的加载过程和模块开发时的定义联系起来, 我们可以看到, 模块被加载的时候, 我们自定义的zend_module_entry从这里被传递出去.
模块的注册
module_entry = zend_register_module_ex(module_entry TSRMLS_CC)
上面的代码是从函数php_load_extension中摘出的, 我们继续深入zend_register_module_ex()找到我们关注的函数注册:
if (module->functions && zend_register_functions(NULL, module->functions, NULL, module->type TSRMLS_CC)==FAILURE) {
继续深入到zend_register_functions函数中:
ZEND_API int zend_register_functions(zend_class_entry *scope, const zend_function_entry *functions, HashTable *function_table, int type TSRMLS_DC) /* {{{ */ {
//...
//重点 如果没有函数符号表, 取全局函数符号表
if (!target_function_table) {
target_function_table = CG(function_table);
}
//...
//重点 循环zend_function_entry[]
while (ptr->fname) {
//向函数符号表增加函数
if (zend_hash_add(target_function_table, lowercase_name, fname_len+1, &function, sizeof(zend_function), (void**)®_function) == FAILURE) {
//错误处理
}
//...
//准备遍历zend_function_entry[]下一个元素
ptr++;
//...
}
//...
return SUCCESS;
}
在获取函数符号表的时候, 使用了CG宏:
target_function_table = CG(function_table);
我们分两种情况解开这个宏:
//非线程安全
compiler_globals.function_table
//线程安全
(((zend_compiler_globals *) (*((void ***) tsrm_ls))[ compiler_globals_id - 1])-> function_table)
最终, 它们获取的都是一个全局结构struct zend_compiler_globals中的function_table元素, 该元素是一个HashTable.
下面的循环就很好理解了, 把模块开发时zend_function_entry中的函数遍历增加到HashTable中就OK了.
模块启动/模块请求启动
这两个部分是很容易理解的, 分别对应的是模块开发中的PHP_MINIT_FUNCTION()和PHP_RINIT_FUNCTION()
一个最简单的模块
在介绍了上面的内容后, 开发一个PHP模块的思路应该会清晰很多.
我们假设模块的名称为”sample”, 有一个头文件和一个源文件, 首先是头文件:
#ifndef PHP_SAMPLE_H
/* 预防多次包含 */
#define PHP_SAMPLE_H
/* 定义扩展属性 */
#define PHP_SAMPLE_EXTNAME "sample"
#define PHP_SAMPLE_EXTVER "1.0"
/* 引入源文件外部的配置选项 */
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
/* 包含PHP标准头文件 */
#include "php.h"
/* 定义入口指针符号, Zend在加载的时候使用它 */
extern zend_module_entry sample_module_entry;
extern zend_function_entry sample_functions[];
#define phpext_sample_ptr &sample_module_entry
/* 定义函数 */
PHP_FUNCTION(sample_hello_world);
#endif /* PHP_SAMPLE_H */
接下来是源文件:
#include "php_sample.h"
zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
STANDARD_MODULE_HEADER,
#endif
PHP_SAMPLE_EXTNAME,
sample_functions, /* Functions */
/* 本例没有实现这些方法,不过实现和普通方法基本一致 */
NULL, /* MINIT */
NULL, /* MSHUTDOWN */
NULL, /* RINIT */
NULL, /* RSHUTDOWN */
NULL, /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901
PHP_SAMPLE_EXTVER,
#endif
STANDARD_MODULE_PROPERTIES
};
#ifdef COMPILE_DL_SAMPLE
ZEND_GET_MODULE(sample)
#endif
/* 函数入口 */
zend_function_entry sample_functions[] = {
PHP_FE(sample_hello_world, NULL)
{NULL, NULL, NULL}
};
/* ------------------- 函数定义 -----------------------*/
PHP_FUNCTION(sample_hello_world)
{
php_printf("Hello world!\n");
}
完
Over了, 给大家推荐一本书<Sams Extending and Embedding PHP>.
分享到:
相关推荐
DL 5009.2-2013 电力建设安全工作规程 第2部分电力线路.rar
对位图进行转换,可以进行透明色设置.增加实现PNG图片转换功能。-The bitmap conversion, you can set the transparent color
加到LD_LIBRARY_PATH里解决import tkinter的问题,结合https://download.csdn.net/download/guotong1988/10450823 使用
IEC60870_5_101规约,DL634.5.101-2002远动协议南方电网实施细则
DL 5190.4-2012 电力建设施工技术规范 第4部分:热工仪表及控制装置
迅雷迷你Minithunder_dl1.5.3.288
IEC60870_5_104规约,DL634.5.104-2002远动协议南方电网实施细则
目录: 变电站通信网络和系统标准: DL/T 860.1,DL/T 860.2 ,DL/T 860.3,DL/T 860.4,DL/T 860.5,DL/T 860.6 ,DL/T 860.71 ,DL/T 860.72,DL/T 860.73,DL/T 860.74,DL/T 860.81,DL/T 860.91,DL/T 860.92,DL/T 860.10
com.sy.dldl.meta.db
基于51单片机,国家电网DL/T645-2007规约解析与打包相关函数
DL.CODE 1.5.2安装包Datalogic DL.CODE software is a revolutionary step in developing the best-in-class 2D imager family with the release of the new Matrix N imagers family powered by DL.CODE. ...
错误:ImportError: libcublas.so.9.0: cannot open shared object file: No such file or directory cudnn-9.0-linux-x64-v7.1
开发..
DL698.42 集中器下行协议0805.doc
DL.CODE 安装调试手册(修正) .pdf
php 把普通下载链接转换成迅雷下载、快车下载 php 把迅雷、快车下载链接转换成普通下载链接
DATALOGIC 得利捷 DL.CODE 操作手册 DATALOGIC固定式软件之DL.CODE操作手册
迅雷官方早已经抛弃的软件,界面简洁,功能强大
DL.CODE软件使用说明
DL/T 698《电能信息采集与管理系统》是对DL/T 698-1999《低压电力用户集中抄表系统技术条件》的修订,标准分为4部分,共9篇: DL/T 698.1-XXXX 电能信息采集与管理系统 第1部分 总则; DL/T 698.2-XXXX 电能信息采集...