关于php: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 新增了蛮多有用的宏和个性。