php8扩展arginfo生成工具及工具初体验介绍
正文
php8提供了非常方便的扩展函数或类参数信息的生成工具。
只需要维护一份xyz.stub.php,就可以使用工具生成 xyz_arginfo.h。
毫无疑问,这种方式,又降低了广大 phper 开发扩展的门槛,更易维护。
上手体验
生成扩展骨架。
cd ext php 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 可以 点击这儿
写个简单的扩展举例,通过php扩展的方式来实现python中的all和 any函数。
准备工作
- 下载php最新源码
- 已经安装好php
生成扩展骨架
cd ext php 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--
<?php
if (!extension_loaded('python')) {
echo 'skip';
}
?>
--FILE--
<?php
var_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--
<?php
if (!extension_loaded('python')) {
echo 'skip';
}
?>
--FILE--
<?php
var_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--
<?php
if (!extension_loaded('python')) {
echo 'skip';
}
?>
--FILE--
<?php
var_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--
<?php
if (!extension_loaded('python')) {
echo 'skip';
}
?>
--FILE--
<?php
var_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 && make make test sudo make install
加入到php.ini
php -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生成工具及工具初体验介绍的详细内容,更多关于php8扩展arginfo生成工具的资料请关注脚本之家其它相关文章!
相关文章
phpmyadmin显示utf8_general_ci中文乱码的问题终级篇
自己写PHP也有一年多了,然后编码问题却老是没有得到好的解决,自己的情况是这样的,网页显示完全正常,在phpmyadmin数据库显示中文乱码,不管是简体还是繁体,只要是中文都是乱码2013-04-04
浏览器预览PHP文件时顶部出现空白影响布局分析原因及解决办法
在编写PHP文件过程中,发现在浏览器预览PHP文件时,顶部会出现一行空白,影响了页面的布局2013-01-01
获取用户Ip地址通用方法与常见安全隐患(HTTP_X_FORWARDED_FOR)
这个来自一些项目中,获取用户Ip,进行用户操作行为的记录,是常见并且经常使用的。 一般朋友,都会看到如下通用获取IP地址方法2013-06-06


最新评论