PHP 拡張機能の開発: 独自のインターフェイスクラスの開発-PHPチュートリアル-php.cn

PHP 拡張機能の開発: 独自のインターフェイスクラスの開発

不言

リリース： 2023-03-23 18:34:02

オリジナル

1773 人が閲覧しました

この記事の内容は、PHP 拡張機能の開発における独自のインターフェイスクラスの開発に関するものであり、必要とする友人はそれを参照できます。

PHP 拡張機能は、上級 PHP プログラマーが理解する必要があるスキルの 1 つです。 PHP 拡張機能の開発者は、どうすれば成熟した拡張機能を開発し、PHP 開発の高度な分野に参入できるでしょうか?この一連の開発チュートリアルでは、入門段階から上級段階まで段階的に説明します。
このチュートリアルシリーズは Linux (centos を推奨) で開発されており、PHP バージョンは 5.6 で、一定の Linux 操作経験と C/C++ の基礎があることを前提としています。
ご質問があり、連絡する必要がある場合は、QQ 技術交換グループ 32550793 に参加して私と連絡してください。

前の章では、PHP 拡張機能で通常の関数をエクスポートする方法を説明しました。この章では、拡張機能でクラスをエクスポートする方法を紹介します。 PHP がスクリプト内の拡張機能の C++ クラスに直接アクセスできるようにします。

1. PHP 拡張機能で C++ クラスをエクスポートする方法

以下は、PHP-CPP を使用して開発された拡張スケルトンコードであり、デモンストレーション C++ クラスをエクスポートできます。

プロジェクトのソースコードは github にあります。git クライアントを使用するか、URL を開いてパッケージ化してダウンロードできます。

# git clone https://github.com/elvisszhang/phpcpp_counter.git

ログイン後にコピー

今回のクラス名はCounterです。拡張機能にクラスを登録するための構文は次のとおりです。

Php::Class<Counter> counter("Counter");

ログイン後にコピー

Counterクラスにはincrementと呼ばれる関数があり、次の構文を使用して拡張機能にPHPスクリプトに許可を与えます。この機能にアクセスします。

counter.method<&Counter::increment> ("increment");

ログイン後にコピー

main.cppのC++ソースコードは以下の通りです。

#include <phpcpp.h>
#include <time.h>

//扩展的导出类 Counter
class Counter : public Php::Base
{
private:
    int _value = 0;
public:
    Counter() = default;
    virtual ~Counter() = default;
    //类的普通成员函数
    Php::Value increment() { return ++_value; }
    Php::Value decrement() { return --_value; }
    Php::Value value() const { return _value; }
    //类的静态成员函数
    static Php::Value gettime() {return time();}
};

//告诉编译器get_module是个纯C函数
extern "C" {
    //get_module是扩展的入口函数
    PHPCPP_EXPORT void *get_module() {
        static Php::Extension myExtension("counter", "1.0.0");
        
        //初始化导出类
        Php::Class<Counter> counter("Counter");
        
        //注册导出类的可访问普通函数
        counter.method<&Counter::increment> ("increment");
        counter.method<&Counter::decrement> ("decrement");
        counter.method<&Counter::value> ("value");
        
        //注册导出类的可访问静态函数
        counter.method<&Counter::gettime>("gettime");

        //注册导出类，使用右值引用方式，优化资源使用
        myExtension.add(std::move(counter));
        
        //返回扩展对象指针
        return myExtension;
    }
}

ログイン後にコピー

上記の例に対応するphpテストコードは以下の通りです。

<?php
$counter = new Counter;
echo &#39;result of increment() = &#39;. $counter->increment() . PHP_EOL;
echo &#39;result of increment() = &#39;. $counter->increment() . PHP_EOL;
echo &#39;result of decrement() = &#39;. $counter->decrement() . PHP_EOL;
echo &#39;result of value() = &#39;. $counter->value() . PHP_EOL;
echo &#39;result of gettime() = &#39;. Counter::gettime() . PHP_EOL;
?>

ログイン後にコピー

上記のphpコードを実行した後の出力情報は以下の通りです。

result of increment() = 1
result of increment() = 2
result of decrement() = 1
result of value() = 1
result of gettime() = 1523363778

ログイン後にコピー

2. 拡張クラスの通常関数がサポートするスタイル

拡張クラスの関数は一定の仕様に従って記述する必要があり、戻り値やパラメータの名前や型は全て指定されています。そうしないと、PHP スクリプトによって認識されません。

最も一般的なのは次の 4 つの関数スタイルです。これらは実際には前の章の通常の関数スタイルと同様であり、戻り値とパラメーターの使用法もまったく同じであるため、ここでは詳しく説明しません。。

// signatures of supported regular methods
void        YourClass::example1();
void        YourClass::example2(Php::Parameters &params);
Php::Value  YourClass::example3();
Php::Value  YourClass::example4(Php::Parameters &params);

ログイン後にコピー

さらに、関数に修飾子 const が付いている場合。以下の 4 つの異なるスタイルもあります。

void        YourClass::example5() const;
void        YourClass::example6(Php::Parameters &params) const;
Php::Value  YourClass::example7() const;
Php::Value  YourClass::example8(Php::Parameters &params) const;

ログイン後にコピー

3. 参考資料

PHP-CPP ヘルプ:classes-and-objects

PHP 拡張機能は、初心者の PHP 拡張機能開発者にとって、どのように開発すればよいかを理解する必要があるスキルの 1 つです。本格的な拡張と PHP 開発の高度な領域への参入?この一連の開発チュートリアルでは、入門段階から上級段階まで段階的に説明します。
このチュートリアルシリーズは Linux (centos を推奨) で開発されており、PHP バージョンは 5.6 で、一定の Linux 操作経験と C/C++ の基礎があることを前提としています。
ご質問があり、連絡する必要がある場合は、QQ 技術交換グループ 32550793 に参加して私と連絡してください。