はじめに
Laravelのルーティングを書くとき、こんなコードを見ませんか?
use App\Http\Controllers\TestController;
Route::get('/hello', [TestController::class, 'hello']);
この記事では、 ::class と use について、Laravel初心者の方でもわかりやすいように、
この2つのキーワードがどんな役割を持っていて、なぜ一緒に使うのか?を
丁寧に解説していきます。
💡この記事で分かること
• ::class が実際に何をしているか
• use 文の意味と役割
• ルーティングでこの2つがどう活躍しているのか
• クラス名変更などのリファクタリングに強い理由
📚 目次
- ::class とは?
- クラスの「フルネーム」とは?
- ::class を使う理由
- use 文の役割と関係性
- 併用によるメリットと設計上の利点
- まとめ
- プラスα ⭐️ Laravel内の動作イメージを擬人化して捉えたら
- 参考リンク
1. ::class とは?
::class は、そのクラスの「フルネーム(名前空間付きクラス名)」を文字列として取り出すPHPの機能です。
Laravelで出てくるこちらの書き方
TestController::class
次の文字列とまったく同じ意味になります
"App\Http\Controllers\TestController"
2. クラスの「フルネーム」とは?
PHPの世界では、クラス名が被らないように「名前空間(namespace)」という仕組みがあります。
たとえば、次のような場所にファイルがあるとします
app/Http/Controllers/TestController.php
この場合のクラスのフルネームは
App\Http\Controllers\TestController
つまり、TestController::class は、このフルネームを「文字列」として返してくれる仕組みです。
3. ::class を使う理由
Laravelで ::class を使う理由は主に3つあります。
☑️ 1. タイプミスが減る
// 悪い例(手打ち)
["App\Http\Controllers\TestController", "hello"]
これは打ち間違いやすく、変更にも弱いです。
// 良い例
[TestController::class, 'hello']
::class を使うことによりクラス名を間違えにくくなります。
☑️ 2. 補完が効く(VSCodeなどで)
TestController::class を書き始めると、エディタが自動補完してくれるので速くて正確です。
☑️ 3. 名前を変更しても追従できる(リファクタリングに強い)
クラス名やフォルダ構成をあとで変更しても、エディタが追従してくれるため、大規模開発でも保守性が高くなります。
💡 リファクタリングとは?
動作は変えずに、コードの構造や書き方を改善すること。
可読性を上げたり、保守性を高めたりする目的で行います。
::class を使うことで、このリファクタリングがしやすくなり、ミスも起こりにくくなります。
4. use 文の役割と関係性
use App\Http\Controllers\TestController;
この use 文は、「このファイル内では TestController と書いたら、App\Http\Controllers\TestController のこととして使用する」という宣言です。
::class を使うときは、PHPに「それどこのクラス?」と迷わせないために use が必要になります。
5. 併用によるメリットと設計上の利点
use App\Http\Controllers\TestController;
Route::get('/hello', [TestController::class, 'hello']);
この組み合わせによって
• コードが短くて読みやすい
• 自動補完が効いて書きやすい
• 変更にも強い安全なコードになる
という、実用面でも可読性でも推奨される理にかなった記述スタイルとなります。
6. まとめ
::class ➡️ クラスの「フルネーム文字列」を取り出す機能
use 文 ➡️ クラスのフルネームを事前に定義しておくための宣言
組み合わせ ➡️ 誤りに強く、メンテナンス性にも優れた設計手法
7. プラスα ⭐️ Laravel内の動作イメージを擬人化して捉えたら
Laravel:「このURL リクエスト、どのコントローラで処理すればいい?」
Me :「'TestController::class' を指定してるから、そこにある 'hello' メソッドを使って!」
Laravel:「OK!'use' 文で名前空間も指定されてるから、探しに行くね!」
→ 処理完了!
// ① ルーティングの登録(routes/web.php)
use App\Http\Controllers\TestController;
Route::get('/hello', [TestController::class, 'hello']);
// ② リクエストが来ると、LaravelがURLとHTTPメソッドでルートを探す
// 例: GET /hello に対して、↑のルートがマッチ
// ③ Laravelがコントローラを呼び出す
$controller = new TestController();
$response = $controller->hello();
// ④ 処理が終わったら、結果(ビューや文字列など)をブラウザに返す
return $response;
※内部処理は簡易化しています
🔗 参考リンク
• Laravel公式ドキュメント:Routing
https://laravel.com/docs/12.x/routing
• Laravel公式ドキュメント:Controllers
https://laravel.com/docs/12.x/controllers
• PHP公式ドキュメント:名前空間と use 文
https://www.php.net/manual/en/language.namespaces.importing.php
• PHP公式ドキュメント:クラス定義と ::class
https://www.php.net/manual/en/language.oop5.basic.php