PHP 8.3中assert_options与ASSERT_CALLBACK的替代方案咨询

之前你使用的代码通过assert_options设置全局断言回调：

assert_options(ASSERT_CALLBACK, function(string $file, int $line, ?string $assertion, string $description = null){
    // 自定义逻辑
});

自PHP 8.3起，assert_options的ASSERT_CALLBACK选项已被弃用，以下是几种兼容的替代方案：

方案1：使用zend.assertion_callback配置项（PHP 8.3+） #

PHP 8.3新增了zend.assertion_callback这个INI配置，可直接设置全局默认的断言回调函数。你可以通过运行时代码设置，也能在php.ini中配置：

运行时设置示例： #

// 定义符合签名要求的回调函数
function my_assert_callback(string $file, int $line, ?string $assertion, ?string $description): void {
    // 自定义断言失败处理逻辑
    echo "断言失败：文件 {$file} 第 {$line} 行";
    if ($description) {
        echo "，描述：{$description}";
    }
}

// 全局绑定断言回调
ini_set('zend.assertion_callback', 'my_assert_callback');

// 测试断言
assert(1 === 2, "数值不相等");

php.ini配置示例： #

zend.assertion_callback = my_assert_callback

注意：回调函数的参数签名必须严格匹配要求，否则会触发运行时错误。

方案2：封装自定义断言函数 #

如果需要兼容PHP 8.3之前的版本，可以封装自己的断言函数，在内部统一处理回调逻辑：

function my_assert(bool $condition, ?string $description = null, ?callable $callback = null): void {
    if (!$condition) {
        $trace = debug_backtrace()[0];
        $file = $trace['file'];
        $line = $trace['line'];
        $assertion = $trace['args'][0]; // 获取断言表达式字符串
        
        // 优先使用传入的回调，否则用默认逻辑
        $handler = $callback ?? function(string $file, int $line, ?string $assertion, ?string $description) {
            error_log("断言失败：{$file}:{$line} - {$description}");
        };
        
        $handler($file, $line, $assertion, $description);
        
        // 可选：抛出异常终止流程
        throw new AssertionError($description ?? "断言失败", 0, $file, $line);
    }
}

// 使用自定义断言
my_assert(1 === 2, "数值不匹配");

这种方式可以灵活控制断言行为，同时覆盖多版本PHP的兼容需求。

方案3：捕获AssertionError异常 #

当断言失败（且zend.assertions配置为1或-1）时，PHP会抛出AssertionError异常。你可以通过全局异常处理器统一处理：

set_exception_handler(function(Throwable $e) {
    if ($e instanceof AssertionError) {
        // 自定义断言异常处理逻辑
        echo "捕获断言异常：{$e->getMessage()}，位置：{$e->getFile()}:{$e->getLine()}";
    } else {
        // 处理其他类型异常
        echo "捕获异常：{$e->getMessage()}";
    }
});

// 测试断言
assert(1 === 2, "数值不相等");

这种方式无需额外配置，直接利用PHP原生异常机制处理断言失败场景。

内容的提问来源于stack exchange，提问作者T.Todua