php扩展开发入门demo示例

下面我将为你详细讲解如何开发PHP扩展的完整攻略。

准备工作

首先，你需要安装PHP开发环境，确保phpize命令可用。如果你是在Linux或者MacOS上进行开发，可以通过包管理器或源码编译的方式安装PHP开发环境。如果你是在Windows上进行开发，则可以安装集成开发环境如XAMPP或者WampServer等。

安装好PHP开发环境之后，你需要安装PHP Extension Tool（PECL）命令行工具，并确保你的计算机已经安装了一些必要的C开发库，例如build-essential和php-dev等。

创建扩展

1. 使用命令pecl bundle <extension-name>创建一个新的扩展。这将创建一个名为<extension-name>-<version-number>.tgz的归档文件，并将其解压到当前目录中。
2. 进入到扩展目录中，使用phpize命令生成configure脚本。此命令将为你的扩展生成必要的Makefile配置文件，以确保正确地构建你的扩展。
3. 输入./configure并回车，以根据configure脚本生成的Makefile配置文件进行构建设置。
4. 运行make命令来编译你的扩展。这将编译扩展，并生成.so的动态链接库文件。
5. 运行sudo make install命令来安装你的扩展。这将把扩展文件复制到PHP扩展目录下，通常是/usr/lib/php/<version>。
6. 编辑PHP配置文件php.ini并添加extension=<extension-name>.so条目。
7. 重启Web服务器或者PHP-FPM进程池，使新的扩展生效。

示例一

下面我们来看一个示例，展示如何编写一个Hello World扩展：

扩展目录结构

hello/
    config.m4
    hello.c

config.m4

PHP_ARG_ENABLE(hello, whether to enable Hello extension,
[  --enable-hello        Enable Hello extension support])

if test "$PHP_HELLO" != "no"; then
  PHP_SUBST(HAPPY_SHARED_LIBADD)
  PHP_NEW_EXTENSION(hello, hello.c, $ext_shared)
fi

hello.c

#include "php_hello.h"

PHP_FUNCTION(hello_world)
{
    RETURN_STRING("Hello World!", 1);
}

const zend_function_entry hello_functions[] = {
    PHP_FE(hello_world, NULL)
    { NULL, NULL, NULL }
};

zend_module_entry hello_module_entry = {
    STANDARD_MODULE_HEADER,
    "Hello",
    hello_functions,
    NULL,
    NULL,
    NULL,
    NULL,
    NULL,
    NO_VERSION_YET,
    STANDARD_MODULE_PROPERTIES
};

#ifdef COMPILE_DL_HELLO
ZEND_GET_MODULE(hello)
#endif

编译扩展

在扩展目录中运行以下命令：

phpize
./configure --enable-hello
make
sudo make install

编辑PHP配置文件

在php.ini文件中添加以下内容：

extension=hello.so

验证扩展

在命令行运行php -r "echo hello_world();"，将会输出Hello World!。

示例二

下面我们来看第二个示例，展示如何编写一个计算两个数字之和的扩展：

扩展目录结构

addition/
    config.m4
    addition.c

config.m4

PHP_ARG_ENABLE(addition, whether to enable Addition extension,
[  --enable-addition        Enable Addition extension support])

if test "$PHP_ADDITION" != "no"; then
  PHP_SUBST(HAPPY_SHARED_LIBADD)
  PHP_NEW_EXTENSION(addition, addition.c, $ext_shared)
fi

addition.c

#include "php_addition.h"

PHP_FUNCTION(addition)
{
    double num1, num2;

    if (zend_parse_parameters(ZEND_NUM_ARGS(), "dd", &num1, &num2) == FAILURE) {
        return;
    }

    RETURN_DOUBLE(num1 + num2);
}

const zend_function_entry addition_functions[] = {
    PHP_FE(addition, NULL)
    { NULL, NULL, NULL }
};

zend_module_entry addition_module_entry = {
    STANDARD_MODULE_HEADER,
    "Addition",
    addition_functions,
    NULL,
    NULL,
    NULL,
    NULL,
    NULL,
    NO_VERSION_YET,
    STANDARD_MODULE_PROPERTIES
};

#ifdef COMPILE_DL_ADDITION
ZEND_GET_MODULE(addition)
#endif

编译扩展

在扩展目录中运行以下命令：

phpize
./configure --enable-addition
make
sudo make install

编辑PHP配置文件

在php.ini文件中添加以下内容：

extension=addition.so

验证扩展

在命令行运行php -r "echo addition(1.5, 2.4);"，将会输出3.9。

结论

以上就是开发PHP扩展的完整攻略和两个示例的说明。需要注意的是，开发扩展需要一定的C语言基础和理解能力，如果遇到问题，可以参考PHP官方文档和其他开发者的经验分享。希望能对你有所帮助。