# assert_options

(PHP 4, PHP 5, PHP 7, PHP 8)

assert_options — Establecer/obtener valores de las directivas relacionadas con las aserciones

### Descripción

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

Se utiliza para establecer el valor de las diferentes opciones de la función assert() o consultar su valor actual.

### Parámetros

`what`

  Assert Options
  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

`value`

  Nuevo valor para la directiva.

### Valores devueltos

Devuelve el valor original de cualquiera de las opciones o `false` en caso de error.

### Ejemplos

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';
?>`

### Ver también

- assert()