如何编写一个独立的 PHP 扩展

澳门新葡亰娱乐在线 1

独立的 PHP 扩展可以独立于 PHP
源码之外进行分发。要创建一个这样的扩展,需要准备好两样东西:

澳门新葡亰娱乐在线 1

  • 配置文件 (config.m4)
  • 你的模块源码

image.png

接下来我们来描述一下如果创建这些文件并组合起来。

前面章节我会先简要说明一下安装过程,
后面章节我会记录在安装期间踩过的坑.
Linux 下编译软件的步骤参见Linux
编译软件的步骤

准备好系统工具

想要扩展能够在系统上编译并成功运行,需要准备转以下工具:

  • GNU autoconf
  • GNU automake
  • GNU libtool
  • GNU m4

以上这些都可以从 获取。

注:以上这些都是类 Unix 环境下才能使用的工具。


改装一个已经存在的扩展

为了显示出创建一个独立的扩展是很容易的事情,我们先将一个已经内嵌到 PHP
的扩展改成独立扩展。安装 PHP 并且执行以下命令:

$ mkdir /tmp/newext
$ cd /tmp/newext

现在你已经有了一个空目录。我们将 mysql 扩展目录下的文件复制过来:

$ cp -rp php-4.0.X/ext/mysql/* .
# 注:看来这篇 README 真的需要更新一下了
# PHP7 中已经移除了 mysql 扩展部分

到这里扩展就完成了,执行:

$ phpize

现在你可以独立存放这个目录下的文件到任何地方,这个扩展可以完全独立存在了。

用户在编译时需要使用以下命令:

$ ./configure 
       [--with-php-config=/path/to/php-config] 
       [--with-mysql=MYSQL-DIR]
$ make install

这样 MySQL 模块就可以使用内嵌的 MySQL 客户端库或者已安装的位于 MySQL
目录中的 MySQL。

注:意思是说想要编写 PHP 扩展,你既需要已经安装了 PHP,也需要下载一份
PHP 源码。

服务器环境

  • CentOS 7
  • PHP 7.0.20
  • Nginx 1.10.1

定义一个新扩展

我们给示例扩展命名为 “foobar”。

新扩展包含两个资源文件:foo.c 和
bar.c(还有一些头文件,但这些不只重要)。

示例扩展不引用任何外部的库(这点很重要,因为这样用户就不需要特别指定一些编译选项了)。

LTLIBRARY_SOURCES
选项用于指定资源文件的名字,你可以有任意数量的资源文件。

注:上面说的是 Makefile.in 文件中的配置选项,可以参考
xdebug。

安装 PHP 扩展的通用流程

  • 1.下载解压

cd /usr/local/src #一般把第三方软件的源码放在这个目录
wget http://xxx.com/
#软件源码下载地址
tar -zxvf 压缩包 #解压缩. 根据不同类型的压缩包,使用不同的解压缩命令,
比如 “.gz 压缩包”使用 -zx , “.bz 压缩包”使用 -jx
“`

  • 2.编译安装

cd /解压缩后/的文件夹
/usr/local/bin/phpize #用 phpize 命令生成 configure 配置文件
./configure –with-php-config=/usr/local/php/bin/php-config #配置
make #编译
sudo make install #安装
“`

  • 3.修改 php.ini

    在 php.ini 中添加:

extension=名称.so # “名称”为扩展的名称. 或者可以用重定向的命令修改
php.ini sudo echo extension=名称.so >> /etc/php.ini
“`

  • 4.重启服务

php -m | grep 扩展名称 #验证是否正确安装上了扩展
sudo systemctl reload php-fpm nginx #systemctl 是 CentOS 7 的命令
“`


修改 m4 后缀的配置文件

m4
配置文件可以指定一些额外的检查。对于一个独立扩展来说,你只需要做一些宏调用即可。

PHP_ARG_ENABLE(foobar,whether to enable foobar,
[  --enable-foobar            Enable foobar])

if test "$PHP_FOOBAR" != "no"; then
  PHP_NEW_EXTENSION(foobar, foo.c bar.c, $ext_shared)
fi

PHP_ARG_ENABLE 会自动设置好正确的变量以保证扩展能够被
PHP_NEW_EXTENSION 以共享模式启动。

PHP_NEW_EXTENSION
的第一个参数是扩展的名称,第二个参数是资源文件。第三个参数 $ext_shared
是由 PHP_ARG_ENABLE/WITHPHP_NEW_EXTENSION 设定的。

请始终使用 PHP_ARG_ENABLEPHP_ARG_WITH
进行设置。即使你不打算发布你的 PHP 模块,这些设置也可以保证让你的模块和
PHP 主模块的接口保持一体。

注:PHP_ARG_ENABLEPHP_ARG_WITH
应该是用于定义模块是动态扩展还是静态编译进 PHP 中,就跟编译 PHP 时使用的
--enable-xxx--with-xxx 一样。

编译安装 Memcached 扩展

  • 1.安装 memcached

    • 编译安装 memcached 依赖的 libevent 库

cd /usr/local/src
wget
https://github.com/libevent/libevent/releases/download/release-2.1.8-stable/libevent-2.1.8-stable.tar.gz
tar -zxvf libevent-2.1.8-stable.tar.gz
cd libevent-2.1.8-stable
./configure –prefix=/usr/local/libevent
make && make test && sudo make install
“`

- **编译安装 memcached**

```shell

cd /usr/local/src
wget
http://memcached.org/files/memcached-1.4.39.tar.gz
tar -zxvf memcached-1.4.39.tar.gz
cd memcached-1.4.39.tar.gz
./configure –prefix=/usr/local/memcached
make && make test && sudo make install
“`

  • 2.安装 PHP 的 Memcached 扩展

    • 编译安装 Memcached 扩展插件依赖的 libmemcached 库

cd /usr/local/src
wget
https://launchpad.net/libmemcached/1.0/1.0.18/+download/libmemcached-1.0.18.tar.gz
tar -zxvf libmemcached-1.0.18.tar.gz
cd libmemcached-1.0.18.tar.gz
./configure –prefix=/usr/local/libmemcached
–with-memcached=/usr/local/memcached/bin/memcached
make && make test && sudo make install
“`

- **编译安装 PHP PECL 的 Memcached 扩展**

```shell

cd /usr/local/src
wget
https://pecl.php.net/get/memcached-3.0.3.tgz
tar -zxvf memcached-3.0.3.tgz
cd memcached-3.0.3
/usr/local/bin/phpize #用 phpize 命令生成 configure 配置文件
./configure –with-php-config=/usr/bin/php-config
–with-libmemcached-dir=/usr/local/libmemcached
make && make test && sudo make install
“`

澳门新葡亰娱乐在线,验证一下 memcached 插件是否正确安装:

ls /usr/lib64/php/modules | grep memcached
  • 3.修改 php.ini

vim /etc/php.ini #可以通过 whereis php 来查看 php.ini 文件的位置

在 php.ini 中添加:

extension=memcached.so
  • 4.重启服务

sudo systemctl reload php-fpm

创建资源文件

ext_skel 可以为你的 PHP
模块创建一些通用的代码,你也可以编写一些基本函数定义和 C
代码来处理函数的参数。具体信息可以查看
READNE.EXT_SKEL。

不要担心没有范例,PHP
中有很多模块供你参考,选择一个简单的点开始,添加你自己的代码。

注:ext_skel
可以生成好基本模块需要的资源文件和配置文件,不需要自己创建。

编译 Memcached 过程中踩过的坑

修改自定义模块

将 config.m4 文件和资源文件放到同一个目录中,然后执行 phpize (PHP 4.0
以上的版本编译 PHP 的时候都安装了 phpize)。

如果你的 phpize 不在系统环境变量中,你需要指定绝对路径,例如:

$ /php/bin/phpize

这个命令会自动复制必需的构建文件到当前目录并根据 config.m4
创建配置文件。

通过以上的步骤,你已经有了一个独立的扩展了。

总共需要编译哪些软件?

总共需要编译安装 4 个软件:

  • 先安装 Memcached 依赖的
    libevent;
  • 然后安装
    Memcached 库;
  • 再安装 PHP PECL 的 Memcached 插件依赖的
    libmemcached
    库;
  • 最后安装 PHP PECL 的
    Memcached
    插件.

咳咳. 我曾经因为混淆了 Memcached 和 PHP 的 memcached 插件,
而浪费了很多时间. 囧


发表评论

电子邮件地址不会被公开。 必填项已用*标注

相关文章

网站地图xml地图