使用C和PHP-CPP开发PHP扩展：高级-php教程-PHP中文网

使用C 和PHP-CPP开发PHP扩展：高级主题和最佳实践

关键要点

使用C 和PHP-CPP开发PHP扩展涉及高级主题，例如返回“this”指针、返回复杂对象指针、公开__toString魔术方法、链接成员函数调用以及PHP中的异常抛出和处理。
对于需要在未来用于非PHP项目的软件、数据结构或算法的项目，或者需要使用尚未作为PHP扩展提供的工具或库的项目，PHP-CPP库是理想的选择。它还提供C/C 代码的性能优势，同时保持结构化、面向对象的代码，便于理解和维护。
PHP-CPP库可用于个人和商业项目。但是，虽然库本身是免费的，但可能需要时间和资源来学习如何有效地使用它并维护PHP扩展。
使用C 进行PHP扩展开发的常见挑战包括正确管理内存、处理错误和异常以及PHP和C 之间的接口。可以通过深入了解PHP和C 、使用良好的编程实践以及利用PHP-CPP提供的功能和工具来克服这些挑战。

在我之前的文章中，我介绍了使用C （第一篇文章和第二篇文章）创建PHP扩展的PHP-CPP库。在后一篇文章中，我演示了使用Complex类进行复数运算的编写PHP扩展的面向对象方面。

Developing PHP Extensions with C and PHP-CPP: Advanced

该介绍并不完整，因为该文章的主要重点更多地放在演示PHP-CPP的面向对象能力上，而不是面向对象的实现细节上。

在本文中，我们将进一步深入研究Complex库的开发，添加更多成员函数，并解决使用PHP-CPP编写具有面向对象功能的PHP扩展中的一些高级主题：

返回this指针；
返回Complex对象指针，即Complex *；
公开__toString魔术方法；
链式成员函数调用；
抛出异常并在PHP中处理它

完整的Complex库源代码以及测试PHP脚本位于此Github存储库中。

让我们开始吧。

准备工作

在第一篇文章中解释了准备环境的整个过程。

在C 中返回this指针

如第二篇文章所述，我们使用成员函数对复数执行各种数学运算。在此演示中，我们将实现四个这样的函数：add、sub、mul和div。我将首先解释前三个。div函数涉及异常处理，稍后将讨论。

让我们看一下mul函数（用于乘法）。add和sub函数大致相同。

Php::Value add(Php::Parameters &params) {
    Php::Value t = params[0];
    Complex *a = (Complex *) t.implementation();

    r += (double) a->getReal();
    i += (double) a->getImage();

    return this;
}

登录后复制

注意：在本文中，我将不介绍一些之前讨论过的基本主题，例如修改Makefile和ini文件、注册成员函数、类和命名空间等。请参考前面的部分了解这些内容。

将this指针从C 返回到PHP很简单。在这个C 函数内部，this指针（作为Complex *类型）可以作为Php::Value类型返回到PHP。转换不会丢失任何对象信息。它也不需要显式类型转换。

返回Complex对象指针

返回this通常意味着对象本身已更改。但在某些情况下，我们可能希望返回一个新对象并保持“当前”对象（调用对象）不变。

在我们的Complex类中，我们有一个这样的函数，它返回给定复数的共轭数（a bi变为a-bi）。

Php::Value add(Php::Parameters &params) {
    Php::Value t = params[0];
    Complex *a = (Complex *) t.implementation();

    r += (double) a->getReal();
    i += (double) a->getImage();

    return this;
}

登录后复制

这里的关键点是，我们必须使用Php::Object将我们的Complex *对象显式转换为Php::Object，因此当该对象稍后由PHP脚本解析时，可以正确保留类信息并保持其可访问性。

此函数的第一个参数是类类型，在本例中为trComplex。我使用此名称是因为我已将此类（“Complex”）包装到单独的命名空间（“tr”）中。

第二个参数是要传回的对象。

返回新的类实例比只返回this指针要棘手一些，但只要您阅读了文档并找到了正确的部分，仍然是可以管理的。有关更多用法示例，您可能需要阅读PHP-CPP官方文档中的这一部分。

公开__toString魔术方法

在我们的类中，有一个__toString函数，它以更易读的方式打印复数，例如：1 2i。在我之前的文章中，此函数未公开（或在PHP-CPP术语中“注册”），但仍然可以从PHP内部调用。但是，为了使此函数在我们应用一些数学运算（例如“echo $a->add($b)->sub($c)”）后能够在Complex对象上调用，我们需要在已编译的扩展中显式注册它：

Php::Value conjugate() {
    Complex *t = new Complex();

    t->r = r;
    t->i = -i;

    return Php::Object("tr\Complex", t);
}

登录后复制

我们在PHP-CPP存储库中提交的问题Issue #150详细讨论了我们必须这样做的原因。

链式成员函数调用

必须在此类中实现的一件事是能够链接成员函数，以便我们可以进行如下计算：$a->add($b)->sub($c)。结果仍然应该能够调用其成员函数。

这是通过上述方法完成的，即返回this指针到PHP。但是，较旧的PHP-CPP库在取消引用对象时存在错误，如果链接方法调用，则会创建“段错误”。

已提交问题（#151），并提交了包含PHP-CPP源代码补丁的提交。如果您使用的是旧版本的PHP-CPP库来编译PHP-CPP库和您自己的库，请更新PHP源代码并重新编译和重新安装PHP-CPP库和您的库。

如提交摘要所解释：

complex.method("__toString", &Complex::__toString);

登录后复制

我很高兴我自己的项目工作可以帮助我使用的库变得更好。

异常抛出和PHP中的处理

我们的Complex类中还有两个函数可能会将异常抛回PHP进行处理：div和phi。前者执行除法运算，后者返回复数的角度，如其替代表示形式极坐标表示法（r，θ）所示。

如果将复数作为参数（或调用者）传递，但其实部和虚部为0，则这两个操作都可能失败。对于这两个操作，我们需要进行异常处理。请记住，我们要在C 代码中抛出异常，而PHP脚本将捕获异常并进行必要的处理：

Php::Value add(Php::Parameters &params) {
    Php::Value t = params[0];
    Complex *a = (Complex *) t.implementation();

    r += (double) a->getReal();
    i += (double) a->getImage();

    return this;
}

登录后复制

在PHP脚本中，我们像这样捕获此异常：

Php::Value conjugate() {
    Complex *t = new Complex();

    t->r = r;
    t->i = -i;

    return Php::Object("tr\Complex", t);
}

登录后复制

上面的代码段将显示如下文本行：

complex.method("__toString", &Complex::__toString);

登录后复制

很简单，对吧？在我们的扩展中构造的C 异常被传回PHP并被正确捕获。此外，我们可以像处理其他PHP代码抛出的原生PHP异常一样操作异常！

测试所有函数

最后，我们可以通过make && sudo make install为我们的PHP安装编译和安装complex.so扩展。如果一切顺利，我们可以通过在终端中发出以下命令来验证扩展的安装：

<code>修复问题#151，链式方法调用无法正常工作……
……因为每个对象的引用计数未正确更新，这导致即使对象已分配给不同的变量，该对象也会被销毁。</code>

登录后复制

终端应该显示一行显示“/etc/php5/cli/conf.d/complex.ini”，我们可以确定我们的扩展已安装并准备由任何PHP脚本调用。

注意：如果我们检查此扩展的Makefile，我们将看到我们正在将此PHP扩展安装到其CLI环境中。如果我们想安装此扩展以便Apache加载它，我们更改以下行：

Php::Value div(Php::Parameters &params) {
    Php::Value t = params[0];
    Complex *b = (Complex*) t.implementation();

    double t1 = b->mod() * b->mod();

    if (t1 == 0)
        throw Php::Exception("Division by zero");

    double tr = r * (double) (b->getReal()) + i * (double) (b->getImage());
    double ti = i * (double) (b->getReal()) - r * (double) (b->getImage());

    r = tr / t1;
    i = ti / t1;

    return this;
}

登录后复制

此扩展的测试PHP脚本如下所示，并带有一些注释：

$a=new tr\Complex(1,2);
$c=new tr\Complex(); //$c实际上是0+0i

try
{
    $res=$a->div($c);
}
catch(Exception $e)
{
    echo "Caught exception: ".$e->getMessage()."\n";
}
}

登录后复制

所有测试脚本都应该正确运行，并且异常被正确捕获。

结论

这总结了我关于使用C 构建PHP扩展的这个强大库的3篇文章系列。我们介绍了基础知识、面向对象方面以及面向对象编程中的一些高级主题。我们还帮助PHP-CPP有所改进。

我们还能用PHP-CPP做什么？我将引用几行我从Emiel Bruijntjes（PHP-CPP的合著者）收到的电子邮件通信：

如果您正在从事一个项目，并且具有以下一个或多个要求，则PHP-CPP库是理想的选择： – 您正在处理软件/数据结构/算法，并且您希望确保将来您的软件也可以用于非PHP项目。 – 您想使用尚未作为PHP扩展提供的工具或库。 – 您希望获得C/C 代码的更好性能（与PHP相比），但您还想构建结构化、面向对象的代码，以便其他开发人员/同事易于理解和维护。

可能性是巨大的：框架（如Phalcon）、模板语言（如Smarty或Twig）等等。

请留下您的评论和观点，让我们知道您使用此库做了什么！

使用C 开发PHP扩展的常见问题解答

使用C 开发PHP扩展的好处是什么？

使用C 开发PHP扩展具有多种好处。首先，它允许您在PHP应用程序中利用C 的强大功能和灵活性。这可以提高性能，尤其是在计算密集型任务中。其次，它提供了一种在PHP环境中重用现有C 代码的方法，这可以节省大量的开发时间和精力。最后，它使您能够创建自定义PHP扩展，这些扩展可以扩展PHP的功能并提供标准PHP库中不可用的功能。