PHP予約語リスト：最新バージョン対応の命名ルールと実例解説

2026年5月15日

基本構文

PHPプログラミングにおいて、プログラミング言語側であらかじめ役割が決められている「予約語」を正しく理解することは、エラーのない堅牢なコードを書くための第一歩です。

予約語を理解せずに変数名や関数名を定義しようとすると、構文エラーが発生し、プログラムが正常に動作しなくなる原因となります。

本記事では、PHPの最新バージョンに対応した予約語のリストから、命名ルールにおける注意点、そして実務で役立つ具体的な回避策まで詳しく紹介します。

目次 [ close ]

PHP予約語の基礎知識

PHPにおける予約語とは、PHPのエンジン自体が構文解析のために使用する、特別な意味を持つ単語のことです。

これらの単語は、クラス名、関数名、メソッド名、またはトレイト名として使用することが原則として禁止されています。

もし予約語を識別子（ユーザーが定義する名前）として使用しようとすると、PHPは「Parse error: syntax error」というエラーを返します。

予約語には、制御構造に関するもの、型宣言に関するもの、そしてマジック定数と呼ばれる特殊な定数などが含まれます。

PHPはバージョンアップを重ねるごとに新しい機能が追加されるため、それに伴い新しい予約語も増えていく傾向にあります。

特にPHP 8.x以降では、新しい構文の導入により、これまで自由に使えていた単語が予約語に指定されるケースも珍しくありません。

開発者は、自身が利用しているPHPのバージョンにおいて、どの単語が制限されているかを常に把握しておく必要があります。

最新バージョン対応：PHP予約語リスト

ここでは、PHPで定義されている主要な予約語を分類して紹介します。

これらのリストに含まれる単語は、識別子として使用しないように注意してください。

制御構造およびキーワード

プログラムの流れを制御するために使用されるキーワードです。

カテゴリ	予約語
条件分岐	if, else, elseif, switch, case, default, match
ループ	for, foreach, while, do, continue, break
関数・クラス定義	function, class, interface, trait, extends, implements, abstract, final, static
名前空間・インクルード	namespace, use, include, include_once, require, require_once
例外処理	try, catch, finally, throw
その他構文	return, yield, list, array, empty, isset, unset, eval, exit, die, clone, new, print, echo

型に関する予約語

PHP 7以降、スカラー型宣言が強化されたことにより、以下の単語はクラス名やインターフェース名としての使用が制限されています。

bool
int
float
string
iterable
object
mixed（PHP 8.0以降）
never（PHP 8.1以降）
void

これらの型名は、引数や戻り値の型ヒントとして利用されるため、ユーザー定義の型名として使用することは避けるべきです。

マジック定数

PHPには、実行時の状況に応じて値が変化する「マジック定数」が存在します。

これらは厳密にはキーワードではありませんが、定義済みの定数として扱われるため、ユーザーが再定義することはできません。

__LINE__：現在の行番号
__FILE__：ファイルのフルパスとファイル名
__DIR__：ファイルが存在するディレクトリのパス
__FUNCTION__：現在の関数名
__CLASS__：現在のクラス名
__TRAIT__：現在のトレイト名
__METHOD__：現在のクラスメソッド名
__NAMESPACE__：現在の名前空間の名前

命名ルールにおける制約と実例

予約語を識別子として使おうとした場合に、どのような挙動になるのかをコード例とともに見ていきましょう。

基本的には、予約語をクラス名や関数名にそのまま使うことはできません。

クラス名に予約語を使用した場合のエラー

例えば、classという名前のクラスを作成しようとすると、PHPは即座にエラーを出力します。

PHP

<?php
// クラス名に予約語「List」を使用しようとする例
class List {
    public function display() {
        echo "Hello";
    }
}
?>

このコードを実行すると、以下のようなエラーが表示されます。

実行結果

Parse error: syntax error, unexpected 'List' (T_LIST), expecting identifier (T_STRING)

PHP 8.0以降では「match」も予約語に追加されているため、古いコードを移行する際は注意が必要です。

メソッド名としての予約語

PHPの興味深い仕様として、クラスのメソッド名には、一部の予約語を使用できるという点があります。

これはPHP 7.0以降で導入された「Context Sensitive Lexer」による緩和措置です。

PHP

<?php
class TaskManager {
    // メソッド名として「list」や「include」を使用可能
    public function list() {
        echo "リストを表示します。";
    }

    public function include() {
        echo "インクルード処理を実行します。";
    }
}

$manager = new TaskManager();
$manager->list();
?>

実行結果

リストを表示します。

このように、メソッド名として使用することは文法上可能ですが、可読性や混乱を避ける観点からは推奨されません。

他の開発者がコードを見た際に、標準関数のlist()と混同するリスクがあるからです。

プロパティ名としての予約語

プロパティ名（変数名）についても、$this->listのようにアクセスする場合は予約語を使用することが可能です。

ただし、通常の変数名として$listや$forを使うことは禁止されていません。

予約語の制限は主に「関数名」「クラス名」「定数名」に適用されることを覚えておきましょう。

命名衝突を避けるためのベストプラクティス

予約語との衝突を避け、かつ保守性の高いコードを書くための具体的な手法を解説します。

名前空間（Namespace）の活用

名前空間を使用することで、ユーザー定義のクラス名がPHP標準のクラス名や将来追加される予約語と衝突するリスクを大幅に軽減できます。

例えば、App\Core\Collectionのように階層化された名前空間を使用すれば、Collectionという一般的な単語も安全に使用できます。

PHP

<?php
namespace App\Service;

class Logger {
    public function log(string $message) {
        echo "[LOG]: " . $message;
    }
}
?>

ただし、名前空間のルート（グローバル空間）にクラスを配置することは避けるべきです。

プレフィックスやサフィックスの付与

単一の単語を識別子にするのではなく、役割に応じた接頭辞（プレフィックス）や接尾辞（サフィックス）を付けることも有効です。

list → userList / itemList
class → cssClass / categoryClass
function → callbackFunction

このように意味を具体化することで、予約語との重複を回避できるだけでなく、コードの自己文書化（読みやすさ）にも繋がります。

PSR（PHP Standard Recommendation）の遵守

PHP開発者のコミュニティによって策定された標準規約である「PSR」に従うことも、予期せぬ命名トラブルを防ぐ鍵となります。

PSR-12などのコーディング規約では、クラス名はStudlyCaps（アッパーキャメルケース）、メソッド名はcamelCase（ローワーキャメルケース）で記述することが推奨されています。

予約語の多くは小文字で構成されているため、適切なキャメルケースを使用することで、視覚的にも区別しやすくなります。

PHPのバージョンアップに伴う予約語の変化

PHPは進化を続けており、過去のバージョンでは問題なかったコードが、最新バージョンではエラーになることがあります。

PHP 8.0で追加された予約語

PHP 8.0では、新たにmatch式が導入されました。

これにより、以前のバージョンでfunction match()のように定義していたコードは、PHP 8.0以降では動作しません。

PHP 8.1以降の変更点

PHP 8.1では、readonlyプロパティが導入されました。

当初は完全な予約語として検討されましたが、互換性を考慮し、クラス名としての使用は制限されるものの、メソッド名やプロパティ名としては利用できる「準予約語」のような扱いになっています。

しかし、将来的に制限が強まる可能性も否定できないため、新しく定義する識別子には「readonly」を使用しないのが賢明です。

PHP 9.0を見据えた命名戦略

2026年現在の最新状況を踏まえると、PHP 9.0以降でも新しい構文の追加が予想されます。

将来の予約語候補となりそうな「一般的な動詞」や「プログラミング用語」をそのままクラス名にするのは避けましょう。

例えば、enumはPHP 8.1で予約語となりましたが、それ以前から列挙型を模したクラスとして利用していたプロジェクトは多く、移行作業に手間取ったケースが見受けられました。

予約語かどうかを確認する方法

自分が使おうとしている名前が予約語かどうか不安な場合は、いくつかの確認方法があります。

公式マニュアルの参照

PHPの公式ドキュメントには「予約語の一覧（List of Reserved Words）」というページが存在します。

常に最新の情報が更新されているため、開発環境のPHPバージョンに合わせて確認する癖をつけましょう。

IDE（統合開発環境）の警告機能

PhpStormやVisual Studio Code（PHP Intelephense拡張など）を使用していれば、予約語を識別子として使おうとした瞬間に波線で警告が表示されます。

エディタのシンタックスハイライト（色付け）機能も、予約語を識別するのに役立ちます。

予約語は通常、変数や関数とは異なる色で強調表示されるため、意図せず色が変わった場合は予約語を疑ってください。

PHPの組み込み関数の利用

動的に定義を行う場合など、プログラムコード内で予約語を判定したい場面があるかもしれません。

PHPには特定の名前が予約語であるかを直接判定する専用関数はありませんが、token_get_all()関数を使用してトークン解析を行うことで判別が可能です。

予約語と定義済みクラス・インターフェースの違い

初心者が混同しやすいポイントとして、「予約語」と「標準定義済みクラス」の違いがあります。

ExceptionやstdClass、ArrayAccessなどは予約語ではありませんが、PHP本体で定義されているクラスやインターフェースです。

これらと同じ名前で自作クラスを作ろうとすると、名前の衝突（Name Collision）が発生します。

予約語は「文法レベルでの制限」であり、定義済みクラスは「シンボル名としての重複」という違いがありますが、結果としてエラーになる点は同じです。

そのため、PHPが標準で提供しているクラスライブラリの名前も把握しておくことが、スムーズな開発には不可欠です。

実務でのトラブル事例と解決策

現場で実際に起こりやすい予約語に関連するトラブルとその解決策を紹介します。

外部ライブラリのアップデートによる破損

自作コードではなく、依存している外部ライブラリがPHPの新しいバージョンに対応していない場合、ライブラリ内の予約語利用が原因でシステム全体が止まることがあります。

この場合、ライブラリのアップデートを待つか、一時的に古いPHPバージョンを維持する、あるいは名前空間を調整するパッチを当てる必要があります。

常にcomposer updateを実行する前に、チェンジログでPHPの互換性を確認する習慣をつけましょう。

データベースのカラム名との不一致

データベースのテーブル設計でorder（注文）やgroup（グループ）といった予約語を使用している場合、PHP側でそのままの変数名を使うと混乱を招きます。

DBのカラム名とPHPの変数名を完全に一致させる必要はありません。

コード内では$orderRecordや$groupTypeのように、意味を補完する命名を心がけましょう。

まとめ

PHPの予約語は、言語の仕様を維持し、誤解のない構文解析を行うために必要不可欠な存在です。

ifやclassといった基本的なものから、matchやreadonlyといった比較的新しいものまで、その数は多岐にわたります。

これらを避けるための最も有効な手段は、適切な名前空間の利用と、PSRに基づいた意味のある命名を行うことです。

また、PHP 8.xからPHP 9.xへと続く進化の中で、予約語のリストは今後も変動していくことが予想されます。

最新の情報を常にチェックし、IDEの支援を最大限に活用しながら、クリーンでエラーのないコードを記述していきましょう。

命名に迷ったときは、その単語が「一般的すぎないか」「PHPの将来の機能とぶつからないか」を一歩立ち止まって考えることが、長期的な保守性を高める秘訣です。