Erste Erfahrungen mit dem erweiterten Arginfo-Generierungstool von PHP8

php8 bietet ein sehr praktisches Tool zum Generieren von Erweiterungsfunktions- oder Klassenparameterinformationen.

Sie müssen lediglich eine Kopie von xyz.stub.php pflegen und können Tools verwenden, um xyz_arginfo.h zu generieren. 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中的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

Es besteht kein Zweifel, dass diese Methode die Schwelle für die Entwicklung von Erweiterungen für phper senkt und die Wartung erleichtert. Erste Schritte: Erweitertes Skelett erstellen.

--TEST--
Check all function true case
--SKIPIF--
<?php
if (!extension_loaded(&#39;python&#39;)) {
    echo &#39;skip&#39;;
}
?>
--FILE--
<?php
var_dump(all([]));
var_dump(all([1]));
var_dump(all([-1, 1, &#39;1&#39;]));
?>
--EXPECT--
bool(true)
bool(true)
bool(true)

Funktion hinzufügen und test.stub.php ändern.

--TEST--
Check all function false case
--SKIPIF--
<?php
if (!extension_loaded(&#39;python&#39;)) {
    echo &#39;skip&#39;;
}
?>
--FILE--
<?php
var_dump(all([&#39;0&#39;]));
var_dump(all([0]));
var_dump(all([&#39;&#39;]));
var_dump(all([false]));
var_dump(all([1, -1, 100, false]));
var_dump(all([0, -1, 100, 1]));
var_dump(all([&#39;1&#39;, -1, &#39;&#39;, 100, 1]));
?>
--EXPECT--
bool(false)
bool(false)
bool(false)
bool(false)
bool(false)
bool(false)
bool(false)

test_arginfo.h. php ../../build/gen_stub.php test.stub.php" title="" data-original-title="Copy">

--TEST--
Check any function true case
--SKIPIF--
03337722efea1711f56b8de85a57c3f3
--FILE--
9aca998af19012e49a0511600d6999f0
--EXPECT--
bool(true)
bool(true)
bool(true)
bool(true)

Verwandte Commits können hier angeklickt werden (https://github.com/php /php-src/compare/master...nikic:php-stubs)

Schreiben Sie ein einfaches Erweiterungsbeispiel, um all und any<span type="button" class="copyCode code-tool" data-toggle="tooltip" data-placement="top" data-clipboard-text="extension=python.so" title="" data-original-title="复制">Vorbereitung code-tool" data-toggle="tooltip" data-placement="top" data-clipboard-text="cd ext php ext_skel.php --ext python" title="" data-original-title="Copy"></span><pre id="coder" class="brush:php;toolbar:false">--TEST-- Check all function false case --SKIPIF-- 03337722efea1711f56b8de85a57c3f3 --FILE-- adcfae2c6b929629deb6b746091dd12c --EXPECT-- bool(false) bool(false) bool(false) bool(false) bool(false)</pre> <p>Schreiben Sie den Funktionsprototyp und bearbeiten Sie <code>python.stub.php.

./configure && make
make test
sudo make install

Gemäß python.stub.php generiert python_arginfo.h

php -i | grep ini # 定位你的php.ini文件

Funktionslogik implementieren, bearbeiten python.c.

extension=python.so

Schreiben Sie Unit-Tests, bearbeiten Sie 002.phpt und 003.phpt und erstellen Sie einen neuen 004. phpt und 005.phpt

php -m | grep python

🎜Eigentlicher Test 🎜🎜🎜

php -r "var_dump(all([]));“
php -r "var_dump(any([]));"

🎜PHP8 hat viele nützliche Makros und Funktionen hinzugefügt 🎜🎜.

Das obige ist der detaillierte Inhalt vonErste Erfahrungen mit dem erweiterten Arginfo-Generierungstool von PHP8. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!