CおよびPHP-CPPを使用してPHP拡張機(jī)能を開(kāi)発：高度なトピックとベストプラクティス

キーポイント

CおよびPHP-CPPを使用したPHP拡張の開(kāi)発には、「この」ポインターの返卻、複雑なオブジェクトポインターの返卻、魔法のメソッドの公開(kāi)、メンバー関數(shù)呼び出しのリンク、PHPでの例外スローと処理などの高度なトピックが含まれます。
• __toStringPHP-CPPライブラリは、將來(lái)の非PHPプロジェクトにソフトウェア、データ構(gòu)造、またはアルゴリズムを必要とするプロジェクト、またはPHP拡張としてまだ提供されていないツールまたはライブラリを使用する必要があるプロジェクトに最適です。また、理解とメンテナンスを容易にするために、構(gòu)造化されたオブジェクト指向のコードを維持しながら、C/Cコードのパフォーマンスの利點(diǎn)を提供します。
• PHP-CPPライブラリは、個(gè)人および商業(yè)プロジェクトに使用できます。ただし、ライブラリ自體は無(wú)料ですが、効果的に使用する方法を?qū)Wび、PHP拡張機(jī)能を維持するには時(shí)間とリソースがかかる場(chǎng)合があります。
• Cを使用したPHP拡張開(kāi)発の一般的な課題には、メモリの正しい管理、エラーと例外の取り扱い、およびPHPとCの間のインターフェイスが含まれます。これらの課題は、PHPとCへの洞察を得て、優(yōu)れたプログラミングプラクティスを使用し、PHP-CPPが提供する機(jī)能とツールを活用することで克服できます。
以前の投稿では、C（最初と2番目の投稿）を使用してPHP拡張機(jī)能を作成するPHP-CPPライブラリを紹介しました。後者の投稿では、複數(shù)の操作に複雑なクラスを使用してPHP拡張機(jī)能を作成するオブジェクト指向の側(cè)面を示します。

この紹介は完全ではありません。なぜなら、記事の主な焦點(diǎn)は、オブジェクト指向の実裝の詳細(xì)よりもPHP-CPPのオブジェクト指向の機(jī)能を?qū)g証することであるからです。 この記事では、複雑なライブラリの開(kāi)発にさらに飛び込み、メンバー関數(shù)を追加し、PHP-CPPを使用してオブジェクト指向のPHP拡張機(jī)能を書く際にいくつかの高度なトピックに対処します。

このポインターを返します

複雑なオブジェクトポインター、つまり複合體 *

open

Magic Method;

チェーンメンバー関數(shù)呼び出し
• 例外の上に、php
で処理します
完全な複雑なライブラリソースコードとテストPHPスクリプトは、このgithubリポジトリにあります。
• __toString始めましょう。
• 準(zhǔn)備

環(huán)境を準(zhǔn)備するプロセス全體を最初の記事で説明します。

このポインターをc メンバー関數(shù)を使用して、複雑な數(shù)値でさまざまな數(shù)學(xué)操作を?qū)g行します。このデモンストレーションでは、そのような機(jī)能を4つ実裝します：add、sub、mul、およびdiv。最初の3つについて説明します。 DIV関數(shù)には例外処理が含まれ、後で説明します。

MUL関數(shù)を見(jiàn)てみましょう（乗算用）。追加およびサブ機(jī)能はほぼ同じです。

注：この記事では、MakeFileおよびINIファイルの変更、メンバーの機(jī)能、クラス、名前空間などの登録など、以前に説明したいくつかの基本的なトピックを紹介しません。これらの內(nèi)容については、前のセクションを參照してください。

このポインターをCからPHPに戻すのは簡(jiǎn)単です。このC関數(shù)內(nèi)では、このポインター（複雑な*タイプとして）をPHP :: valueタイプとしてPHPに返すことができます。変換はオブジェクト情報(bào)を失うことはありません。また、明示的なタイプ変換は必要ありません。

複雑なオブジェクトポインターを返します

これを返すことは、通常、オブジェクト自體が変更されたことを意味します。ただし、場(chǎng)合によっては、新しいオブジェクトを返して、「現(xiàn)在」オブジェクト（コールオブジェクト）を変更しておきたいと思う場(chǎng)合があります。

複雑なクラスでは、特定の複雑な數(shù)のコンジュゲート數(shù)を返す関數(shù)（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 ::オブジェクトを使用して複雑な*オブジェクトをPHP ::オブジェクトに明示的に変換する必要があることです。そのアクセシビリティ。

この関數(shù)の最初のパラメーターは、クラスタイプ、この場(chǎng)合はtrcomplexです。このクラス（「複雑な」）を別の名前空間（ "TR"）に巻き付けたので、私はこの名前を使用しています。

2番目のパラメーターは、渡されるオブジェクトです。

新しいクラスインスタンスを返すことは、このポインターを返すよりも少し難しいですが、ドキュメントを読んで正しい部分を見(jiàn)つけている限り、管理しやすいです。その他の使用例については、公式のPHP-CPPドキュメントでこのセクションをお読みください。

オープン__toString Magic Method

私たちのクラスでは、複數(shù)の數(shù)字をより読みやすい方法で印刷する関數(shù)、たとえば1 2iがあります。私の以前の投稿では、この関數(shù)は公開(kāi)されていません（またはPHP-CPP用語(yǔ)で「登録」されていませんが、內(nèi)部PHPから呼び出すことができます。ただし、數(shù)學(xué)的操作を適用した後に複雑なオブジェクトにこの関數(shù)を呼び出すために（例：「echo $ a-＆gt; add（$ b） - ＆gt; sub（$ c）」）、コンパイルする必要があります拡張機(jī)能に明示的に登録されています：

__toStringPHP-CPPリポジトリの問(wèn)題＃150で提出した問(wèn)題では、なぜこれを行わなければならないのかを詳細(xì)に説明しています。

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

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

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

チェーンメンバー関數(shù)呼び出し

このクラスで実裝する必要があることの1つは、メンバー関數(shù)をリンクできるようにすることです。これにより、次の計(jì)算を行うことができます。結(jié)果は、メンバー関數(shù)を呼び出すことができるはずです。 これは上記の方法、つまりこのポインターをPHPに返すことによって行われます。ただし、古いPHP-CPPライブラリには、オブジェクトを參照した場(chǎng)合、リンクメソッドが呼び出された場(chǎng)合、「セグメント障害」が作成されます。

問(wèn)題が提出され（＃151）、PHP-CPPソースコードパッチを含むコミットが送信されました。 PHP-CPPライブラリの古いバージョンを使用してPHP-CPPライブラリと獨(dú)自のライブラリをコンパイルしている場(chǎng)合は、PHPソースコードを更新し、PHP-CPPライブラリとライブラリを再コンパイルして再インストールしてください。

提出概要で説明されているように、

私自身のプロジェクトの仕事が、私が使用する図書館がより良くなるのを助けることができてうれしいです。

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

php

のスローと処理の例外

複雑なクラスでさらに2つの関數(shù)が、処理のために例外をPHPに戻すことができます：DivとPhi。前者は分割操作を?qū)g行しますが、後者はその代替表現(xiàn)である極座標(biāo)表現(xiàn)（r、θ）に示されているように、複雑な數(shù)の角度を返します。

複數(shù)の數(shù)値をパラメーター（または発信者）として渡すが、パーツと想像上の部分が実際に0の場(chǎng)合、両方の操作が失敗する可能性があります。これら2つの操作については、例外処理を?qū)g行する必要があります。 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);
}

とても簡(jiǎn)単ですよね？拡張機(jī)能で構(gòu)築されたC例外はPHPに渡され、正しくキャッチされます。さらに、他のPHPコードでスローされたネイティブPHP例外を処理するなど、例外を操作できます！

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

すべての関數(shù)をテスト

最後に、complex.soの拡張機(jī)能をコンパイルしてインストールできます。すべてがうまくいけば、端末に次のコマンドを発行することにより、拡張機(jī)能のインストールを確認(rèn)できます。

端子には、「/etc/php5/cli/conf.d/complex.ini」というラインを表示する必要があります。拡張機(jī)能がインストールされ、PHPスクリプトで呼び出される準(zhǔn)備ができていることを確認(rèn)できます。

make && sudo make install注：この拡張機(jī)能のMakeFileを確認(rèn)すると、このPHP拡張機(jī)能をCLI環(huán)境にインストールしていることがわかります。 Apacheがロードできるようにこの拡張機(jī)能をインストールする場(chǎng)合は、次の行を変更します。

この拡張機(jī)能のテストPHPスクリプトは次のとおりで、いくつかのメモがあります。

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

すべてのテストスクリプトは正しく実行され、例外が正しくキャッチされます。

結(jié)論

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

これは、この強(qiáng)力なライブラリの構(gòu)築に関する3つの記事シリーズをまとめたものです。オブジェクト指向プログラミングの基本、オブジェクト指向の側(cè)面、およびいくつかの高度なトピックについて説明します。また、PHP-CPPの改善を支援しました。

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

php-cppで他に何ができますか？ Emiel Bruijntjes（PHP-CPPの共著者）から受け取った電子メール通信の數(shù)行を引用してください：

プロジェクトに取り組んでいて、次の要件の1つ以上がある場(chǎng)合、PHP-CPPライブラリは理想的です。 - ソフトウェア/データ構(gòu)造/アルゴリズムに取り組んでおり、將來(lái)的にはソフトウェアも非PHPプロジェクトでも使用できることを確認(rèn)する必要があります。 - PHP拡張機(jī)能としてまだ利用できないツールまたはライブラリを使用する必要があります。 - C/Cコード（PHPと比較）のパフォーマンスが向上しますが、他の開(kāi)発者/同僚による理解とメンテナンスのために、構(gòu)造化されたオブジェクト指向のコードも構(gòu)築する必要があります。

可能性は非常に大きい：フレームワーク（ファルコンなど）、テンプレート言語(yǔ)（SmartyやTwigなど）など。

コメントや意見(jiàn)を殘して、このライブラリで何をしたか教えてください！

c

を使用したPHP拡張の開(kāi)発に関するFAQ

Cを使用してPHP拡張機(jī)能を開(kāi)発することの利點(diǎn)は何ですか？

Cを使用してPHP拡張機(jī)能を開(kāi)発することには多くの利點(diǎn)がありますまず、PHPアプリケーションでのCのパワーと柔軟性を活用できます。これにより、特に計(jì)算集約型のタスクでのパフォーマンスが向上します。第二に、PHP環(huán)境で既存のCコードを再利用する方法を提供します。これにより、多くの開(kāi)発時(shí)間と労力を節(jié)約できます。最後に、PHPの機(jī)能を拡張し、標(biāo)準(zhǔn)のPHPライブラリでは利用できない機(jī)能を提供するカスタムPHP拡張機(jī)能を作成できます。

PHP拡張開(kāi)発のためにCの使用を開(kāi)始する方法は？

PHP拡張開(kāi)発にCの使用を開(kāi)始するには、PHPおよびCプログラミング言語(yǔ)を基本的に理解する必要があります。また、PHP開(kāi)発環(huán)境とCコンパイラをインストールする必要があります。これらの前提條件をインストールした後、CでPHP拡張機(jī)能の書き込みを開(kāi)始できます。このプロセスをガイドするためのチュートリアルやサンプルコードなど、オンラインで利用可能な多くのリソースがあります。

PHP-CPPとは何ですか？PHP拡張の開(kāi)発にどのように役立ちますか？

PHP-CPPは、Cを使用してPHP拡張機(jī)能を開(kāi)発するためのライブラリです。 Cクラスとメソッドのセットを提供し、PHP拡張機(jī)能を作成するプロセスを簡(jiǎn)素化します。 PHP-CPPを使用すると、Cのおなじみの構(gòu)文と概念を使用して、より自然で直感的な方法でPHP拡張機(jī)能を記述できます。これにより、開(kāi)発プロセスがより効率的になり、エラーを減らすことができます。

商用プロジェクトにPHP-CPPを使用できますか？

はい、PHP-CPPは、個(gè)人および商業(yè)プロジェクトで使用できるオープンソースソフトウェアです。ただし、ライブラリ自體が無(wú)料である間、効果的に使用する方法を?qū)Wび、PHP拡張機(jī)能を維持するために時(shí)間とリソースを投資する必要がある場(chǎng)合があることを理解することが重要です。

Cを使用したPHP拡張開(kāi)発の一般的な課題は何ですか？また、それらを克服するにはどうすればよいですか？

Cを使用したPHP拡張開(kāi)発のいくつかの一般的な課題には、メモリの正しい管理、エラーと例外の取り扱い、およびPHPとCの間のインターフェイスが含まれます。これらの課題は、PHPとCへの洞察を得て、優(yōu)れたプログラミングプラクティスを使用し、PHP-CPPが提供する機(jī)能とツールを活用することで克服できます。

cで記述されたPHP拡張機(jī)能をデバッグする方法は？

Cで記述されたPHP拡張機(jī)能は、標(biāo)準(zhǔn)のCデバッグツールを使用してデバッグできます。さらに、PHP-CPPは、例外処理やエラーレポートなど、デバッグを支援できるいくつかの機(jī)能を提供します。

他のCライブラリでPHP-CPPを使用できますか？

はい、PHP-CPPは他のCライブラリで使用できます。これにより、PHP拡張機(jī)能のさまざまなC機(jī)能を活用できます。

Cで記述されたPHP拡張機(jī)能のパフォーマンスを改善する方法は？

効率的なアルゴリズムとデータ構(gòu)造を使用し、メモリ使用量を最小限に抑え、Cコードを最適化することにより、PHP拡張機(jī)能のパフォーマンスを改善できます。さらに、PHP-CPPは、PHP変數(shù)や関數(shù)への直接アクセスなど、パフォーマンスを改善するのに役立ついくつかの機(jī)能を提供します。

PHP-CPPプロジェクトにコードを提供できますか？

はい、PHP-CPPプロジェクトはオープンソースであり、コミュニティの貢獻(xiàn)は歓迎されます。バグを報(bào)告したり、新機(jī)能を提案したり、パッチを送信したりすることで、コードを貢獻(xiàn)できます。

PHP拡張開(kāi)発にCを使用することに関するリソースをどこで見(jiàn)つけることができますか？

PHP拡張開(kāi)発にCを使用することを?qū)W習(xí)するためにオンラインで利用できる多くのリソースがあります。これらのリソースには、チュートリアル、サンプルコード、ドキュメント、フォーラムが含まれます。さらに、PHP-CPP Webサイトは、ライブラリの使用に関する大量の情報(bào)とリソースを提供しています。

以上がCおよびPHP-CPPを使用したPHP拡張機(jī)能の開(kāi)発：Advancedの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。