PHP 8.6.0 Released!

assert_options

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

assert_options — Imposta/ottiene i vari flag di assert

Avviso

This function has been DEPRECATED as of PHP 8.3.0. Relying on this function is highly discouraged.

Descrizione

function assert_options(int $option, mixed $value = ?): mixed

Imposta le varie opzioni di controllo di assert() o ne interroga semplicemente le impostazioni correnti.

Nota:

L'uso di assert_options() è sconsigliato in favore dell'impostazione e della lettura delle direttive di php.ini zend.assertions e assert.exception con ini_set() e ini_get(), rispettivamente.

Elenco dei parametri

option

Opzioni di assert
Opzione Impostazione INI Valore predefinito Descrizione
ASSERT_ACTIVE assert.active 1 abilita la valutazione di assert()
ASSERT_EXCEPTION assert.exception 1 lancia un AssertionError per ogni asserzione fallita
ASSERT_WARNING assert.warning 1 emette un warning PHP per ogni asserzione fallita
ASSERT_BAIL assert.bail 0 termina l'esecuzione in caso di asserzioni fallite
ASSERT_QUIET_EVAL assert.quiet_eval 0 disabilita error_reporting durante la valutazione dell'espressione dell'asserzione. Rimossa a partire da PHP 8.0.0.
ASSERT_CALLBACK assert.callback (null) Callback da chiamare in caso di asserzioni fallite

value

Un nuovo valore opzionale per l'opzione.

La funzione di callback impostata tramite ASSERT_CALLBACK o assert.callback deve avere la seguente firma:

function assert_callback(
    string $file,
    int $line,
    ?string $assertion,
    string $description = ?
): void
file

Il file in cui è stata chiamata assert().

line

La riga in cui è stata chiamata assert().

assertion

Prima di PHP 8.0.0, l'asserzione che è stata passata a assert(), ma solo quando l'asserzione è fornita come stringa. (Se l'asserzione è una condizione booleana, questo parametro sarà una stringa vuota.) A partire da PHP 8.0.0, questo parametro è sempre null.

description

La descrizione che è stata passata a assert().

Passando una stringa vuota come value si reimposta la callback di assert.

Valori restituiti

Restituisce l'impostazione originale di qualsiasi opzione.

Errori/Eccezioni

Se option non è un'opzione valida, viene lanciato un ValueError.

Log delle modifiche

Versione Descrizione
8.3.0 assert_options() ora è deprecata.
8.0.0 Se option non è un'opzione valida, ora viene lanciato un ValueError. In precedenza veniva restituito false.

Esempi

Example #1 Esempio di assert_options()

<?php
// Questa è la nostra funzione per gestire
// i fallimenti delle asserzioni
function assert_failure($file, $line, $assertion, $message)
{
    echo "L'asserzione $assertion in $file alla riga $line è fallita: $message";
}

// Questa è la nostra funzione di test
function test_assert($parameter)
{
    assert(is_bool($parameter));
}

// Imposta le nostre opzioni di assert
assert_options(ASSERT_ACTIVE,   true);
assert_options(ASSERT_BAIL,     true);
assert_options(ASSERT_WARNING,  false);
assert_options(ASSERT_CALLBACK, 'assert_failure');

// Esegue un'asserzione che fallirà
test_assert(1);

// Questo punto non viene mai raggiunto perché ASSERT_BAIL
// è impostato a true
echo 'Mai raggiunto';
?>

Vedere anche:

  • assert() - Verifica se un'asserzione è false

+add a note

User Contributed Notes 1 note

up
5
Fr?d?ric Bouchery
23 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 ...
To Top