assert_options

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

assert_options — Встановлення та отримання параметрів механізму перевірки тверджень

Увага

Функція оголошена застарілої починаючи з PHP 8.3.0. Використовувати цю функцію не рекомендується.

Опис

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

Задание значений настроек механизма проверки утвержденийassert()или получение их текущих значений.

Зауваження: Использованиеassert_options() не рекомендується на користь встановлення та отримання php.ini директив zend.assertions і assert.exception за допомогою ini_set() і ini_get()соответственно.

Список параметрів

option

Налаштування механізму перевірки тверджень

Настройка	INI-параметр	Значение по умолчанию	Опис
ASSERT_ACTIVE	assert.active		включення механізму перевірки тверджень
ASSERT_EXCEPTION	assert.exception		викидає AssertionError для кожного невдалого твердження
ASSERT_WARNING	assert.warning		виведення попередження PHP для кожної невдалої перевірки
ASSERT_BAIL	assert.bail		завершити виконання у разі невдалої перевірки
ASSERT_QUIET_EVAL	assert.quiet_eval		відключити error_reporting під час перевірки затвердження. Видалено з PHP 8.0.0.
ASSERT_CALLBACK	assert.callback	null) .	Callback-функція, яку необхідно викликати для затвердження, що провалило перевірку

value

Необов'язковий аргумент, нове значення налаштування.

У callback-функции, установленной с помощью**ASSERT_CALLBACK**илиassert.callback, має бути наступна сигнатура:

assert_callback(    string $file,    int $line,    ?string $assertion,    string $description = ?): void

file

Файл, у якому було викликано assert()

line

Рядок, в якому був викликаний assert()

assertion

До PHP 8.0.0 твердження, яке передавалося у функцію assert(), але якщо затвердження задано у вигляді рядка. (Якщо затвердження є логічною умовою, цей параметр буде порожнім рядком). Починаючи з PHP 8.0.0, цей параметр завжди null

description

Опис, яке було передано до assert()

Передача порожнього рядка в value скидає assert callback.

Значення, що повертаються

Повертає початкове значення налаштування.

Помилки

Функція викидає ValueError, якщо параметр option не є допустимою опцією.

список змін

Версия	Опис
8.3.0	Функцияassert_option() оголошено застарілою.
8.0.0	Якщо параметр option не є допустимою опцією, тепер викидається помилка ValueError; раніше поверталося значення false

Приклади

Приклад #1 Приклад використання assert_options()****

Loading...
▶

Дивіться також

• assert() - Перевіряє затвердження