exit
(PHP 4, PHP 5, PHP 7)
exit — メッセージを出力し、現在のスクリプトを終了する
説明
exit
([ string $status
] ) : void
exit
( int $status
) : void
スクリプトの実行を終了します。
シャットダウン関数
や オブジェクトのデストラクタ
は、exit
がコールされた場合にも実行されます。
exit
は言語構造です。
status
を指定しない場合は括弧なしでコールできます。
パラメータ
status
status
が文字列の場合は、この関数は終了直前にstatus
を表示します。status
が int の場合は その値が終了ステータスとして使われ、表示はされません。終了ステータスは 0 から 254 までの値でなければなりません。終了ステータス 255 は PHP に予約されており、使用してはいけません。ステータス 0 は、 プログラムを正常終了させる際に使用します。
返り値
値を返しません。
例
例1 exit
の例
<?php$filename = '/path/to/data-file';$file = fopen($filename, 'r') or exit("ファイル ($filename) をオープンできません");?>
例2 exit
でステータスを指定する例
<?php// 正常終了exit;exit();exit(0);// エラーコードつきの終了exit(1);exit(0376); // 八進数?>
例3 シャットダウン関数やデストラクタが実行される例
<?phpclass Foo{ public function __destruct() { echo 'Destruct: ' . __METHOD__ . '()' . PHP_EOL; }}function shutdown(){ echo 'Shutdown: ' . __FUNCTION__ . '()' . PHP_EOL;}$foo = new Foo();register_shutdown_function('shutdown');exit();echo 'これは出力されません。';?>
上の例の出力は以下となります。
Shutdown: shutdown() Destruct: Foo::__destruct()