php8的擴展arginfo生成工具之使用初體驗

php8提供了非常方便的擴展函數或類參數信息的生成工具。

只需要維護一份xyz.stub.php,就可以使用工具生成 xyz_arginfo.h。

毫無疑問,這種方式,又降低了廣大 phper 開發擴展的門檻,更易維護。

上手體驗:

生成擴展骨架。

cd ext

php ext_skel.php --ext test

隨便添加一個函數,更改 test.stub.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擴展的方式來實現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生成工具及工具初體驗

很多PHPer在進階的時候總會遇到一些問題和瓶頸,業務代碼寫多了迷茫沒方向,不知道該從哪兒入手去提升自己。→→管理整理了一些資料,有 騰訊 等一線大廠進階知識體系 可供參考(相關學習資料以及筆面試題)

覆蓋各個技術棧:分佈式架構、高可擴展、高性能、高併發、服務器性能調優、TP6,laravel,YII2,Redis,Swoole、Swoft、Kafka、Mysql優化、shell腳本、Docker、微服務、Nginx等多個知識點高級進階乾貨歡迎加入我的官方羣點擊此處

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章