PHPのCompileErrorとは？概要・構文・使い方をわかりやすく解説

はじめに

PHP 7.3 以降では、新しい例外クラスである CompileError が追加されました。このクラスは Error クラスを継承しており、以前は致命的エラー（fatal error）として処理され、スクリプト全体が停止していた一部のコンパイルエラーを、例外として捕捉できるようになった点が大きな特徴です。

この変更の影響を受けるのが、token_get_all() 関数です。この関数がスローする可能性のあるコンパイル系のエラーは、CompileError として扱われます。

token_get_all() 関数は、Zend 字句スキャナー（lexical scanner）を利用して、引数として渡された文字列を PHP 言語のトークン単位に解析する関数です。

構文

token_get_all ( string $source [, int $flags = 0 ] ) : array

パラメータ

TOKEN_PARSE フラグの重要性

CompileError を発生させられるようにするには、token_get_all() を必ず TOKEN_PARSE モードで使用する必要があります。このフラグを省略した場合、解析対象のコードに構文上の問題が含まれていても、例外はスローされません。

使用例

以下は、TOKEN_PARSE フラグを指定してコードを解析し、コンパイルエラーを try-catch ブロックで捕捉する基本的な例です。

<?php
try {
    // 解析したいPHPソースコード
    $source = '<?php echo "Hello, World!";';

    // TOKEN_PARSE フラグを指定して解析
    $tokens = token_get_all($source, TOKEN_PARSE);
    print_r($tokens);
} catch (CompileError $e) {
    // コンパイルエラーを捕捉して処理
    echo 'コンパイルエラーが発生しました: ' . $e->getMessage();
}
?>

まとめ

CompileError の導入により、PHP 7.3 以降では字句解析時に発生するコンパイルエラーを、致命的エラーではなく例外として制御できるようになりました。動的にコードを解析・評価するアプリケーションでは、token_get_all() を TOKEN_PARSE モードで利用し、CompileError を適切に捕捉することで、より堅牢なエラーハンドリングを実現できます。