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

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

Возвращаемые значения

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

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

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

add a note

User Contributed Notes 3 notes

down

keithy at consultant dot com ¶

6 months ago


To reset the callback:

 assert_options(ASSERT_CALLBACK,null); // does not work   

 assert_options(ASSERT_CALLBACK,"");  // appears to work

down

Patrick Schulz ¶

22 days ago


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.

down

16 years ago


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 ...

add a note