Composer Autoload 運用ガイド

概要

core_src/composer.json の autoload は PSR-4 を主とし、必要に応じて exclude-from-classmap を併用します。

背景: Autoload 設定

{
  "autoload": {
    "psr-4": {
      "App\\": "./",
      "MyCustom\\": "./"
    },
    "exclude-from-classmap": ["/webApi/swagger/generated/php/vendor/"]
  }
}

• PSR-4: 名前空間 App\ / MyCustom\ が core_src/ 直下のディレクトリ構造と対応。新規クラスは名前空間・ファイル配置を PSR-4 に合わせればオートロードに自動で含まれる。新規クラス追加時に composer dump-autoload を実行する必要はない。
• exclude-from-classmap: App\ / MyCustom\ は ./ 全体を指すため、--optimize 時にネストした webApi/swagger/generated/php/vendor/ まで走査され、数千行の PSR-4 Skipping 警告が出る。当該 vendor は独自の autoload を持つため classmap 対象外とする（実行時のクラス解決は変わらない）。

手順は他ドキュメントへ

目的	参照先
初回セットアップ	ローカル環境セットアップ
本番デプロイ前の Composer	本番環境デプロイ（ビルド手順に従い core_src で Composer を実行）
CI での実行内容	CI/CD ワークフロー概要

関連ドキュメント

• composer-autoload-quick-reference.md — クイックリファレンス
• composer-autoload-workflow-diagram.md — ワークフロー図
• Composer 公式ドキュメント — Autoload 設定

---

最終更新: 2026-07-20