(PHP 4, PHP 5, PHP 7, PHP 8)
assert_options — Establecer/obtener valores de las directivas relacionadas con las aserciones
Se utiliza para establecer el valor de las diferentes opciones de la función assert() o consultar su valor actual.
what| Opción | Configuración inicial | Valor predeterminado | Descripción |
|---|---|---|---|
| ASSERT_ACTIVE | assert.active | 1 | Activa la función assert() |
| ASSERT_WARNING | assert.warning | 1 | Cada vez que una aserción falla se genera una advertencia |
| ASSERT_BAIL | assert.bail | 0 | Termina la ejecución cuando falla una aserción |
| ASSERT_QUIET_EVAL | assert.quiet_eval | 0 | Desactiva la directiva error_reporting durante la evaluación de la aserción |
| ASSERT_CALLBACK | assert.callback | (null) | Función que se encargará de gestionar las aserciones cuando fallen |
valueNuevo valor para la directiva.
Devuelve el valor original de cualquiera de las opciones o false en caso de error.
Ejemplo #1 Ejemplo de assert_options()
<?php
// Esta es nuestra función manejadora
// de los fallos en un aserción
function assert_failure()
{
echo 'Assert failed';
}
// Esta es nuestra función de test
function test_assert($parameter)
{
assert(is_bool($parameter));
}
// Establecemos nuestras propias opciones para gestionar las aserciones
// Activamos las aserciones
assert_options(ASSERT_ACTIVE, true);
// Si una aserción falla se detiene la ejecución
assert_options(ASSERT_BAIL, true);
// Si una aserción falla NO se genera una advertencia
assert_options(ASSERT_WARNING, false);
// Establecemos la función 'assert_failure' como manejadora (callback) de las aserciones
assert_options(ASSERT_CALLBACK, 'assert_failure');
// Creamos una aserción la cual queremos que falle
test_assert(1);
// Este código nunca se ejecuta porque ASSERT_BAIL
// está a TRUE
echo 'Never reached';
?>