拡張モジュールを構成するファイル群

手作業で作ったか ext_skel を使用したか、 あるいは » CodeGen のようなツールを用いたのかにかかわらず、 すべての拡張モジュールには少なくとも次の 4 つのファイルが含まれます。

config.m4

UNIX ビルドシステムの設定ファイル (UNIX 用のビルドシステム: config.m4 を参照ください)。

config.w32

Windows ビルドシステムの設定ファイル (Windows 用のビルドシステム: config.w32 を参照ください)。

php_counter.h

拡張モジュールを PHP バイナリに静的モジュールとして組み込む場合は、 php_ の後に拡張モジュールの名前を続けたヘッダファイルに その拡張モジュールの構造についての宣言があるものとします。 通常は、このファイルに記述するのは、 マクロやプロトタイプ宣言、グローバル変数といった他のヘッダと同じ内容です。

counter.c

拡張モジュールのソースファイル。 規約上は拡張モジュールの名前と同じ名前にすることになっていますが、 これは必須ではありません。このファイルに含まれる内容は、 モジュールの構造体定義や INI エントリ、 管理用関数、ユーザーに公開する関数、その他拡張モジュールに必要となるものです。

ビルドシステム関連のファイルについては別の場所で説明することにして、 ここでは残りのファイルについて取り上げます。 これらの 4 つのファイルはあくまでも必要最小限のものであり、 実際にはこれら以外にもさまざまなヘッダファイルやソースファイル、 ユニットテストなどのファイルが含まれることになるでしょう。 counter 拡張モジュールのファイル一覧は、このようになります。

ext/
 counter/
  .svnignore
  config.m4
  config.w32
  counter_util.h
  counter_util.c
  php_counter.h
  counter.c
  package.xml
  CREDITS
  tests/
   critical_function_001.phpt
   critical_function_002.phpt
   optional_function_001.phpt
   optional_function_002.phpt

.deps
*.lo
*.la