基于PHP-X快速开发PHP扩展的完整指南

首页

编程语言

热心网友

转载

2026-05-07

0x01 起步

PHP-X框架基于C++11构建，并使用cmake作为其编译配置工具。开始之前，你需要确保所有必要的依赖项已经准备就绪。具体包括：

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

gcc-4.8 或更高版本

PHP7.0 或更高版本，同时需要安装php7-dev开发包

cmake-2.8 或更高版本

接下来，就可以着手安装PHP-X了。

git clone https://github.com/swoole/PHP-X.git

cd PHP-X

cmake .
make -j 4
sudo make install

如果编译过程一帆风顺，没有报错，那么系统lib目录下就会生成libphpx.so文件，相应的头文件也会被复制到系统的include目录。这时，别忘了执行 sudo ldconfig 命令来刷新系统的so文件缓存。

0x02 新建工程

你可以使用任何顺手的开发工具，创建一个名为 test.cc 的源文件。第一步，就是引入核心的phpx.h头文件，并通过using指令导入phpx的命名空间。由于PHP官方源码并未采用C++，因此phpx直接使用了php作为其命名空间。

#include

using namespace std;
using namespace php;

创建一个扩展，需要借助PHPX_EXTENSION宏。在这个宏里，你只需要简单地new一个Extension对象即可。它的构造函数接受两个参数：第一个是扩展的名称，第二个是扩展的版本号。最后，在宏里返回这个扩展对象的指针。

PHPX_EXTENSION()
{
Extension *ext = new Extension("test", "0.0.1");
return ext;
}

0x03 增加函数

PHP扩展的核心使命之一，就是提供高性能的扩展函数。这些用C/C++实现的函数，其性能往往比PHP用户函数高出数十甚至上百倍。在phpx中，实现一个函数变得异常简单：使用PHPX_FUNCTION宏来定义函数逻辑，然后调用Extension::registerFunction方法进行注册。

我们来定义一个简单的函数：cpp_test($str, $n)。它的功能是，返回一个包含$n个$str的数组。

#include
using namespace std;
using namespace php;

// 声明函数
PHPX_FUNCTION(cpp_test);

PHPX_EXTENSION()
{
Extension *ext = new Extension("test", "0.0.1");
ext->registerFunction(PHPX_FN(cpp_test));
return ext;
}

// 实现函数
PHPX_FUNCTION(cpp_test)
{
// args[1] 对应扩展函数的第二个参数
long n = args[1].toInt();

// 将返回值 retval 初始化为一个数组
Array _array(retval);

for(int i = 0; i < n; i++)
{
// args[0] 对应扩展函数的第一个参数
// append 方法用于向数组中追加元素
_array.append(args[0]);
}
}

0x04 编译扩展

接下来，我们需要一个Makefile来管理编译流程。其内容如下：

PHP_INCLUDE = `php-config --includes`
PHP_LIBS = `php-config --libs`
PHP_LDFLAGS = `php-config --ldflags`
PHP_INCLUDE_DIR = `php-config --include-dir`
PHP_EXTENSION_DIR = `php-config --extension-dir`

test.so: test.cc
c++ -DHA VE_CONFIG_H -g -o test.so -O0 -fPIC -shared test.cc -std=c++11 ${PHP_INCLUDE} -I${PHP_INCLUDE_DIR} -lphpx

install: test.so
cp test.so ${PHP_EXTENSION_DIR}/

clean:
rm *.so

这里用到了一个PHP提供的实用工具——php-config。通过它，我们可以轻松获取PHP的安装路径、头文件目录、扩展目录以及其他关键的编译参数。

这个Makefile支持三个常用指令：make用于编译，make clean用于清理，make install则会将编译好的扩展安装到PHP的扩展目录中。

编写完成后，执行make install。这一步会编译扩展，并将生成的test.so文件复制到PHP的扩展目录。随后，你需要在php.ini配置文件中添加一行：extension=test.so，来加载这个扩展。

使用php -m命令，可以检查你的扩展是否已经成功加载。

php -m
[PHP Modules]
Core
ctype
curl
date
dom
fileinfo
filter
gd
hash
iconv
inotify
json
libxml
mbstring
mcrypt
memcached
mongodb
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
redis
Reflection
session
SimpleXML
sockets
SPL
sqlite3
standard
swoole
test
tokenizer
xml
xmlreader
xmlwriter
yac
zlib
zmq