assert_options

(PHP 4, PHP 5, PHP 7)

assert_options Установка и получение настроек механизма проверки утверждений

Описание

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

Задание значений настроек механизма проверки утверждений 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 'Никогда не будет выведено';
?>

Смотрите также

  • assert() - Проверяет, является ли утверждение false