PHP扩展是一种动态链接库，它可以增强PHP的功能，并且可以使用C语言（或C++）编写。通过编写PHP扩展，我们可以将C语言的高效性和PHP的易用性结合起来。

下面我们来看一下如何实现一个PHP扩展。

## 第一步：准备开发环境

我们需要准备好以下开发环境：

1. C编译器

2. PHP源代码

3. PHP开发库

如果你已经安装了PHP，那么你可以通过下面的命令查看PHP的版本和安装路径：

```bash

$ php -v

PHP 7.4.5 (cli) (built: Apr 14 2020 16:13:58) ( NTS )

Copyright (c) The PHP Group

...

$ php-config --prefix

/opt/homebrew/Cellar/php/7.4.5

如果你还没有安装PHP，那么请先安装PHP及其开发库。

## 第二步：创建扩展的基本框架

在我们开始编写扩展之前，我们需要创建扩展的基本框架。可以使用PHP官方提供的ext_skel脚本来创建一个基本的扩展框架。ext_skel是一个自动生成扩展文件所需的文件和目录结构的工具。

在终端中输入以下命令创建一个名为"myextension"的扩展：

```bash

$ cd /path/to/php-src/ext

$ ./ext_skel --extname=myextension

Creating directory myextension

Creating basic files: config.m4 myextension.c php_myextension.h CREDITS EXPERIMENTAL tests/001.phpt myextension.php [done].

To use your new extension, you will have to execute the following steps:

1. $ cd ..

2. $ vi ext/myextension/config.m4

3. $ ./buildconf

4. $ ./configure --[with|enable]-myextension

5. $ make

6. $ ./sapi/cli/php -f ext/myextension/myextension.php

7. $ vi ext/myextension/myextension.c

8. $ make

Repeat steps 3-6 until you are satisfied with ext/myextension/config.m4 and

step 6 confirms that your module is compiled into PHP. Then, start writing

code and repeat the last two steps as often as necessary.

执行完ext_skel命令后，会生成一个名为myextension的目录，里面包含了一个扩展的基本框架：config.m4、myextension.c、php_myextension.h和myextension.php。其中config.m4是扩展的配置文件，myextension.c是扩展的源文件，php_myextension.h是扩展的头文件，myextension.php是PHP脚本文件。

## 第三步：编写扩展代码

现在我们需要编写扩展的代码。在myextension.c中，我们可以看到这个文件已经包含了一些基本的代码。我们需要在这个文件中加入我们自己的代码。

例如，我们可以在这个文件中定义一个PHP函数，这个函数将接受一个字符串参数，并返回这个字符串的长度。

```c

#include "php_myextension.h"

PHP_FUNCTION(myextension_strlen) {

char* str;

size_t str_len;

if (zend_parse_parameters(ZEND_NUM_ARGS(), "s", &str, &str_len) == FAILURE) {

return;

}

RETURN_LONG(str_len);

}

zend_function_entry myextension_functions[] = {

PHP_FE(myextension_strlen, NULL)

PHP_FE_END

};

zend_module_entry myextension_module_entry = {

STANDARD_MODULE_HEADER,

"myextension",

myextension_functions,

NULL,

NULL,

NULL,

NULL,

NULL,

"1.0",

STANDARD_MODULE_PROPERTIES

};

#ifdef COMPILE_DL_MYEXTENSION

ZEND_GET_MODULE(myextension)

#endif

这个函数使用了PHP_FUNCTION()宏来定义一个PHP函数myextension_strlen。在这个函数中，我们使用了zend_parse_parameters()函数来解析函数的参数。接着，我们使用RETURN_LONG()宏来返回字符串的长度。

在最后几行代码中，我们定义了一个myextension_functions数组来保存所有的PHP函数，然后我们将这个数组添加到myextension_module_entry结构体中。这个结构体是扩展的主要定义。其中，我们指定了扩展的名字，所有的PHP函数，版本号以及其他属性。

最后，我们使用#ifdef COMPILE_DL_MYEXTENSION和ZEND_GET_MODULE()宏来定义扩展的动态链接库。这个宏告诉系统哪些函数应该被编译成动态链接库，以便其他PHP脚本可以调用这些函数。

## 第四步：编译扩展

完成扩展代码的编写后，我们需要编译扩展。

先进入myextension目录，按照包含的README提示，用命令"./buildconf"来生成configure文件，然后执行：

```bash

$ ./configure --enable-myextension

$ make && make test

make命令会编译扩展的源代码并生成扩展的动态链接库myextension.so。执行"make test"命令来运行PHP测试脚本。

## 第五步：安装扩展

将myextension.so复制到PHP扩展目录，并在php.ini配置文件中添加以下行：

```ini

extension=myextension.so

保存php.ini文件并重新启动Web服务器。

## 第六步：测试扩展

现在我们可以在PHP中调用我们的扩展函数了。

```php

echo myextension_strlen("hello"); // 输出 5

这样，我们就完成了一个简单的PHP扩展的编写和测试。

总结：

通过以上的步骤，我们可以看到编写PHP扩展的过程并不是很复杂，只需要了解C语言和PHP开发库的基本知识就可以完成一个简单扩展的开发。同时，如果你想开发更加复杂的扩展，可以阅读更多PHP源码来提高自己的能力。

PHP是一门易于学习和使用的编程语言，它支持通过扩展来增强其功能。PHP扩展是动态链接库或模块，用于增强PHP的性能和功能。

在本文中，我们将介绍如何编写PHP扩展。我们将从创建一个简单的“Hello World”扩展开始，以演示扩展的基本结构和编写扩展函数的步骤。然后，我们将讨论如何添加参数和返回值，以及如何在扩展中使用全局变量和静态变量。

## 创建一个简单的扩展

首先，我们需要创建一个扩展的骨架结构。以下是一个简单的扩展结构：

ext

└── helloworld

├── config.m4

├── helloworld.c

├── helloworld.h

└── php_helloworld.h

`config.m4`是一个Makefile的脚本，是扩展的构建过程中使用的，包含了编译和链接扩展的命令。`helloworld.c`是扩展源代码的主文件，其中包含了扩展函数的实现。`helloworld.h`是扩展的头文件，其中包含了扩展函数的声明。`php_helloworld.h`是PHP扩展的头文件，其中包含了所有必需的宏和结构体定义。

下面是`config.m4`文件的内容：

PHP_ARG_ENABLE(helloworld, whether to enable HelloWorld extension, [ --enable-helloworld Enable HelloWorld extension])

if test "$PHP_HELLOWORLD" = "yes"; then

AC_DEFINE(HAVE_HELLOWORLD, 1, [Whether you have HelloWorld])

PHP_NEW_EXTENSION(helloworld, helloworld.c, $ext_shared)

fi

`helloworld.c`文件包含了`PHP_MINIT_FUNCTION`和`PHP_MSHUTDOWN_FUNCTION`两个函数，用于初始化和清理扩展。此外，还包含了一个`PHP_FUNCTION(hello_world)`函数，该函数输出一个“Hello World”字符串。以下是`helloworld.c`文件的内容：

```c

#include "php_helloworld.h"

PHP_FUNCTION(hello_world)

{

php_printf("Hello World!");

}

PHP_MINIT_FUNCTION(helloworld)

{

return SUCCESS;

}

PHP_MSHUTDOWN_FUNCTION(helloworld)

{

return SUCCESS;

}

zend_function_entry helloworld_functions[] = {

PHP_FE(hello_world, NULL)

{NULL, NULL, NULL}

};

zend_module_entry helloworld_module_entry = {

STANDARD_MODULE_HEADER,

"HelloWorld",

helloworld_functions,

PHP_MINIT(helloworld),

PHP_MSHUTDOWN(helloworld),

NULL,

NULL,

NULL,

"1.0",

STANDARD_MODULE_PROPERTIES

};

#ifdef COMPILE_DL_HELLOWORLD

ZEND_GET_MODULE(helloworld)

#endif

## 编译和安装扩展

现在我们有了一个简单的扩展结构和源代码，下一步是编译和安装扩展。在终端中使用以下命令来编译扩展：

phpize

./configure --enable-helloworld

make

sudo make install

`phpize`命令用于生成`configure`脚本和必备的Makefile。`./configure`命令用于配置扩展。`--enable-helloworld`选项用于启用扩展。`make`用于编译扩展。`sudo make install`用于将扩展安装到PHP扩展目录。

## 测试扩展

现在，我们已经将扩展编译并安装到PHP中。让我们测试一下扩展，检查它的功能是否符合预期。

创建一个测试文件，例如`test.php`，并将以下代码添加到文件中：

```php

<?php

hello_world();

?>

然后在终端中使用以下命令执行测试文件：

php test.php

如果一切顺利，你应该能够在命令行中看到输出`Hello World`。

## 添加参数和返回值

扩展不仅可以打印消息，还可以使用参数和返回值。下面是一个演示如何使用参数和返回值的示例：

```c

#include "php_helloworld.h"

PHP_FUNCTION(square)

{

double num;

if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "d", &num) == FAILURE) {

RETURN_NULL();

}

RETURN_DOUBLE(num * num);

}

zend_function_entry helloworld_functions[] = {

PHP_FE(hello_world, NULL)

PHP_FE(square, NULL)

{NULL, NULL, NULL}

};

在这个示例中，我们添加了一个名为`square`的函数，该函数需要一个`double`类型的数字参数，并返回该参数的平方。在实现中，我们使用了`zend_parse_parameters`函数来解析传递给函数的参数。如果传递了错误的参数类型或数量，则使用`RETURN_NULL()`函数返回`NULL`值。

## 使用全局和静态变量

扩展还可以使用全局和静态变量。下面是一个演示如何使用全局和静态变量的示例：

```c

#include "php_helloworld.h"

static long counter = 0;

PHP_FUNCTION(increment)

{

counter++;

}

PHP_FUNCTION(get_count)

{

RETURN_LONG(counter);

}

zend_function_entry helloworld_functions[] = {

PHP_FE(hello_world, NULL)

PHP_FE(square, NULL)

PHP_FE(increment, NULL)

PHP_FE(get_count, NULL)

{NULL, NULL, NULL}

};

在这个示例中，我们添加了两个函数，`increment`和`get_count`，这两个函数使用一个名为`counter`的静态变量来实现计数器。`increment`函数将计数器递增1，而`get_count`函数返回当前计数器的值。同时，`counter`变量是在文件级别声明的，因此是全局可见的。

## 结论

到此为止，我们已经学习了如何编写和编译一个简单的PHP扩展。无论您想增强PHP的性能还是功能，编写扩展都是一个非常有用的技能。虽然创建复杂的PHP扩展需要更多的工作，但是基本的知识点和步骤都与简单的扩展相同。