首页 >后端开发 >PHP8 > 正文

php8的扩展arginfo生成工具之使用初体验

转载2020-09-16 17:04:200966

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 可以 点击这儿(https://github.com/php/php-src/compare/master...nikic:php-stubs)

写个简单的扩展举例,通过php扩展的方式来实现python中的allany函数。

准备工作。
  • 下载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.phpt003.phpt, 新建 004.phpt005.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生成工具之使用初体验的详细内容,更多请关注php中文网其它相关文章!

php中文网最新课程二维码
  • 相关标签:php8
  • 本文转载于:segmentfault,如有侵犯,请联系a@php.cn删除
  • 相关文章

    相关视频


    网友评论

    文明上网理性发言,请遵守 新闻评论服务协议

    我要评论
  • Pandas是Python中非常常数据处理使起来非常方便。

    专题推荐

    推荐视频教程
  • javascript初级视频教程javascript初级视频教程
  • jquery 基础视频教程jquery 基础视频教程
  • 视频教程分类