PHPモジュールはまだシンプルです。 パート2

nerezusが PHPの埋め込みに関する記事を書いている間、拡張機能の記述に関する彼の話を続けようとします。 複雑さは徐々に構築されるべきだと考えているため、すべてが語られるわけではありません。 この点については、クラスの演算子を置き換える方法についてはまだ説明しません。PHP拡張機能の開発に関する情報の主な著者であるSarah Golemonから、Operatorモジュールのソースコードを読みたい人は誰でも。

私はLinuxのみで開発を行っているため、ペンを使用してVisual Studio用のトリッキーなアドオンを作成せずにゼロから作成します:)さて、すぐに理解してから作業を簡素化する方が良いでしょう。



まず、 config.m4とMakefileの 2つのファイルを作成する必要があります。 最初の拡張機能は拡張機能を構築するために必要であり、2番目の拡張機能は...このアセンブリがカタログをソースコードで損なわないようにするためです:)

1. config.m4

それでは始めましょう。 アセンブリ用のファイルを書くことはあまり面白くないので、それらを渡して何が何なのかを説明します。 ここに設定の一般的なビューがあります。

dnlで始まる行はコメントです。

最初の2行は--enable-mystringオプションを追加してビルドします。 そのため、PHPソースの/ ext /フォルダーにモジュールを配置し、PHPをビルドするかどうかを選択できます。

1-2行目をコメントアウトして3-4行目をコメント解除すると、オプションでパスを指定できる--with-mystringオプションが表示されます。 なんで？ ファイルに残っているすべての行について:)特定のライブラリ（この例ではmylib1およびmylib2ライブラリを指定）を使用する場合、設定時にパスを渡すことができます。 実際、12〜29行目でこれらのライブラリを見つけて接続しようとしています。

次に、9行目に注意してください。これにより、構成用の変数<MODULE_NAME> _SHARED_LIBADDが追加され、リンク用のライブラリが追加されます。 一般に、m4には任意の変数名ではなく厳密な変数名が必要であるという事実に慣れてください。 これはスパルタです。

33〜35行目では、最も一般的なライブラリをリンクに追加します-それらを検索する必要はありません。

36行目では、どのファイルから拡張機能を構築する必要があるかを示しています。

行32はさらに、モジュールをCではなくC ++で作成していることを示しています（モジュールを作成する場合-違いはわずかですが、プラスライブラリまたはプラスコードを接続する場合は必要になります）。

今回は何も接続しないため 、設定を大幅に短縮します。 たった10行-これ以上はありません。

2. Makefile

メイクファイルは、自尊心のあるプログラマーが人生で少なくとも一度は書いたことがあると思うので、説明は必要ありません。 ですから、を使用します 。 `php-config --extension-dir`コマンドはPHP拡張機能が保存されているディレクトリを提供し、 __ buildディレクトリはすべてを収集するディレクトリであることに注意してください。

3. mystring.hファイルを作成します

今何が必要ですか？ まともなC / C ++プログラムのように-ヘッダーファイルとコードファイル。 ヘッダーから始めましょう。 ファイルも40行未満のシンプルなものになります。 それを見てみましょう。

行4〜5では、拡張機能の名前とバージョンを宣言します。 これは、モジュール情報の後半でこの貴重な情報を表示するためだけに必要です。

行7は、クラスの名前を示しています。 もちろん、「mystring」の記述はPHP_MYSTRING_CLASS_NAMEよりも短いですが、いつでも1か所でクラス名を変更できます。 たとえば、クラスの名前を「Mystring」に変更します-大文字を使用し、適切な人々に適しています。

9行目から11行目には、アセンブリプロセス中に生成されるconfig.hファイルが含まれています-自分で作成することはありません。

次に、標準ヘッダーを含めて、関数を宣言します。 ここで詳しく説明します。 関数PHP_MINIT_FUNCTIONおよびPHP_MSHUTDOWN_FUNCTIONは、モジュールのロードおよびアンロード時に実行される関数です。 それらに加えて、 * _GINIT_ *および* _GSHUTDOWN_ *-PHPをグローバルに起動/アンロードするための関数、および* _RINIT_ *および* _RSHUTDOWN_ * -モジュールをアクティブ化/非アクティブ化するときがあります。 PHP_MINFO_FUNCTION関数は、 phpinfo（）が呼び出されたときに実行される関数で、モジュールに関する情報を生成します。

次に、いくつかのメソッドを宣言します-最初の部分で、 PHP_FUNCTIONマクロを使用してそれらを宣言しましたが、それらはグローバルでしたか？ ここでは、基本的に同じことを行っています。マクロのみが、クラスとそのメソッドの名前という2つのパラメーターを取ります。

さて、35行目の終わりに、モジュールを宣言します。

ヘッダーファイルには他に何も必要ありません。コードに進みます。

4.モジュールコードを記述します-mystring.cc

ここでは、コードはより複雑です。 残念ながら、それを記事に直接入れることはできませんでした-Habrは抗議しました-そこで私はすぐにすべてのコードをここに投稿しました 、ここではその内容のみを検討します。

1〜27行目

これまでのところ、すべてが単純です-将来のクラスを宣言し、モジュールを宣言します。 注意してください-名前、バージョン、および関数MINIT 、 MSHUTDOWNおよびMINFOを指定しました 。 今回はグローバル関数を宣言せず、 RINITとRSHUTDOWNも必要ありません。他のすべてはデフォルトと見なすことができます。

29〜49行目

これで、モジュールをPHPの一部としてだけでなく、拡張機能としてコンパイルできることをPHPに伝えるマクロを置き換えました。 その後、クラス関数のセットを発表しました。 各関数には、クラス名、関数の名前、 arg_info構造体へのポインター、およびアクセスパラメーターの4つのパラメーターが示されます。 arg_info構造の明確な説明に出会ったことがないため、古い方法でNULLを渡し、関数自体に既にあるパラメーターを確認します。

主なアクセスパラメータは、もちろんZEND_ACC_PUBLIC 、 ZEND_ACC_PROTECTEDおよびZEND_ACC_PRIVATEです。 それらに加えて、 ZEND_ACC_STATICまたはZEND_ACC_ALLOW_STATICを指定できます（このメソッドは静的および通常の両方で使用できます）。 コンストラクタ、デストラクタ、およびクローン演算子（PHPで__cloneの関数として宣言されている）の場合、フラグZEND_ACC_CTOR 、 ZEND_ACC_DTOR 、およびZEND_ACC_CLONEをそれぞれ指定する必要があります。

ただし、ヘッダーファイルで完全なリストを確認できます。私のマシンでは、これは/usr/include/php5/Zend/zend_compile.hファイルです。

PHP_ME（） を使用して説明した各メソッドの後に、カンマを入れる必要がないことに注意してください。 そして最後に、常に3つのNULLの配列があるはずです。

その間、先に進みます。

51〜76行目

以前に発表された3つの方法（ロード、アンロード、およびモジュール情報）が特定されました。 3つすべてのうち、1つだけに興味があります。モジュールのロードです。 まず、宣言したクラスを登録する必要があります。

次に、登録されたクラスにプロパティを作成します。登録されたクラスへのポインタ、プロパティの名前、この名前の長さ（この行については後ほど）、デフォルト値を渡し、再びアクセスパラメータを渡します。 最後に、マジックワードTSRMLS_CCを間違いなく記述する必要があります。 この言葉は特に言及する必要があります。 関数内でPHPの現在の状態を操作するには、現在の場所を知り、クラスに関する情報を取得する必要があります。 など、この情報を送信する必要があります。 これを行うには、関数を宣言するときに、最後にマクロTSRMLS_DCを記述し、 -TSRMLS_CCを呼び出す必要があります。 どちらの場合も、マクロの前にコンマを置く必要はありません 。

ここで、プロパティ名の長さに戻ります。 さまざまなソースのプロパティの宣言に関する情報は非常に少なく、矛盾しています。 したがって、同じSarah Golemonのマニュアルでは、プロパティがプライベートとして宣言されている場合、「 \ 0 class_name \ 0 property_name」という形式の名前を持っている必要があると記載されています。 実際には、 zend_mangle_property_nameを使用すると、プロパティへのアクセス時にPHPがダーティを誓うことがわかりましたが、上記の呼び出しではすべてが素晴らしいことです。 トピックに関する文献を読む場合は注意してください。

78〜106行目

それでは、標準クラスのメソッドを定義しましょう。 ポイントに行きましょう。

getThis（）関数は、メソッドを呼び出したクラスのオブジェクトへのポインターを返します。 コンストラクターとデストラクタについては、このポインターをチェックします。これらのメソッドを静的に呼び出さないようにします。 次に、コンストラクターで、この関数を示すために、既に宣言されているプロパティ「str」を変更します。 これを行うには、オブジェクト（クラス）の型、オブジェクト自体へのポインター、プロパティ名の名前と長さ、および新しい値を渡します。 * _string（）関数ではなく* _stringl（）を使用していることに注意してください-また、新しい値の長さを渡す必要があります。 原則として、文字列に文字「\ 0」が含まれる場合、または逆に文字列の最初のN文字のみを書き込みたい場合に使用されますが、 * _string（）オプションよりも少し速く動作するため、このような些細な状況で使用しますが、追加のパラメーターを設定してもかまいません。

同様に、関数でRETURN_STRINGLマクロを使用して、クラスを文字列にキャストします。 最後のパラメータ「1」に注意してください-これは、オブジェクト自体ではなく、そのコピーを転送することを意味します。 あなたは彼らが後で私たちのラインで何をしたいのか決してわかりません。

108行目から133行目

行を追加する方法を説明しましょう。

まず、文字列がパラメーターとして渡されたかどうかを確認します-これについては、最初の部分で既に説明しました。

次に、オブジェクトに格納されている文字列をオブジェクトから読み取ります。 プロパティを文字列として作成しましたが、ポインターがzvalに戻ったことに注意してください 。 事は、絶対にphpのすべてのデータ型がzval型で表されることです 。 どのように機能するかに興味がある場合は、ファイル/usr/include/php5/Zend/zend.hでstruct _zval_structとunion _zvalue_valueの定義を参照してください。

最後に、新しい行にメモリを割り当て、元の行と「アドイン」をそこにコピーします。 次に、使い慣れたzend_update_property_stringl（）メソッドを使用して、新しい値を書き込みます。 PHPでは、 malloc 、 calloc、およびfreeの代わりに、 emalloc 、 ecalloc、およびefreeの送信類似物を使用するのが習慣です 。

新しい値は必要な場所にあり、 NULLを返すことができます 。 宿題：オブジェクト自体を返す方法を把握して、 $ a-> append（ "a"）-> append（ "b"）という形式のチェーンを作成できるようにします...

135行目から148行目

最後に、比較メソッドを実装します。 その中で、実際の比較を実装しません（悪魔はこのメソッドを呼び出す理由を知っています）が、行を印刷します-少なくともどこかに表示する必要があります-そして少し魔法を示します。

まず、文字列strを読み取って出力します。 お気づきかもしれませんが、 zend_printf（）関数の構文は、標準のprintf（）とまったく同じです。 そして...それは何ですか？ はい、私たちは簡単かつ制約なくPHPコードを取得して実行しました。 パラメーターとして、コードの行、変数へのポインター、実行結果を配置する場所、およびスクリプトの名前を渡します。 何も発明しないように、myvardumpを作成しました。

まとめ

` make all install`と入力します 。 次のように入力します。php -r '$ s = new mystring（）; echo $ s。 "\ n"; $ s-> append（ "Popyachso！"）; $ s-> compare（）; ' 、出力を見てください：

mystring

upchk !

object(mystring)#1 (1) {

["str:private"]=>

string(21) "upchk !"

}

最初の行は、クラスの行へのキャストを推測したことです（__toString（）を参照）。 2番目-すでに変更された文字列strを出力します。 そして残りの3行は、クラスのダンプであるzend_eval_stringの結果です。 作成された私有財産を観察します-すべてが公正です。

次は？

まず、自己PRの一環として、最近書いた拡張機能のみをチェックアウトすることをお勧めします。

svn checkout http://dingo-php.googlecode.com/svn/trunk/ dingo-php

ほとんどのユーザーにとって、拡張機能自体は実際のアプリケーションの観点からはまったく面白くないでしょうが、次のように見ることができます。

-コンパイル中にオン/オフできる1つの拡張機能で複数のクラスを作成する方法

-サードパーティのライブラリをラップして使用する方法

-まあ、実際のコードのビット

さらに、サラゴレモンの本をお勧めします。

>> サラゴレモン「PHPの拡張と埋め込み」

ロシアでは、かなりの量のテンゲがかかりますが、インターネット上である程度の努力をすれば、電子版を見つけることができます。

この本は少し時代遅れですが、RINIT / RSHUTDOWNが必要な理由、クラスに発生するイベントにハンドラーを掛ける方法、ストリームを作成する方法、ini-configを操作する方法、およびオブジェクトでさらに多くのことを行う方法を見つけることができます。



Ps実験のためにコピーアンドペーストするのが面倒な人のために、コンパイルの準備ができたモジュールを含むアーカイブを投稿しました： narod.ru/disk/15177450000/mystring.tar.gz.html