PHP拡張子の書き方

すべての php 拡張機能の構築には、少なくとも 2 つのファイルが必要です。1 つはコンパイル時にどのファイルを構築するか、どの外部ライブラリが必要かを指示する構成ファイル、もう 1 つは実際の作業を実行する 1 つ以上のソース ファイルです。拡張子

実際には、通常は 2 つ目または 3 つ目の

config ファイル

と、1 つ以上のヘッダー ファイルがあり、最初の拡張子には、各タイプのファイルを 1 つ追加して操作する必要があります。 設定ファイル

まず、php ソース コード ディレクトリ ツリーの ext/ ディレクトリに、sample という名前のディレクトリを作成します。実際、この新しいディレクトリはどこにでも配置できますが、これは後ほど win32 と static を説明するためです。章 ビルド オプションについては、まずソース コード ディレクトリにビルドしましょう

次に、このディレクトリに入り、config.m4 という名前のファイルを作成し、次の内容を入力します:

PHP_ARG_ENABLE(sample,  
  [Whether to enable the "sample" extension],  
  [  enable-sample        Enable "sample" extension support])  
      
if test $PHP_SAMPLE != "no"; then  
  PHP_SUBST(SAMPLE_SHARED_LIBADD)  
  PHP_NEW_EXTENSION(sample, sample.c, $ext_shared)  
fi

これは、実行中に呼び出すことができる有効なオプションです。 ./configure サンプル オプションの最小要件。 ./configure の処理中にこの拡張設定ファイルに到達すると、PHP_ARG_ENABLE の 2 番目の引数が表示されます。エンド ユーザーが ./configure -- を実行すると、3 番目の引数がヘルプ情報として表示されます。

なぜ一部の拡張機能設定では enable-extname が使用され、他の機能では with-extname が使用されるのか疑問に思ったことはありますか? 実際、enable は、この機能を有効にするのに他のサードパーティが必要ないことを意味します。対照的に、 with は、こ​​の機能を使用するための他の前提条件があることを示します

ここで、サンプル拡張機能を他のライブラリにリンクする必要がないため、第 17 章「外部ライブラリ」で使用する必要があるのは、有効なバージョンだけです。では、with の使用を導入し、追加の CFLAGS および LDFLAGS 設定を使用するようにコンパイラーに指示します。

エンドユーザーが enable-sample オプションを指定して ./configure を呼び出すと、ローカル環境変数

$PHP_SAMPLE が yes に設定されます。 PHP_SUBST() は、標準 autoconf の AC_SUBST() マクロの PHP 修正バージョンであり、共有モジュールとして拡張機能を構築するときに必要です

最後に重要なことですが、PHP_NEW_EXTENSION() はモジュールを定義し、モジュールとして使用する必要があるものをすべて列挙します。コンパイルされたソース ファイルの拡張子。複数のファイルが必要な場合は、2 番目のパラメーターにスペースを使用して列挙できます。例: PHP_NEW_EXTENSION(sample,sample.c sample2.c sample3.c, $ext_shared)

最後のパラメータは、PHP_SUBST (SAMPLE_SHARED_LIBADD) コマンドに対応します。これは、共有モジュールを構築するときにも必要です。

ヘッダー ファイル

C で開発する場合は、ソースごとにデータ型定義を外部ヘッダー ファイルに置きます。ファイルをインクルードするのは一般的な方法ですが、PHP ではこれを必要としませんが、そうすることでモジュールが 1 つのソース ファイルから拡張される場合に作業を簡素化できます。

php_sample.h ヘッダー ファイルに次の内容を含めます。ヘッダー ファイルは 2 つの主なタスクを実行します。 拡張機能が phpize ツール (通常、この本で使用される方法) を使用して構築されている場合、HAVE_CONFG_H が定義されているため、config.h は通常インクルードされます。コンパイルされると、php.h が php ソース ツリーからインクルードされます。このヘッダー ファイルには、PHP API のほとんどにアクセスするために php ソース コードで使用される他のヘッダー ファイルが含まれています。次に、拡張機能によって使用される zend_module_entry 構造体が外部として定義されます。そのため、このモジュールが extension=xxx を使用してロードされると、dlopen と dlsym() を使用して Zend によってフェッチできるようになります。ヘッダー ファイルには、元のファイルで使用される情報を定義するためのいくつかの前処理も含まれます。

最後に、作成する必要がある最も重要なことは、sample.c:

#ifndef PHP_SAMPLE_H  
/* 防止重复包含 */
#define PHP_SAMPLE_H  
      
/* 定义扩展的属性 */
#define PHP_SAMPLE_EXTNAME    "sample"  
#define PHP_SAMPLE_EXTVER    "1.0"  
      
/* 在php源码树外面构建时引入配置选项 */
#ifdef HAVE_CONFIG_H  
#include "config.h"  
#endif  
      
/* 包含php的标准头文件 */
#include "php.h"  
      
/* 定义入口点符号, Zend在加载这个模块的时候使用 */
extern zend_module_entry sample_module_entry;  
#define phpext_sample_ptr &sample_module_entry  
      
#endif /* PHP_SAMPLE_H */

の単純なソース コード スケルトンです。

以上がPHP拡張子の書き方の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。