使用C 和PHP-CPP開發(fā)PHP擴(kuò)展：高級(jí)主題和最佳實(shí)踐

關(guān)鍵要點(diǎn)

• 使用C 和PHP-CPP開發(fā)PHP擴(kuò)展涉及高級(jí)主題，例如返回“this”指針、返回複雜對(duì)象指針、公開__toString魔術(shù)方法、鏈接成員函數(shù)調(diào)用以及PHP中的異常拋出和處理。
• 對(duì)於需要在未來(lái)用於非PHP項(xiàng)目的軟件、數(shù)據(jù)結(jié)構(gòu)或算法的項(xiàng)目，或者需要使用尚未作為PHP擴(kuò)展提供的工具或庫(kù)的項(xiàng)目，PHP-CPP庫(kù)是理想的選擇。它還提供C/C 代碼的性能優(yōu)勢(shì)，同時(shí)保持結(jié)構(gòu)化、面向?qū)ο蟮拇a，便於理解和維護(hù)。
• PHP-CPP庫(kù)可用於個(gè)人和商業(yè)項(xiàng)目。但是，雖然庫(kù)本身是免費(fèi)的，但可能需要時(shí)間和資源來(lái)學(xué)習(xí)如何有效地使用它並維護(hù)PHP擴(kuò)展。
• 使用C 進(jìn)行PHP擴(kuò)展開發(fā)的常見(jiàn)挑戰(zhàn)包括正確管理內(nèi)存、處理錯(cuò)誤和異常以及PHP和C 之間的接口。可以通過(guò)深入了解PHP和C 、使用良好的編程實(shí)踐以及利用PHP-CPP提供的功能和工具來(lái)克服這些挑戰(zhàn)。

在我之前的文章中，我介紹了使用C （第一篇文章和第二篇文章）創(chuàng)建PHP擴(kuò)展的PHP-CPP庫(kù)。在後一篇文章中，我演示了使用Complex類進(jìn)行複數(shù)運(yùn)算的編寫PHP擴(kuò)展的面向?qū)ο蠓矫妗?

該介紹並不完整，因?yàn)樵撐恼碌闹饕攸c(diǎn)更多地放在演示PHP-CPP的面向?qū)ο竽芰ι希皇敲嫦驅(qū)ο蟮膶?shí)現(xiàn)細(xì)節(jié)上。

在本文中，我們將進(jìn)一步深入研究Complex庫(kù)的開發(fā)，添加更多成員函數(shù)，並解決使用PHP-CPP編寫具有面向?qū)ο窆δ艿腜HP擴(kuò)展中的一些高級(jí)主題：

• 返回this指針；
• 返回Complex對(duì)象指針，即Complex *；
• 公開__toString魔術(shù)方法；
• 鍊式成員函數(shù)調(diào)用；
• 拋出異常並在PHP中處理它

完整的Complex庫(kù)源代碼以及測(cè)試PHP腳本位於此Github存儲(chǔ)庫(kù)中。

讓我們開始吧。

準(zhǔn)備工作

在第一篇文章中解釋了準(zhǔn)備環(huán)境的整個(gè)過(guò)程。

在C 中返回this指針

如第二篇文章所述，我們使用成員函數(shù)對(duì)複數(shù)執(zhí)行各種數(shù)學(xué)運(yùn)算。在此演示中，我們將實(shí)現(xiàn)四個(gè)這樣的函數(shù)：add、sub、mul和div。我將首先解釋前三個(gè)。 div函數(shù)涉及異常處理，稍後將討論。

讓我們看一下mul函數(shù)（用於乘法）。 add和sub函數(shù)大致相同。

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;
}

注意：在本文中，我將不介紹一些之前討論過(guò)的基本主題，例如修改Makefile和ini文件、註冊(cè)成員函數(shù)、類和命名空間等。請(qǐng)參考前面的部分了解這些內(nèi)容。

將this指針從C 返回到PHP很簡(jiǎn)單。在這個(gè)C 函數(shù)內(nèi)部，this指針（作為Complex *類型）可以作為Php::Value類型返回到PHP。轉(zhuǎn)換不會(huì)丟失任何對(duì)象信息。它也不需要顯式類型轉(zhuǎn)換。

返回Complex對(duì)象指針

返回this通常意味著對(duì)象本身已更改。但在某些情況下，我們可能希望返回一個(gè)新對(duì)象並保持“當(dāng)前”對(duì)象（調(diào)用對(duì)象）不變。

在我們的Complex類中，我們有一個(gè)這樣的函數(shù)，它返回給定複數(shù)的共軛數(shù)（a bi變?yōu)閍-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;
}

這裡的關(guān)鍵點(diǎn)是，我們必須使用Php::Object將我們的Complex *對(duì)象顯式轉(zhuǎn)換為Php::Object，因此當(dāng)該對(duì)象稍後由PHP腳本解析時(shí)，可以正確保留類信息並保持其可訪問(wèn)性。

此函數(shù)的第一個(gè)參數(shù)是類類型，在本例中為trComplex。我使用此名稱是因?yàn)槲乙褜⒋祟悾ā癈omplex”）包裝到單獨(dú)的命名空間（“tr”）中。

第二個(gè)參數(shù)是要傳回的對(duì)象。

返回新的類實(shí)例比只返回this指針要棘手一些，但只要您閱讀了文檔並找到了正確的部分，仍然是可以管理的。有關(guān)更多用法示例，您可能需要閱讀PHP-CPP官方文檔中的這一部分。

公開__toString魔術(shù)方法

在我們的類中，有一個(gè)__toString函數(shù)，它以更易讀的方式打印複數(shù)，例如：1 2i。在我之前的文章中，此函數(shù)未公開（或在PHP-CPP術(shù)語(yǔ)中“註冊(cè)”），但仍然可以從PHP內(nèi)部調(diào)用。但是，為了使此函數(shù)在我們應(yīng)用一些數(shù)學(xué)運(yùn)算（例如“echo $a->add($b)->sub($c)”）後能夠在Complex對(duì)像上調(diào)用，我們需要在已編譯的擴(kuò)展中顯式註冊(cè)它：

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

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

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

我們?cè)赑HP-CPP存儲(chǔ)庫(kù)中提交的問(wèn)題Issue #150詳細(xì)討論了我們必須這樣做的原因。

鍊式成員函數(shù)調(diào)用

必須在此類中實(shí)現(xiàn)的一件事是能夠鏈接成員函數(shù)，以便我們可以進(jìn)行如下計(jì)算：$a->add($b)->sub($c)。結(jié)果仍然應(yīng)該能夠調(diào)用其成員函數(shù)。

這是通過(guò)上述方法完成的，即返回this指針到PHP。但是，較舊的PHP-CPP庫(kù)在取消引用對(duì)象時(shí)存在錯(cuò)誤，如果鏈接方法調(diào)用，則會(huì)創(chuàng)建“段錯(cuò)誤”。

已提交問(wèn)題（#151），並提交了包含PHP-CPP源代碼補(bǔ)丁的提交。如果您使用的是舊版本的PHP-CPP庫(kù)來(lái)編譯PHP-CPP庫(kù)和您自己的庫(kù)，請(qǐng)更新PHP源代碼並重新編譯和重新安裝PHP-CPP庫(kù)和您的庫(kù)。

如提交摘要所解釋：

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

我很高興我自己的項(xiàng)目工作可以幫助我使用的庫(kù)變得更好。

異常拋出和PHP中的處理

我們的Complex類中還有兩個(gè)函數(shù)可能會(huì)將異常拋回PHP進(jìn)行處理：div和phi。前者執(zhí)行除法運(yùn)算，後者返回複數(shù)的角度，如其替代表示形式極坐標(biāo)表示法（r，θ）所示。

如果將復(fù)數(shù)作為參數(shù)（或調(diào)用者）傳遞，但其實(shí)部和虛部為0，則這兩個(gè)操作都可能失敗。對(duì)於這兩個(gè)操作，我們需要進(jìn)行異常處理。請(qǐng)記住，我們要在C 代碼中拋出異常，而PHP腳本將捕獲異常並進(jìn)行必要的處理：

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);

很簡(jiǎn)單，對(duì)吧？在我們的擴(kuò)展中構(gòu)造的C 異常被傳回PHP並被正確捕獲。此外，我們可以像處理其他PHP代碼拋出的原生PHP異常一樣操作異常！

測(cè)試所有函數(shù)

最後，我們可以通過(guò)make && sudo make install為我們的PHP安裝編譯和安裝complex.so擴(kuò)展。如果一切順利，我們可以通過(guò)在終端中發(fā)出以下命令來(lái)驗(yàn)證擴(kuò)展的安裝：

<code>修復(fù)問(wèn)題#151，鏈?zhǔn)椒椒ㄕ{(diào)用無(wú)法正常工作……
……因?yàn)槊總€(gè)對(duì)象的引用計(jì)數(shù)未正確更新，這導(dǎo)致即使對(duì)象已分配給不同的變量，該對(duì)象也會(huì)被銷毀。</code>

終端應(yīng)該顯示一行顯示“/etc/php5/cli/conf.d/complex.ini”，我們可以確定我們的擴(kuò)展已安裝並準(zhǔn)備由任何PHP腳本調(diào)用。

注意：如果我們檢查此擴(kuò)展的Makefile，我們將看到我們正在將此PHP擴(kuò)展安裝到其CLI環(huán)境中。如果我們想安裝此擴(kuò)展以便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;
}

此擴(kuò)展的測(cè)試PHP腳本如下所示，並帶有一些註釋：

$a=new tr\Complex(1,2);
$c=new tr\Complex(); //$c實(shí)際上是0+0i

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

所有測(cè)試腳本都應(yīng)該正確運(yùn)行，並且異常被正確捕獲。

結(jié)論

這總結(jié)了我關(guān)於使用C 構(gòu)建PHP擴(kuò)展的這個(gè)強(qiáng)大庫(kù)的3篇文章系列。我們介紹了基礎(chǔ)知識(shí)、面向?qū)ο蠓矫嬉约懊嫦驅(qū)ο缶幊讨械囊恍└呒?jí)主題。我們還幫助PHP-CPP有所改進(jìn)。

我們還能用PHP-CPP做什麼？我將引用幾行我從Emiel Bruijntjes（PHP-CPP的合著者）收到的電子郵件通信：

如果您正在從事一個(gè)項(xiàng)目，並且具有以下一個(gè)或多個(gè)要求，則PHP-CPP庫(kù)是理想的選擇： – 您正在處理軟件/數(shù)據(jù)結(jié)構(gòu)/算法，並且您希望確保將來(lái)您的軟件也可以用於非PHP項(xiàng)目。 – 您想使用尚未作為PHP擴(kuò)展提供的工具或庫(kù)。 – 您希望獲得C/C 代碼的更好性能（與PHP相比），但您還想構(gòu)建結(jié)構(gòu)化、面向?qū)ο蟮拇a，以便其他開發(fā)人員/同事易於理解和維護(hù)。

可能性是巨大的：框架（如Phalcon）、模板語(yǔ)言（如Smarty或Twig）等等。

請(qǐng)留下您的評(píng)論和觀點(diǎn)，讓我們知道您使用此庫(kù)做了什麼！

使用C 開發(fā)PHP擴(kuò)展的常見(jiàn)問(wèn)題解答

使用C 開發(fā)PHP擴(kuò)展的好處是什麼？

使用C 開發(fā)PHP擴(kuò)展具有多種好處。首先，它允許您在PHP應(yīng)用程序中利用C 的強(qiáng)大功能和靈活性。這可以提高性能，尤其是在計(jì)算密集型任務(wù)中。其次，它提供了一種在PHP環(huán)境中重用現(xiàn)有C 代碼的方法，這可以節(jié)省大量的開發(fā)時(shí)間和精力。最後，它使您能夠創(chuàng)建自定義PHP擴(kuò)展，這些擴(kuò)展可以擴(kuò)展PHP的功能並提供標(biāo)準(zhǔn)PHP庫(kù)中不可用的功能。

如何開始使用C 進(jìn)行PHP擴(kuò)展開發(fā)？

要開始使用C 進(jìn)行PHP擴(kuò)展開發(fā)，您需要對(duì)PHP和C 編程語(yǔ)言都有基本的了解。您還需要安裝PHP開發(fā)環(huán)境和C 編譯器。安裝這些先決條件後，您可以開始用C 編寫PHP擴(kuò)展。網(wǎng)上有很多資源可用，包括教程和示例代碼，可以指導(dǎo)您完成此過(guò)程。

什麼是PHP-CPP，它如何幫助PHP擴(kuò)展開發(fā)？

PHP-CPP是一個(gè)用於使用C 開發(fā)PHP擴(kuò)展的庫(kù)。它提供了一組C 類和方法，簡(jiǎn)化了編寫PHP擴(kuò)展的過(guò)程。使用PHP-CPP，您可以以更自然和直觀的方式編寫PHP擴(kuò)展，使用C 熟悉的語(yǔ)法和概念。這可以使開發(fā)過(guò)程更高效，並且減少錯(cuò)誤。

我可以將PHP-CPP用於商業(yè)項(xiàng)目嗎？

是的，PHP-CPP是開源軟件，可用於個(gè)人和商業(yè)項(xiàng)目。但是，重要的是要理解，雖然庫(kù)本身是免費(fèi)的，但您可能需要投入時(shí)間和資源來(lái)學(xué)習(xí)如何有效地使用它以及維護(hù)您的PHP擴(kuò)展。

使用C 進(jìn)行PHP擴(kuò)展開發(fā)的一些常見(jiàn)挑戰(zhàn)是什麼，我該如何克服它們？

使用C 進(jìn)行PHP擴(kuò)展開發(fā)的一些常見(jiàn)挑戰(zhàn)包括正確管理內(nèi)存、處理錯(cuò)誤和異常以及PHP和C 之間的接口?？梢酝ㄟ^(guò)深入了解PHP和C 、使用良好的編程實(shí)踐以及利用PHP-CPP提供的功能和工具來(lái)克服這些挑戰(zhàn)。

如何調(diào)試用C 編寫的PHP擴(kuò)展？

可以使用標(biāo)準(zhǔn)C 調(diào)試工具調(diào)試用C 編寫的PHP擴(kuò)展。此外，PHP-CPP提供了一些可以幫助調(diào)試的功能，例如異常處理和錯(cuò)誤報(bào)告。

我可以將PHP-CPP與其他C 庫(kù)一起使用嗎？

是的，PHP-CPP可以與其他C 庫(kù)一起使用。這使您可以利用PHP擴(kuò)展中的各種C 功能。

如何提高用C 編寫的PHP擴(kuò)展的性能？

您可以通過(guò)使用高效的算法和數(shù)據(jù)結(jié)構(gòu)、最大限度地減少內(nèi)存使用以及優(yōu)化C 代碼來(lái)提高PHP擴(kuò)展的性能。此外，PHP-CPP提供了一些可以幫助提高性能的功能，例如直接訪問(wèn)PHP變量和函數(shù)。

我可以為PHP-CPP項(xiàng)目貢獻(xiàn)代碼嗎？

是的，PHP-CPP項(xiàng)目是開源的，歡迎社區(qū)的貢獻(xiàn)。您可以通過(guò)報(bào)告錯(cuò)誤、建議新功能或提交補(bǔ)丁來(lái)貢獻(xiàn)代碼。

在哪裡可以找到更多關(guān)於使用C 進(jìn)行PHP擴(kuò)展開發(fā)的資源？

網(wǎng)上有很多資源可用於學(xué)習(xí)使用C 進(jìn)行PHP擴(kuò)展開發(fā)。這些資源包括教程、示例代碼、文檔和論壇。此外，PHP-CPP網(wǎng)站提供了大量關(guān)於使用該庫(kù)的信息和資源。

以上是使用C和PHP-CPP開發(fā)PHP擴(kuò)展：高級(jí)的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！