To reset the callback:
assert_options(ASSERT_CALLBACK,null); // does not work
assert_options(ASSERT_CALLBACK,""); // appears to work
(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
Необязательный аргумент, новое значение настройки.
Возвращает исходное значение настройки или FALSE
в случае ошибки.
Пример #1 Пример использования assert_options()
<?php
// Наша функция обработчик
// неудавшихся проверок
function assert_failure()
{
echo 'Проверка провалена';
}
// Тестовая функция
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 'Никогда не будет выведено';
?>
To reset the callback:
assert_options(ASSERT_CALLBACK,null); // does not work
assert_options(ASSERT_CALLBACK,""); // appears to work
The correct signature of the callback function is:
function assert_failure($file, $line, $assertedString, $message)
$assertedString is usually empty if the assertion was a boolean expression. Otherwise it contains the evaluated string.
Here is an exemple how to use the assertion callback function :
<?php
assert_options( ASSERT_CALLBACK, 'assert_callback');
function assert_callback( $script, $line, $message ) {
echo 'You have a design error in your script <b>', $script,'</b> : line <b>', $line,'</b> :<br />';
echo '<b>', ereg_replace( '^.*//\*', '', $message ), '</b><br /><br />';
echo 'Open the source file and check it, because it\'s not a normal behaviour !';
exit;
}
$x = 3;
assert('is_integer( $x ) && ($x >= 0) && ($x <= 10); //* $x must be an integer value from 0 to 10' );
echo "0 <= $x <= 10";
?>
assertion is usefull for "design by contract" methodology ...