PHP extensionの作り方 配列を返す方法

このドキュメントの内容は、以下の通りです。

• はじめに
• プロトタイプ
• 配列を操作するAPI
• spec.xml
• helloworld.c
• 関連項目

はじめに

• [2013-02-17-1] PHP extensionの作り方 ５分でできるHello world!
• [2013-02-18-1] PHP extensionの作り方 CodeGen_PECLを使ってC++で作る方法

• プロトタイプの戻り値の型を array にする。
• return_valueという変数に値を追加する。

プロトタイプ

    <proto>array hello_array()</proto>

配列を操作するAPI

$array = array ();
$array[] = "Hello";

$array['World'] = '1';

spec.xml

Array
(
    [0] => Hello
    [World] => !
)

  <function name="hello_array" role="public">
    <proto>array hello_array()</proto>
    <summary>Return array.</summary>
    <description><?data
Return array.
    ?></description>
    <code><?data
	    char *s1 = "Hello";
	    char *s2 = "World";
	    char *s3 = "!";
	    zval *tmp;
	    MAKE_STD_ZVAL(tmp);
	    ZVAL_STRING(tmp,s3,1);
	add_next_index_string(return_value, s1, strlen(s1) );
	zend_symtable_update(Z_ARRVAL_P(return_value),
	s2,
	strlen(s2) + 1,
	(void*)&tmp, sizeof(zval*), NULL);
    ?></code>
    <test>
      <code><?data
print_r ( hello_array() );
      ?></code>
      <result mode="plain"><?data
Array
(
    [0] => Hello
    [World] => !
)
      ?></result>
    </test>
  </function>

helloworld.c

/* {{{ proto array hello_array()
  Return array. */
PHP_FUNCTION(hello_array)
{



	if (ZEND_NUM_ARGS()>0)  {
		WRONG_PARAM_COUNT;
	}


	array_init(return_value);

	do {
		char *s1 = "Hello";
				char *s2 = "World";
				char *s3 = "!";
				zval *tmp;
				MAKE_STD_ZVAL(tmp);
				ZVAL_STRING(tmp,s3,1);
			add_next_index_string(return_value, s1, strlen(s1) );
			zend_symtable_update(Z_ARRVAL_P(return_value),
			s2,
			strlen(s2) + 1,
			(void*)&tmp, sizeof(zval*), NULL);
	} while (0);
}
/* }}} hello_array */

関連項目

• [2013-02-17-1] PHP extensionの作り方 ５分でできるHello world!
• [2013-02-18-1] PHP extensionの作り方 CodeGen_PECLを使ってC++で作る方法