assert_options
(PHP 4, PHP 5, PHP 7)
assert_options — Установка и получение настроек механизма проверки утверждений
Описание
Задание значений настроек механизма проверки утверждений assert() или получение их текущих значений.
Замечание: Начиная с PHP 7.0.0, использование assert_options() не рекомендуется в пользу установки и получения php.ini директив zend.assertions и assert.exception с помощью ini_set() и ini_get() соответственно.
Список параметров
-
what -
Настройки механизма проверки утверждений Настройка INI-параметр Значение по умолчанию Описание ASSERT_ACTIVE assert.active 1 включение механизма проверки утверждений ASSERT_WARNING assert.warning 1 вывод предупреждения PHP для каждой неудачной проверки ASSERT_BAIL assert.bail 0 завершить выполнение в случае неудачной проверки ASSERT_QUIET_EVAL assert.quiet_eval 0 отключить error_reporting во время проверки утверждения 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 - Утверждение, которое было передано в assert(), преобразованное в строку.
-
description - Описание, которое было передано в assert().
valueсбрасывает assert callback. -
Возвращаемые значения
Возвращает исходное значение настройки или false в случае ошибки.
Примеры
Пример #1 Пример использования assert_options()
<?php
// Наша функция обработчик
// неудавшихся проверок
function function assert_failure($file, $line, $assertion, $message)
{
echo "Проверка $assertion в $file на строке $line провалена: $message";
}
// Тестовая функция
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 'Никогда не будет выведено';
?>