php扩展入门.pdf

Echo 扩展简介 PHP Extension 是扩展 PHP 功能的关键途径，涵盖了诸如数据库访问、序列化、RPC（远程过程调用）等多种功能。PHP 内置的许多函数实际上都是通过扩展来实现的。PHP 源代码包含了许多内建扩展，同时 PECL（PHP 扩展社区库）还提供了数百种额外的扩展。因此，无论是开发大型应用还是简单的脚本，熟悉如何创建和使用 PHP Extension 都是至关重要的。 ### 开发 PHP Extension 的步骤 1. **生成扩展框架**： 使用 `ext_skel` 脚本来生成扩展的基本结构。在 PHP 源代码目录下的 `ext` 目录中，你可以找到这个工具。在 Linux 上，使用 `./ext_skel --extname=fetion_echo` 命令创建一个名为 `fetion_echo` 的扩展。在 Windows 上，使用 `ext_skel_win32.php`。这将生成一个包含所需文件的目录结构。 2. **Unix Build System 配置**： `config.m4` 文件用于配置 Unix 构建系统，以便生成 `configure` 脚本和 `makefile`。在这个阶段，我们需要确保扩展的配置选项正确。对于简单的扩展，可能只需要取消 `config.m4` 中的 `PHP_ARG_ENABLE` 部分的注释。 3. **编写 phpinfo() 回调函数**： 在扩展中通常会包含一个 `phpinfo()` 函数，用于在页面上显示扩展的相关信息。这部分需要根据具体需求来编写。 4. **编写核心代码**： 在 `fetion_echo.c` 文件中，我们将实现扩展的核心功能。例如，要创建一个 `say_goodbye()` 函数，该函数接收一个字符串参数，并返回 "Goodbye xxx"。 5. **配置与编译**： 运行 `configure` 脚本来配置构建环境，然后使用 `make` 来编译扩展。这将生成一个 `.so` 文件（在 Unix-like 系统上）或 `.dll` 文件（在 Windows 上），可以被 PHP 加载。 6. **配置 php.ini**： 将编译好的扩展添加到 PHP 的配置文件 `php.ini` 中，设置适当的路径和启用扩展。 ### PHP Extension 的核心代码分析 在 `fetion_echo.c` 文件中，通常会包含以下结构： - `PHP_FUNCTION` 宏定义了 PHP 函数的入口点。例如，对于 `say_goodbye` 函数，将有一个类似这样的宏： ```c PHP_FUNCTION(say_goodbye) { // 函数实现 } ``` - `RETURN_STRING` 或其他 `RETURN_XXX` 宏用于返回不同类型的数据到 PHP 层。在 `say_goodbye` 示例中，可能会用到 `RETURN_STRING` 返回字符串。 - `ZEND_FUNCTION` 或 `ZEND_DLEXPORT` 用于标记函数为可由 PHP 调用。 - `zend_function_entry` 结构体定义了扩展暴露给 PHP 的函数列表。 - `PHP_MINIT_FUNCTION` 和 `PHP_MSHUTDOWN_FUNCTION` 宏定义了扩展的初始化和清理操作。 - `zend_module_entry` 结构体描述了整个扩展，包括其名称、版本、作者等信息，以及初始化和清理函数的指针。 ### 继续开发 `fetion_echo` 扩展 在 `fetion_echo.c` 文件中，你需要实现 `say_goodbye` 函数的具体逻辑。例如： ```c PHP_FUNCTION(say_goodbye) { char *str = NULL; size_t str_len; if (zend_parse_parameters(ZEND_NUM_ARGS(), "s", &str, &str_len) == FAILURE) { RETURN_FALSE; } char *result = estrdup_printf("Goodbye %s", str); RETVAL_STRING(result); efree(result); } ``` 这段代码首先解析参数，检查是否传递了一个字符串，然后创建并返回 "Goodbye" 后跟传入字符串的新字符串。 完成以上步骤后，通过运行 `configure`、`make` 和 `make install` 来构建并安装扩展。接着，在 `php.ini` 中启用 `extension=fetion_echo.so`（或对应的 Windows 路径），重启 PHP 服务器，你就可以在 PHP 程序中使用 `say_goodbye` 函数了。 通过这个简单的实例，你可以了解到创建 PHP Extension 的基本流程和关键点。随着经验的增长，你将能够创建更复杂、功能丰富的扩展，满足各种定制需求。