Question

PHP 扩展的主文件通常是一个用 C 语言编写的源文件，它实现了扩展的功能逻辑并定义了 PHP 和底层代码之间的接口。这个文件通常是扩展的核心部分，主要用于注册扩展、定义函数、类和模块的生命周期等。

以下是关于 PHP 扩展主文件的一些关键内容和结构说明。

---

1. 主文件的核心结构

PHP 扩展的主文件通常以 .c 为后缀，文件中包含以下关键部分：

1.1 引入必要的头文件

每个 PHP 扩展主文件都会包含 PHP 提供的一些头文件，例如：

#include "php.h"
#include "ext/standard/info.h"  // 包含标准的扩展信息功能

1.2 定义扩展的基本信息

扩展的名称、版本和其他元信息需要通过宏来定义：

#define PHP_MYEXT_NAME "myext"
#define PHP_MYEXT_VERSION "1.0.0"

1.3 定义函数和方法

扩展提供的所有 PHP 函数需要在 C 文件中实现，并通过函数表声明。

例如，一个简单的函数实现：

PHP_FUNCTION(myext_hello) {
  php_printf("Hello from my PHP extension!\n");
}

然后将函数注册到扩展函数表：

const zend_function_entry myext_functions[] = {
  PHP_FE(myext_hello, NULL) // 声明 myext_hello 函数
  PHP_FE_END // 函数表结束
};

1.4 模块结构定义

扩展模块需要通过 zend_module_entry 结构体定义，它包含扩展的元信息和钩子函数：

zend_module_entry myext_module_entry = {
  STANDARD_MODULE_HEADER,       // 标准头部
  PHP_MYEXT_NAME,               // 扩展名称
  myext_functions,              // 函数表
  PHP_MINIT(myext),             // MINIT - 模块初始化
  PHP_MSHUTDOWN(myext),         // MSHUTDOWN - 模块关闭
  PHP_RINIT(myext),             // RINIT - 请求初始化
  PHP_RSHUTDOWN(myext),         // RSHUTDOWN - 请求关闭
  PHP_MINFO(myext),             // MINFO - 显示扩展信息
  PHP_MYEXT_VERSION,            // 扩展版本
  STANDARD_MODULE_PROPERTIES    // 标准模块属性
};

1.5 声明扩展入口

最后通过宏将扩展入口暴露给 PHP：

ZEND_GET_MODULE(myext)

---

2. 生命周期钩子函数

扩展模块有一系列生命周期钩子函数，可以在不同阶段执行特定逻辑。以下是常见的钩子函数：

MINIT - 模块初始化

当 PHP 加载扩展时调用，用于初始化资源。

PHP_MINIT_FUNCTION(myext) {
  // 初始化工作，比如注册类或全局变量
  return SUCCESS;
}

MSHUTDOWN - 模块关闭

当 PHP 关闭扩展时调用，用于释放资源。

PHP_MSHUTDOWN_FUNCTION(myext) {
  // 释放资源
  return SUCCESS;
}

RINIT - 请求初始化

每次 PHP 请求开始时调用。

PHP_RINIT_FUNCTION(myext) {
  // 每次请求初始化的逻辑
  return SUCCESS;
}

RSHUTDOWN - 请求关闭

每次 PHP 请求结束时调用。

PHP_RSHUTDOWN_FUNCTION(myext) {
  // 每次请求关闭的逻辑
  return SUCCESS;
}

MINFO - 显示扩展信息

通过 phpinfo() 显示扩展的元信息。

PHP_MINFO_FUNCTION(myext) {
  php_info_print_table_start();
  php_info_print_table_header(2, "myext support", "enabled");
  php_info_print_table_row(2, "Version", PHP_MYEXT_VERSION);
  php_info_print_table_end();
}

---

3. 示例完整代码

以下是一个完整的简单 PHP 扩展主文件的代码：

#include "php.h"
#include "ext/standard/info.h"

#define PHP_MYEXT_NAME "myext"
#define PHP_MYEXT_VERSION "1.0.0"

// 声明一个简单函数
PHP_FUNCTION(myext_hello) {
  php_printf("Hello, this is my PHP extension!\n");
}

// 函数表
const zend_function_entry myext_functions[] = {
  PHP_FE(myext_hello, NULL)
  PHP_FE_END
};

// MINIT
PHP_MINIT_FUNCTION(myext) {
  return SUCCESS;
}

// MSHUTDOWN
PHP_MSHUTDOWN_FUNCTION(myext) {
  return SUCCESS;
}

// MINFO
PHP_MINFO_FUNCTION(myext) {
  php_info_print_table_start();
  php_info_print_table_header(2, "myext support", "enabled");
  php_info_print_table_row(2, "Version", PHP_MYEXT_VERSION);
  php_info_print_table_end();
}

// 模块结构
zend_module_entry myext_module_entry = {
  STANDARD_MODULE_HEADER,
  PHP_MYEXT_NAME,
  myext_functions,
  PHP_MINIT(myext),
  PHP_MSHUTDOWN(myext),
  NULL, // RINIT
  NULL, // RSHUTDOWN
  PHP_MINFO(myext),
  PHP_MYEXT_VERSION,
  STANDARD_MODULE_PROPERTIES
};

ZEND_GET_MODULE(myext)

---

4. 编译扩展

使用 phpize 工具生成配置文件，然后编译扩展：

phpize
./configure
make
sudo make install

然后在 php.ini 中加载扩展：

extension=myext.so

运行 PHP 测试：

php -r "myext_hello();"

输出：

Hello, this is my PHP extension!

---

如果需要更多关于 PHP 扩展开发的内容，可以进一步探索具体功能的实现，例如注册类、操作数组等。