Composerと依存管理、autoload

Composerは「部品の調達係」

Composer は、PHPの「依存管理ツール」です。アプリは、認証やPDF生成など、他の人が作った便利なライブラリ(部品)を組み合わせて作ります。それらの部品を、必要なバージョンで自動的にダウンロードして揃えてくれるのがComposerです。Laravel本体もComposerで導入されます。

「依存(dependency)」とは、自分のアプリが動くために必要としている外部の部品のことです。これらを手作業でダウンロードして配置するのは大変で、バージョンの食い違いも起きます。Composerはこの調達とバージョン管理を肩代わりします。

composer.json は「欲しい物リスト」

どの部品をどのバージョン範囲で使いたいかは、composer.json というファイルに書きます。これは「欲しい物リスト」にあたります。人が読み書きする、意図を書くファイルです。

{
  "require": {
    "php": "^8.2",
    "laravel/framework": "^11.0",
    "guzzlehttp/guzzle": "^7.8"
  }
}

composer.lock は「実際に入れた物の記録」

一方 composer.lock には、実際にインストールされた「正確なバージョン」が記録されます。composer.json が「11系ならよい」という幅を持つのに対し、lockは「今回入れたのは 11.9.2 だった」という一点を固定します。

autoload: クラスを自動で読み込む仕組み

オートロード(autoload)とは、必要なクラスファイルを、使う瞬間に自動で読み込んでくれる仕組みです。Composerは、クラス名(名前空間)とファイルの場所の対応を管理し、いちいち手作業で require しなくてもクラスが使えるようにします。だから Day2 Lesson2 で見た namespace の規約が重要になるのです。

// 使うクラスの数だけ手でrequireが必要
require "app/Models/User.php";
require "app/Models/Post.php";
require "app/Http/Controllers/UserController.php";
$user = new User();

// requireは不要。名前空間から自動で解決される
use App\Models\User;

$user = new User();