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中的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-- 03337722efea1711f56b8de85a57c3f3 --FILE-- 9aca998af19012e49a0511600d6999f0 --EXPECT-- bool(true) bool(true) bool(true) bool(true)
--TEST-- Check all function false case --SKIPIF-- 03337722efea1711f56b8de85a57c3f3 --FILE-- adcfae2c6b929629deb6b746091dd12c --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新增了蠻多有用的巨集和特性。