首页 / PHP / [翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接

[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接

内容导读

互联网集市收集整理的这篇技术教程文章主要介绍了[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含8950字，纯文字阅读大概需要13分钟。

内容图文

配置和链接

所有前面示例中的代码, 都是你曾经在php用户空间编写过代码的C语言的独立版本. 如果你做的项目需要和php扩展进行粘合, 那么你就至少需要链接一个外部库.

autoconf

在一个简单的应用中, 你可能已经在你的Makefile中增加了下面这样的CFLAGS和LDFLAGS.

CFLAGS = ${CFLAGS} -I/usr/local/foobar/include
LDFLAGS = ${LDFLAGS} -lfoobar -L/usr/local/foobar/lib

想要构建你的应用却没有libfoobar的人, 或将libfoobar安装到其他位置的人, 将会得到一个处理过的错误消息, 用于帮助他找到错误原因.

在过去十年开发的多数开发源代码软件(OSS)以及PHP都利用了一个实用工具autoconf, 通过一些简单的宏来生成复杂的configure脚本. 这个产生的脚本会执行查找依赖库已经头文件是否安装的工作. 基于这些信息, 一个包可以自定义构建代码行, 或在编译的时间被浪费之前提供一个有意义的错误消息.

在构建php扩展时, 无论你是否计划公开发布, 都需要利用这个autoconf机制. 即便你对autoconf已经很熟悉了, 也请花几分钟时间阅读本章, php中引入了一些一般安装的autoconf没有的自定义宏.

和传统的autoconf步骤(集中的configure.in文件包含了包的所有配置宏)不同, php只是用configure.in管理许多位域源码树下小的config.m4脚本的协调, 包括各个扩展, SAPI, 核心自身, 以及ZendEngine.

你已经在前面的章节看到了一个简单版本的config.m4. 接下来, 我们将在这个文件中增加其他的autoconf语法, 让你的扩展可以收集到更多的配置时信息.

库的查找

config.m4脚本最多是用于检查依赖库是否已安装. 扩展比如mysql, ldap, gmp以及其他设计为php用户空间和c库实现的其他功能之间的粘合层的扩展. 如果它们的依赖库没有安装, 或者安装的版本太旧, 要么会编译错误, 要么会导致产生的二进制无法运行.

头文件扫描

对依赖库扫描中最简单的一步就是检查你的脚本中的包含文件, 它们将在链接时使用. 下面的代码尝试在一些常见位置查找zlib.h:

PHP_ARG_WITH(zlib,[for zlib Support]
[  with-zlib              Include ZLIB Support])

if test "$PHP_ZLIB" != "no"; then
  for i in /usr /usr/local /opt; do
    if test -f $i/include/zlib/zlib.h; then
      ZLIB_DIR=$i
    fi
  done

  if test -z "$ZLIB_DIR"; then
    AC_MSG_ERROR([zlib not installed (http://www.gxlcms.com/)])
  fi

  PHP_ADD_LIBRARY_WITH_PATH(z,$ZLIB_DIR/lib, ZLIB_SHARED_LIBADD)
  PHP_ADD_INCLUDE($ZLIB_DIR/include)

  AC_MSG_RESULT([found in $ZLIB_DIR])
  AC_DEFINE(HAVE_ZLIB,1,[libz found and included])

  PHP_NEW_EXTENSION(zlib, zlib.c, $ext_shared)
  PHP_SUBST(ZLIB_SHARED_LIBADD)
fi

config.m4文件很明显比你迄今为止使用的要大. 幸运的是, 它的语法非常的简单易懂并且如果你熟悉bash脚本, 对它也就不会陌生.

文件和第5章"你的第一个扩展"中第一次出现的一样, 都是以PHP_ARG_WITH()宏开始. 这个宏的行为和你用过的PHP_ARG_ENABLE()宏一样, 不过它将导致./configure时的选项是--with-extname/--without-extname而不再是--enable-extname/--disable-extname.

回顾这些宏, 它们的功能是等同的, 不同仅在于是否让终端用户给你的包一些暗示. 你可以在自己创建的私有扩展上使用任意一种方式. 不过, 如果你计划公开发布, 那就应该知道php正式的编码标准, 它指出enable/disable用于哪些不需要链接外部库的扩展, with/without则反之.

由于我们这里假设的扩展将链接zlib库, 因此你的config.m4脚本要以查找扩展源代码中将包含的zlib.h头文件. 这通过检查一些标准位置/usr, /usr/local, /opt中include/zlib目录下的zlib.h完成对其下两个目录的定位.

如果找到了zlib.h, 则将基路径设置到临时变量ZLIB_DIR中. 一旦循环完成, config.m4脚本检查ZLIB_DIR是否包含内容来确定是否找到了zlib.h. 如果没有找到, 则产生一个有意义的错误让用户知道./configure不能继续.

此刻, 脚本假设头文件存在, 对应的库也必须存在, 因此在下面的两行使用它修改构建环境, 最终增加-lz -L$ZLIB_DIR/lib到LDFLAGS以及-I$ZLIB_DIR/include到CFLAGS.

最终, 输出一个确认消息指示zlib安装已经找到, 并且在编译期间使用它的路径. config.m4的其他部分从前面部分的学习中你应该已经熟悉了. 为config.h定义一个#define, 定义扩展并指定它的源代码文件, 同时标识一个变量完成将扩展附加到构建系统的工作.

功能测试

迄今为止, 这个config.m4示例指示查找了需要的头文件. 尽管这已经够用了, 但它仍然不能确保产生的二进制正确的进行链接, 因为可能不存在匹配的库文件, 或者版本不正确.

最简单的检查zlib.h对应的libz.so库文件是否存在的方式就是检查文件是否存在:

if ! test -f $ZLIB_DIR/lib/libz.so; then
  AC_MSG_ERROR([zlib.h found, but libz.so not present!])
fi

当然, 这仅仅是问题的一面. 如果安装了其他的同名库但和你要查找的库不兼容怎么办呢? 确保你的扩展可以成功编译的最好方式是测试找到的库实际编译所需的内容. 要这样做就需要在config.m4中PHP_ADD_LIBRARY_WITH_PATH调用之前加入下面代码:

PHP_CHECK_LIBRARY(z, deflateInit,,[
  AC_MSG_ERROR([Invalid zlib extension, gzInit() not found])
],-L$ZLIB_DIR/lib)

这个工具宏将展开输出一个完整的程序, ./configure将尝试编译它. 如果编译成功, 表示第二个参数定义的符号在第一个参数指定的库中存在. 成功后, 第三个参数中指定的autoconf脚本将会执行; 失败后, 第四个参数中指定的autoconf脚本将执行. 在这个例子中, 第三个参数为空, 因为没有消息就是最好的消息(译注: 应该是unix哲学之一), 第五个参数也就是左后一个参数, 用于指定额外的编译器和链接器标记, 这里, 使用-L致命了一个额外的用于查找库的路径.

可选功能

那么现在你已经有正确的库和头文件了, 但依赖的是所安装库的哪个版本呢? 你可能需要某些功能或排斥某些功能. 由于这种类型的变更通常涉及到某些特定入口点的增加或删除, 因此可以重用PHP_CHECK_LIBRARY()宏来检查库的某些能力.

PHP_CHECK_LIBRARY(z, gzgets,[
  AC_DEFINE(HAVE_ZLIB_GETS,1,[Having gzgets indicates zlib >= 1.0.9])
],[
  AC_MSG_WARN([zlib < 1.0.9 installed, gzgets() will not be available])
],-L$ZLIB_DIR/lib)

测试实际行为

可能知道某个符号存在也还不能确保你的代码正确编译; 某些库的特定版本可能存在bug需要运行一些测试代码进行检查.

AC_TRY_RUN()宏可以编译一个小的源代码文件为可执行程序并执行. 依赖于传回给./configure的返回代码, 你的脚本可以设置可选的#define语句或直接输出消息(比如如果bug导致不能工作则提示升级)安全退出. 考虑下面的代码(摘自ext/standard/config.m4):

AC_TRY_RUN([
#include <math.h>

double somefn(double n) {
  return floor(n*pow(10,2) + 0.5);
}
int main() {
  return somefn(0.045)/10.0 != 0.5;
}
],[
  PHP_ROUND_FUZZ=0.5
  AC_MSG_RESULT(yes)
],[
  PHP_ROUND_FUZZ=0.50000000001
  AC_MSG_RESULT(no)
],[
  PHP_ROUND_FUZZ=0.50000000001
  AC_MSG_RESULT(cross compile)
])
AC_DEFINE_UNQUOTED(PHP_ROUND_FUZZ, $PHP_ROUND_FUZZ,
                    [Is double precision imprecise?])

你可以看到, AC_TRY_RUN()的第一个参数是一块C语言代码, 它将被编译执行. 如果这段代码的退出代码是0, 位于第二个参数的autoconf脚本将被执行, 这种情况标识round()函数和期望一样工作, 返回0.5.

如果代码块返回非0值, 位域第三个参数的autoconf脚本将被执行. 第四个参数(最后一个)在php交叉编译时使用. 这种情况下, 尝试运行示例代码是没有意义的, 因为目标平台不同于扩展编译时使用的平台.

强制模块依赖

在php 5.1中, 扩展之间的内部依赖是可以强制性的. 由于扩展可以静态构建到php中, 也可以构建为共享对象动态加载, 因此强制依赖需要在两个地方实现.

配置时模块依赖

第一个位置是你在本章课程中刚刚看到的config.m4文件中. 你可以使用PHP_ADD_EXTENSION_DEP(extname, depname[ , optional])宏标识extname这个扩展依赖于depname这个扩展. 当extname以静态方式构建到php中时, ./configure脚本将使用这一行代码确认depname必须首先初始化. optional参数是一个标记, 用来标识depname如果也是静态构建的, 应该在extname之前加载, 不过它并不是必须的依赖.

这个宏的一个使用示例是pdo驱动, 比如pdo_mysql是可预知依赖于pdo扩展的:

ifdef([PHP_ADD_EXTENDION_DEP],
[
  PHP_ADD_EXTENSION_DEP(pdo_mysql, pdo)
])

要注意PHP_ADD_EXTENSION_DEP()宏被包裹到一个ifdef()结构中. 这是因为pdo和它的驱动在编译大于或等于5.0版本的php时都是存在的, 然而PHP_ADD_EXTENSION_DEP()宏是直到5.1.0版本才出现的.

运行时模块依赖

另外一个你需要注册依赖的地方是zend_module_entry结构体中. 考虑下面第5章中你定义的zend_module_entry结构体:

zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
    STANDARD_MODULE_HEADER,
#endif
    PHP_SAMPLE_EXTNAME,
    php_sample_functions,
    NULL, /* MINIT */
    NULL, /* MSHUTDOWN */
    NULL, /* RINIT */
    NULL, /* RSHUTDOWN */
    NULL, /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901
    PHP_SAMPLE_EXTVER,
#endif
    STANDARD_MODULE_PROPERTIES
};

增加运行时模块依赖信息就需要对STANDARD_MOUDLE_HEADER部分进行一些小修改:

zend_module_entry sample_module_entry = {
#if ZEND_MODULE_API_NO >= 220050617
    STANDARD_MODULE_HEADER_EX, NULL,
    php_sample_deps,
#elif ZEND_MODULE_API_NO >= 20010901
    STANDARD_MODULE_HEADER,
#endif
    PHP_SAMPLE_EXTNAME,
    php_sample_functions,

    NULL, /* MINIT */
    NULL, /* MSHUTDOWN */
    NULL, /* RINIT */
    NULL, /* RSHUTDOWN */
    NULL, /* MINFO */
#if ZEND_MODULE_API_NO >= 20010901
    PHP_SAMPLE_EXTVER,
#endif
    STANDARD_MODULE_PROPERTIES
};

现在, 如果ZEND_MODULE_API_NO高于php 5.1.0 beta发布版, 则STANDARD_MODULE_HEADER(译注: 这里原著笔误为STANDARD_MODULE_PROPERTIES)将被替换为略微复杂的结构, 它将包含一个指向模块依赖信息的引用.

这个目标结构体可以在你的zend_module_entry结构体上面定义如下:

#if ZEND_MODULE_API_NO >= 220050617
static zend_module_dep php_sample_deps[] = {
    ZEND_MODULE_REQUIRED("zlib")
    {NULL,NULL,NULL}
};
#endif

和zend_function_entry向量类似, 这个列表可以有多项依赖, 按照顺序进行检查. 如果尝试加载某个依赖模块未满足, Zend将会中断加载, 报告不满足依赖的名字, 这样, 终端用户就可以通过首先加载其他模块来解决问题.

Windows方言

由于译者对windows环境不熟悉, 因此略过本节.

小结

如果你的扩展将在未知或不可控制的环境构建, 让它足够聪明以应付奇怪的环境就非常重要. 使用php提供的unix和windows上强有力的脚本能力, 你应该可以检测到麻烦并在未知的管理员需要电话求助之前给于她一个解决方案.

现在你已经有使用php api从头建立php扩展的基础能力了, 你可以准备学习一下使用php提供的扩展开发工具把自己从繁重的重复劳动中解放出来了, 使用它们可以快速, 准确的建立新扩展的原型.

以上就是[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接的内容，更多相关内容请关注PHP中文网（www.gxlcms.com）！

内容总结

以上是互联网集市为您收集整理的[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接全部内容，希望文章能够帮你解决[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接所遇到的程序开发问题。如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。

内容备注

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。

内容手机端

扫描二维码推送至手机访问。

本文链接：https://qyyshop.com/info/147046.html

来源：【匿名】

【上一篇】PHP中的使用curl发送请求（GET请求和POST请求）【下一篇】PHP 5 数据对象 (PDO) 抽象层与 Oracle

更多 ►

【[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接】教程文章相关的互联网学习教程文章

php 扩展之oci8在ThinkPHP上的应用【代码】

最近突然想到了oci_8的拓展，PHP的一个拓展，有很多函数，翻了翻手册，看了看ThinkPHP的DB以及DBOracle的驱动文件这才想明白其中的oci_connect和oci_pconnect以及oci_new_connect的来源代码如下/** * 连接数据库方法 * @access public */ public function connect($config=‘‘,$linkNum=0) { if ( !isset($this->linkID[$linkNum]) ) { if(empty($config)) $config = $this->config; ...

ubuntu通过apt-get方式搭建lnmp环境以及php扩展安装【代码】

v 一直是在用的lnmp的集成安装包搭建lnmp环境，因为工作需要需要安装ldap扩展，在网上怎么都找不到源码安装包，只能卸载掉原来的lnmp环境，用ubuntu的php5-ldap扩展，在安装中遇到一些问题，网上的文章坑爹的比较多，写篇文章记录下来。 1.安装MySQL [sql] view plain copy sudo apt-get install mysql-server mysql-client 安装过程中要输入root用户的密码。我在安装中出错，是原来的mysql-cilent mysql-workbench 未...

php扩展开发笔记（2）多个源码文件的配置和编译【代码】

我们在开发过程中，为了代码得可读性和易维护性，肯定是需要多个代码文件的，而不仅仅是通过 ext_skel 生成得骨架文件。这篇文章主要介绍下，多个代码文件的时候，我们需要注意什么，以及怎么做。我的代码文件如下（slash为我的扩展名）// ext_skel 生成默认得模块相关的主要文件 php_slash.h // 头文件 slash.c // 源码文件 config.m4 // 编译的时候需要修改的文件在这个默认生成的骨架文件里面，我们只要执行下面几步，就可以完成...

Ubuntu 安装 RabbitMQ 和PHP扩展 - CSDN博客

1.ubuntu16.04中安装RabbitMQ1).首先必须要有Erlang环境支持安装之前要装一些必要的库:sudo apt-get install build-essential sudo apt-get install libncurses5-dev sudo apt-get install libssl-dev sudo apt-get install m4 sudo apt-get install unixodbc unixodbc-dev sudo apt-get install freeglut3-dev libwxgtk2.8-dev sudo apt-get install tk8.5安装好之后运行:sudo apt-get install erlang完成后在控制台输入命令...

PHP5.3以上版本使用pthreads PHP扩展真正支持多线程

class test_thread_run extends Thread{public $url;public $data;public function __construct($url){$this->url = $url;}public function run(){if(($url = $this->url)){$this->data = model_http_curl_get($url);}}}function model_thread_result_get($urls_array){foreach ($urls_array as $key => $value){$thread_array[$key] = new test_thread_run($value["url"]);$thread_array[$key]->start();}foreach ($thread_array ...

Centos中编辑php扩展库

今天需要在Centos中编译Exif库以便获取图片的exif信息，可在Linux中从来没有编译过扩展库呀，只好查资料了。发现是用phpize这个东东来编译扩展.首先执行了下 php -i | grep config 看了下编译php的时候没有加上exif扩展。那么第一步，当然是进入源码目录里面的Exif目录下面。然后再找到phpize的路径，phpize这个一般是安装完php后的目录下面的cd /alidata/server/php-5.4/ext/exif/alidata/server/php/bin/phpize ./configure --wi...

在Linux下编辑php扩展【代码】

以下内容是本人学习过程中的笔记或者心得,如果有什么建议或者意见请在评论中提醒我,谢谢,这篇文章我会定期更新，由浅到深的分享我学PHP扩展历程或者在学习中有什么问题欢迎交流 1.去PHP官网下载一个源码包，然后解压到某个目录2.进入源码目录中的ext目录中3.执行./ext_skel --extname=myext(这是扩展的名字) 生成扩展框架 [ps:如果ext_skel无法执行,请查看ext_skel文件是否有可执行权限]4.编写扩展函数　　a).我们打开myext.c文件,...

windows安装redis开启php扩展【图】

windows下安装 redis并开机自启动1，redis官方下载地址：https://redis.io/download，redis 64位下载地址：https://github.com/ServiceStack/redis-windows，本人测试使用的是redis-64.3.0.503版本。2，解压redis-64.3.0.503.zip，解压后的文件结构如下：第二步：就是运行redis 命令如下：redis-server.exe redis.windows.conf此时显示安装成功了测试，成功安装： 3.将redis加入到windows的服务中（service和loglevel前都是两个-）...

PHP扩展开发及内核应用

目录中汉字部分代表已经翻译完成的章节，带链接的表示已经发布的，未待链接的表示正在校正即将发布的。PHP的生命周期让我们从SAPI开始PHP的启动与终止PHP的生命周期线程安全小结PHP变量在内核中的实现变量的类型变量的值创建PHP变量变量的存储方式变量的检索类型转换小结内存管理内存管理引用计数总结配置编译环境编译前的准备PHP编译前的config配置Unix/Linux平台下的编译在Win32平台上编译PHP小结第一个扩展一个扩展的基本结构编...

fastdfs(文件服务器)安装教程及php扩展安装

在安装fastdfs之前已经安装了lnmp集成包，所以直接安装fastdfs，之后再安装fastdfs_nginx_model（nginx的扩展）准备工作：下载fastdif安装包到 /home/soft 目录，下载地址：http://pan.baidu.com/s/1jH59oO21、安装fastdfs# cd /home/softs/fastdfs# tar xzf FastDFS_v4.06.tar.gz# cd FastDFS# vi make.sh 去掉注释WITH_LINUX_SERVICE=1 # ./make.sh# ./make.sh install 2 配置tracker2.1 创建与配置tracker数据目录# mkdir -p ...

php扩展库说明

1 zlib是提供数据压缩用的函式库，2 libxml2Libxml2 is the XML C parser and toolkit developed for the Gnome project (but usable outside of the Gnome platform), it is free software available under the MIT License.3 pcre PCRE(Perl Compatible Regular Expressions)是一个Perl库，包括 perl 兼容的正则表达式库。4 opensslOpenSSL 是一个强大的安全套接字层密码库，囊括主要的密码算法、常用的密钥和证书封装管理功能及...

在 OSX 10.9.4 上编译安装 FastDFS 及其 PHP 扩展【代码】【图】

经我测试，在OSX 10.9.4上安装FastDFS V5.01的话会很悲剧，一开始就无法安装，会遇到这帖子中的问题：http://www.oschina.net/question/252582_162768 而我还死活解决不了，貌OSX上就没有ldconfig这个东东，反正我也不懂Linux和UNIX这类的系统。于是只好退而求其次，安个老版本来用，毕竟我只是为了装FastDFS的PHP扩展，以便在Mac上开发PHP项目，而真正的FastDFS模拟服务器环境是在另一台联想Win7上的虚拟机中的CentOS6.5上。安装F...

基于PHP扩展一种处理Emoji方法的类库介绍【Carmela】【代码】

Carmela介绍Carmela提供基于PHP，PHP扩展，JAVA，C++等语言的一套处理4四节UTF-8解决方案，比如常见Emoji标签支持背景：UTF-8格式含有Emoji表情字符串直接插入数据库，如果数据库未做调整会提示报错，通过更改数据库和表的字符集为utf8mb4_general_ci，可以避免这种问题。但是，在很多大型系统和架构中，修改数据库的字符集可能会引发很多的问题，比如PC端展示，新老数据兼容问题。针对这类问题，还有另外一种解决方案，入库前替换...

PHP扩展CURL的用法详解【代码】

实现的功能：1、实现远程获取和采集内容2、实现PHP 网页版的FTP上传下载3、实现模拟登陆：去一个邮件系统，curl可以模拟cookies4、实现接口对接（API），数据传输等：通过一个平台发送短信啊，抓取和传递所传输的信息。5、实现模拟Cookie等：登陆的状态下才可以操作一些属性。如何使用CURL功能：默认情况加PHP是不支持CURL的，需要在php.ini中开启该功能;extension=php_curl.dll前面的分号去掉1 整个操作过程中第一步是用cur_init...

Layman 使用ffmpeg-php扩展库实现视频截图（默认图）【代码】

这几天做项目，其中一个需求是用户上传视频文件到服务器，然后服务器自动截取该视频的一帧作为该视频对应的缩略图，服务器端语言采用php编写，找了半天资料，发现ffmpeg-php可以满足该需求，所以下面简单介绍一下该扩展库的配置和使用方法。测试服务器环境 WampServer Version 2.1，php5.3.5，ffmpeg-php 配置和使用步骤如下：1. 下载 ffmpeg-php, ffmpeg-php-5.3-win32-all.zip2. 将 php_ffmpeg.dll 放到 PHP 扩展目录，（例如 E:...

首页 / PHP / [翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接

[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接

内容导读

内容图文

内容总结

内容备注

内容手机端

【[翻译][php扩展开发和嵌入式]第17章-php源代码的配置和链接】教程文章相关的互联网学习教程文章

php 扩展之oci8在ThinkPHP上的应用【代码】

ubuntu通过apt-get方式搭建lnmp环境以及php扩展安装【代码】

php扩展开发笔记（2）多个源码文件的配置和编译【代码】

Ubuntu 安装 RabbitMQ 和PHP扩展 - CSDN博客

PHP5.3以上版本使用pthreads PHP扩展真正支持多线程

Centos中编辑php扩展库

在Linux下编辑php扩展【代码】

windows安装redis开启php扩展【图】

PHP扩展开发及内核应用

fastdfs(文件服务器)安装教程及php扩展安装

php扩展库说明

在 OSX 10.9.4 上编译安装 FastDFS 及其 PHP 扩展【代码】【图】

基于PHP扩展一种处理Emoji方法的类库介绍【Carmela】【代码】

PHP扩展CURL的用法详解【代码】

Layman 使用ffmpeg-php扩展库实现视频截图（默认图）【代码】

PHP - 相关标签

嵌入式 - 相关标签

源代码 - 相关标签

PHP - 技术教程分类

PHP - 最新教程

PHP - 最热教程