assert_options
様々な assert フラグを設定/取得する
&warn.deprecated.function-8-3-0;
&reftitle.description;
mixedassert_options
intoption
mixedvalue
種々の assert 制御オプションを設定したり、
単に現在の設定を調べたりします。
assert_options を使うことはお勧めできません。
&php.ini; のディレクティブ
zend.assertions と
assert.exception を
ini_set や ini_get
で取得したり設定したりする方が望ましいです。
&reftitle.parameters;
option
assert オプション
オプション
INI 設定
デフォルト値
説明
ASSERT_ACTIVE
assert.active
1
assert による評価を有効にする
ASSERT_EXCEPTION
assert.exception
1
assertion に失敗するたびに AssertionErrorをスローする
ASSERT_WARNING
assert.warning
1
assertion に失敗するたびに PHP の警告を発生させる
ASSERT_BAIL
assert.bail
0
assersion に失敗した場合に実行を終了する
ASSERT_QUIET_EVAL
assert.quiet_eval
0
assersion 式については error_reporting を無効にする。
PHP 8.0.0 以降では削除されています。
ASSERT_CALLBACK
assert.callback
(&null;)
assertion に失敗した場合にコールされるコールバック
value
オプションに指定する新しい値。
ASSERT_CALLBACK 定数または assert.callback
に設定するコールバック関数は、次のようなシグネチャを持つべきです:
voidassert_callback
stringfile
intline
stringnullassertion
stringdescription
file
assert 関数がコールされたファイル名
line
assert 関数がコールされた行番号
assertion
PHP 8.0.0 より前のバージョンでは、
この値は assert に渡された assertion でした。
但し、これは assertion が文字列として渡された場合に限られていました。
(assertion が 論理型の条件だった場合は、このパラメータは空文字列でした)。
PHP 8.0.0 以降では、このパラメータは常に &null; になります。
description
assert 関数に渡された説明
value
に空文字列を渡すと、assertコールバックはリセットされます。
&reftitle.returnvalues;
そのオプションの元の値を返します。
&reftitle.errors;
option が無効なオプションの場合、
ValueError がスローされます。
&reftitle.changelog;
&Version;
&Description;
8.3.0
assert_option は、推奨されなくなりました。
8.0.0
option が無効なオプションの場合、
ValueError がスローされるようになりました。
これより前のバージョンでは、&false; を返していました。
&reftitle.examples;
assert_options の例
]]>
&reftitle.seealso;
assert