PHP8 assert_options — 設置/獲取各種斷言 flag

2023-09-12 14:05 更新

(PHP 4, PHP 5, PHP 7, PHP 8)

assert_options — 設置/獲取各種斷言 flag

說明

assert_options(int $option, mixed $value = ?): mixed

設置 assert() 的各種控制選項，或者是僅僅查詢當前的設置。

注意: 不鼓勵使用 assert_options()，而是分別使用 ini_set() 和 ini_get() 設置和獲取 php.ini 指令 zend.assertions 和 assert.exception。

參數(shù)

option
斷言選項
選項 INI 設置 默認值 描述
ASSERT_ACTIVE assert.active 1 啟用 assert() 斷言
ASSERT_EXCEPTION assert.exception 1 每個失敗斷言，拋出 AssertionError
ASSERT_WARNING assert.warning 1 為每個失敗的斷言產生一個 PHP 警告（warning）
ASSERT_BAIL assert.bail 0 在斷言失敗時中止執(zhí)行
ASSERT_QUIET_EVAL assert.quiet_eval 0 在斷言表達式求值時禁用 error_reporting。PHP 8.0.0 起移除。
ASSERT_CALLBACK assert.callback (null) 斷言失敗時調用回調函數(shù)
value

可選的新選項值。

通過 ASSERT_CALLBACK 或 assert.callback 設置的回調函數(shù)應該有以下簽名：

assert_callback(
    string $file,
    int $line,
    ?string $assertion,
    string $description = ?
): void
file
調用 assert() 的文件名。
line
調用 assert() 的行數(shù)。
assertion
在 PHP 8.0.0 之前，傳遞給 assert() 的斷言，僅作為字符串給出。 （如果斷言是 boolean 條件，則此參數(shù)將為空字符串。）從 PHP 8.0.0 開始，此參數(shù)始終為 null。
description
傳遞給 assert() 的描述。向 value 傳遞空字符串會重置斷言回調。

返回值

返回任意選項的原始設置。

錯誤／異常

如果 option 是無效選項，拋出 ValueError。

更新日志

版本 說明
8.0.0 如果 option 是無效選項，拋出 ValueError。之前返回 false。

示例

示例 #1 assert_options() 示例

<?php
// 處理斷言失敗時的函數(shù)
function assert_failure($file, $line, $assertion, $message)
{
echo "The assertion $assertion in $file on line $line has failed: $message";
}

// 我們的測試函數(shù)
function test_assert($parameter)
{
assert(is_bool($parameter));
}

// 設置斷言選項
assert_options(ASSERT_ACTIVE, true);
assert_options(ASSERT_BAIL, true);
assert_options(ASSERT_WARNING, false);
assert_options(ASSERT_CALLBACK, 'assert_failure');

// 讓一個斷言會失敗
test_assert(1);

// 由于 ASSERT_BAIL 是 true，這里永遠也到不了
echo 'Never reached';
?>

參見

  • assert() - 斷言檢測


以上內容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號