目錄正文上手體驗準(zhǔn)備工作生成擴展骨架撰寫函數(shù)原型實現(xiàn)函數(shù)邏輯編寫單元測試編譯、測試和安裝加入到php.ini實測正文

php8提供了非常方便的擴展函數(shù)或類參數(shù)信息的生成工具。

只需要維護一份xyz.stub.php，就可以使用工具生成 xyz_arginfo.h。

毫無疑問，這種方式，又降低了廣大 phper 開發(fā)擴展的門檻，更易維護。

上手體驗

生成擴展骨架。

cd extphp ext_skel.php --ext test

隨便添加一個函數(shù)，更改 test.stub.php。

<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ''): string {}function test3(int $integer = 123): int {}

重新生成 test_arginfo.h。

php ../../build/gen_stub.php test.stub.php

相關(guān) commit 可以 點擊這兒

寫個簡單的擴展舉例，通過php擴展的方式來實現(xiàn)python中的all和 any函數(shù)。

準(zhǔn)備工作下載php最新源碼已經(jīng)安裝好php生成擴展骨架cd extphp ext_skel.php --ext python撰寫函數(shù)原型

編輯 python.stub.php。

<?php/** @generate-function-entries */function all(array $arr): bool {}function any(array $arr): bool {}

根據(jù) python.stub.php 生成 python_arginfo.h。

php ../../build/gen_stub.php python.stub.php實現(xiàn)函數(shù)邏輯

編輯 python.c。

PHP_FUNCTION(all){ zval *input; zval *item; int result = 1, item_result = 1; HashTable *htbl; ZEND_PARSE_PARAMETERS_START(1, 1)Z_PARAM_ARRAY(input) ZEND_PARSE_PARAMETERS_END(); htbl = Z_ARRVAL_P(input); ZEND_HASH_FOREACH_VAL(htbl, item) {item_result = zend_is_true(item);result &= item_result; } ZEND_HASH_FOREACH_END(); RETURN_BOOL(result);}/* {{{ void any() */PHP_FUNCTION(any){ zval *input; zval *item; int result = 0, item_result = 0; HashTable *htbl; ZEND_PARSE_PARAMETERS_START(1, 1)Z_PARAM_ARRAY(input) ZEND_PARSE_PARAMETERS_END(); htbl = Z_ARRVAL_P(input); ZEND_HASH_FOREACH_VAL(htbl, item) {item_result = zend_is_true(item);result |= item_result; } ZEND_HASH_FOREACH_END(); RETURN_BOOL(result);}編寫單元測試

編輯 002.phpt和003.phpt, 新建 004.phpt和005.phpt。

--TEST--Check all function true case--SKIPIF--<?phpif (!extension_loaded('python')) { echo 'skip';}?>--FILE--<?phpvar_dump(all([]));var_dump(all([1]));var_dump(all([-1, 1, '1']));?>--EXPECT--bool(true)bool(true)bool(true)--TEST--Check all function false case--SKIPIF--<?phpif (!extension_loaded('python')) { echo 'skip';}?>--FILE--<?phpvar_dump(all(['0']));var_dump(all([0]));var_dump(all(['']));var_dump(all([false]));var_dump(all([1, -1, 100, false]));var_dump(all([0, -1, 100, 1]));var_dump(all(['1', -1, '', 100, 1]));?>--EXPECT--bool(false)bool(false)bool(false)bool(false)bool(false)bool(false)bool(false)--TEST--Check any function true case--SKIPIF--<?phpif (!extension_loaded('python')) { echo 'skip';}?>--FILE--<?phpvar_dump(any(['a', 'b', 'c', 'd']));var_dump(any([['a', 'b', '', 'd']]));var_dump(any([['', 'b', 'c', 'd']]));var_dump(any([['a', 'b', 'c', '']]));?>--EXPECT--bool(true)bool(true)bool(true)bool(true)--TEST--Check all function false case--SKIPIF--<?phpif (!extension_loaded('python')) { echo 'skip';}?>--FILE--<?phpvar_dump(any(['0']));var_dump(any([0]));var_dump(any(['']));var_dump(any([false]));var_dump(any([0, '0', '', false]));?>--EXPECT--bool(false)bool(false)bool(false)bool(false)bool(false)編譯、測試和安裝./configure && makemake testsudo make install加入到php.iniphp -i | grep ini # 定位你的php.ini文件

加入

extension=python.so

查看是否成功

php -m | grep python實測php -r 'var_dump(all([]));“php -r 'var_dump(any([]));'

PHP8新增了蠻多有用的宏和特性。

以上就是php8擴展arginfo生成工具及工具初體驗介紹的詳細(xì)內(nèi)容，更多關(guān)于php8擴展arginfo生成工具的資料請關(guān)注好吧啦網(wǎng)其它相關(guān)文章！