Backup of PHP/ext(No. 8) - YoyaWiki Plus!

準備
- ディレクトリ作成
- configure 作成
クラス実装
- 定義 (php_swfed.h)
- 実装 (swfed.c)
参考
- 本家
- Klab
関連

swfed extension の作成メモ

準備

ディレクトリ作成

$ cd php-x.x.x/ext
$ ./ext_skel --extname=swfed
$ cd swfed

configure 作成

必要に応じて後でやり直せる (.c ファイルを増やすとか)

$ vi config.m4
 PHP_ARG_ENABLE から３行のコメントを外す
dnl PHP_ARG_ENABLE(swfed, whether to enable swfed support,
dnl Make sure that the comment is aligned:
dnl [  --enable-swfed           Enable swfed support])
↑これらの dnl を消す
 PHP_NEW_EXTENSION に追加するファイルを指定する
前) PHP_NEW_EXTENSION(swfed, swfed.c, $ext_shared)
後) PHP_NEW_EXTENSION(swfed, swfed.c swf_object.c, $ext_shared)
                                    ↑空白
$ phpize
$ ./configure
$ make

クラス実装

定義 (php_swfed.h)

クラスエントリ作成
```
static zend_class_entry *swfeditor_ce;
```

クラスメソッド定義

PHP_METHOD(swfed, __construct);
PHP_METHOD(swfed, input);

実装 (swfed.c)

ファンクションエントリ作成

zend_function_entry swfed_functions[]= {
   ＜略＞
    PHP_ME(swfed, __construct, NULL, 0)

モジュール初期化でクラス設定

PHP_MINIT_FUNCTION(swfed)
   ＜略＞
    zend_class_entry ce;
    INIT_CLASS_ENTRY(ce, "SWFEditor", swfed_functions);
    swfeditor_ce = zend_register_internal_class(&ce TSRMLS_CC);
    le_swfed = zend_register_list_destructors_ex(free_swfed_resource,
                                   NULL, "SWFEditor", module_number);
    zend_declare_property_stringl(swfeditor_ce, "swf_object",
                       strlen("swf_object"), "", 0, ZEND_ACC_PUBLIC);

ファンクション実装

PHP_METHOD(swfed, __construct) {
    swf_object_t *swf = swf_object_open();
    int ret;
    ret = zend_list_insert(swf, le_swfed);
    object_init_ex(getThis(), swfeditor_ce);
    add_property_resource(getThis(), "swfed", ret);
    zend_list_addref(ret);
}

クラス内部データも swfed のラベルで保存。

PHP_METHOD(swfed, input) {
    ＜略＞

クラス内部データの取り方 (というより Zend に登録したデータの一般的な引き出し方)

zend_read_property
zend_hash_find
Z_LVAL_PP
zend_list_find

引数の取り方 (string 型)

zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,
                             "s", &str, &str_len)

引数の取り方 (可変長引数)

ext/interbase/ibase_blobs.c から引用

switch (ZEND_NUM_ARGS()) {
 default:
   WRONG_PARAM_COUNT;
 case 1:
  if (FAILURE == zend_parse_parameters(1 TSRMLS_CC, "s", &blob_id, &blob_id_len)) {
       RETURN_FALSE;
   }
   break;
 case 2:
   if (FAILURE == zend_parse_parameters(2 TSRMLS_CC, "rs",&link, &blob_id, &blob_id_len)) {
       RETURN_FALSE;
   }
   break;
}

返り値

例

RETURN_{TRUE|FALSE}
RETURN_LONG(l)
RETURN_STRINGL(s, l, dup)

要調査 (配列の返し方)

RETURN_ZVAL(*entry, 1, 0); // standard/array.c

参考

PHP拡張モジュールでクラス定義
- http://diary.eth.jp/?date=20080131#p01
メモリ管理
- http://psa.ange.ac/zenddoc/zend.layout.memory-management.html

PHP拡張でクラス実装がよくわからん

http://www.developer0000.jp/2007/01/07/1310/

○ クラスメソッドはPHP_ME、PHP_METHODを使うらしい。 
○ INIT_CLASS_ENTRY、zend_register_internal_classでクラスを定義。
○ zend_register_list_destructors_exでデストラクタ時の処理を設定できるらしい。

C++ で PHP Extension を書く方法 †
- http://viz.is-a-geek.com/~viz/cw/index.php?PHP%20Extension
PHP extension からコールバックで hello, world を表示する
- http://ido.nu/kuma/2007/03/02/calling-php-user-defined-function-from-php-extension/