广告:宝塔Linux面板高效运维的服务器管理软件 点击【 https://www.bt.cn/p/uNLv1L 】立即购买
php8提供了非常方便的扩展函数或类参数信息的生成工具。
只需要维护一份xyz.stub.php
,就可以使用工具生成 xyz_arginfo.h
。
毫无疑问,这种方式,又降低了广大 phper
开发扩展的门槛,更易维护。
上手体验:
生成扩展骨架。
cd extphp ext_skel.php --ext test登录后复制
随便添加一个函数,更改 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登录后复制
相关 commit 可以 点击这儿(https://github.com/php/php-src/compare/master...nikic:php-stubs)
写个简单的扩展举例,通过php扩展的方式来实现python中的all
和 any
函数。
cd extphp ext_skel.php --ext python登录后复制撰写函数原型,编辑
python.stub.php
。<?php/** @generate-function-entries */function all(array $arr): bool {}function any(array $arr): bool {}登录后复制根据
python.stub.php
生成 python_arginfo.h
。php ../../build/gen_stub.php python.stub.php登录后复制实现函数逻辑,编辑
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)登录后复制
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}0登录后复制编译、测试和安装
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}1登录后复制加入到php.ini
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}2登录后复制
加入
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}3登录后复制
查看是否成功
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}4登录后复制实测
<?php/** @generate-function-entries */function test1(): void {}function test2(string $str = ""): string {}function test3(int $integer = 123): int {}5登录后复制
PHP8新增了蛮多有用的宏和特性。
发表评论