composer.json・とは？初心者が押さえる基本と使い方ガイド共起語・同意語・対義語も併せて解説！

この記事を書いた人

岡田康介

名前：岡田康介（おかだこうすけ）ニックネーム：コウ、または「こうちゃん」年齢：28歳性別：男性職業：ブロガー（SEOやライフスタイル系を中心に活動）居住地：東京都（都心のワンルームマンション）出身地：千葉県船橋市身長：175cm 血液型：O型誕生日：1997年4月3日趣味：カフェ巡り、写真撮影、ランニング、読書（自己啓発やエッセイ）、映画鑑賞、ガジェット収集性格：ポジティブでフランク、人見知りはしないタイプ。好奇心旺盛で新しいものにすぐ飛びつく性格。計画性がある一方で、思いついたらすぐ行動するフットワークの軽さもある。 1日（平日）のタイムスケジュール 7:00 起床：軽くストレッチして朝のニュースをチェック。ブラックコーヒーで目を覚ます。 7:30 朝ラン：近所の公園を30分ほどランニング。頭をリセットして新しいアイデアを考える時間。 8:30 朝食＆SNSチェック：トーストやヨーグルトを食べながら、TwitterやInstagramでトレンドを確認。 9:30 ブログ執筆スタート：カフェに移動してノートPCで記事を書いたり、リサーチを進める。 12:30 昼食：お気に入りのカフェや定食屋でランチ。食事をしながら読書やネタ探し。 14:00 取材・撮影・リサーチ：街歩きをしながら写真を撮ったり、新しいお店を開拓してネタにする。 16:00 執筆＆編集作業：帰宅して集中モードで記事を仕上げ、SEOチェックやアイキャッチ作成も行う。 19:00 夕食：自炊か外食。たまに友人と飲みに行って情報交換。 21:00 ブログのアクセス解析・改善点チェック：Googleアナリティクスやサーチコンソールを見て数字を分析。 22:00 映画鑑賞や趣味の時間：Amazonプライムで映画やドラマを楽しむ。 24:00 就寝：明日のアイデアをメモしてから眠りにつく。

はじめに

このページでは「composer.json・とは？」について、初心者にも分かるように丁寧に解説します。難しい専門用語を避け、実際の例を使って理解できるようにします。まずは結論から。composer.jsonは、PHP の「依存関係」を管理するための「設定ファイル」です。これを使うと、必要なライブラリ（他の人が作った機能のまとまり）を一括で追加したり、アプリの動作に合わせて自動的に読み込んだりできます。

composer.jsonとは何か

Composerは PHP のパッケージ管理ツールです。プログラムを作るとき、他の人が作った機能を使いたくなる場面が多くあります。そのとき、依存関係と呼ぶ「この機能とこの機能が同時に必要」という組み合わせを管理してくれるのが Composer です。composer.jsonはその依存関係の「リスト」を保存するファイルです。これを編集するだけで、必要なライブラリの名前とバージョン、読み込み方などを決められます。

実務では、プロジェクトを他の人と共有するときにもこのファイルが欠かせません。新しく参加した人はこのファイルを見て、同じ環境をすぐ再現できます。つまり、composer.jsonは“何を入れるのか”と“どう動くのか”を決める地図のような役割を果たします。

基本の書き方と代表的なフィールド

実際には JSON 形式で記述しますが、ここでは中学生にもわかるように、代表的なフィールドをざっくり解説します。以下はよく使われる項目です。

name：ベンダー/パッケージ名（例: vendor/package）
description：パッケージの説明
require：このパッケージが必要としている他のライブラリとバージョン
require-dev：開発時だけ必要な依存関係
autoload：自動読み込みの設定（どの名前空間をどのフォルダから読み込むか）
scripts：よく使うコマンドのショートカット
config：パフォーマンスなどの挙動設定

サンプルの一部

以下は実務でよく使われる項目の例です。実際のファイルは JSON の形式で記述しますが、ここでは要点だけ示します。

able> name vendor/package description このパッケージの説明 require php: ^8.0、monolog/monolog: ^2.0 autoload psr-4: App\\ => src/ scripts test: phpunit ble>

実際の使い方とコマンド

composer.json がある状態で、以下のコマンドを実行します。コマンドは端末（ターミナル）で入力します。

composer init：新しいプロジェクトの composer.json を対話形式で作成します。

composer install：composer.json に書かれた依存関係を書き写し、実際のライブラリをダウンロードして配置します。

composer update：依存関係を最新の互換性のあるバージョンへ更新します。

重要なポイントとして、autoloadの設定は、あなたのコードが自動的に読み込まれる場所を決めます。PSR-4 という標準に従うと整理がしやすく、クラス名とファイルの対応が直感的になります。これにより、毎回ファイルを読み込む処理を書く手間が減ります。

初めての作業：自分のプロジェクトに導入する手順

1) プロジェクトのルートに移動します。
2) composer.json がない場合は composer init で新しく作成します。
3) 依存したいライブラリを require に追加します。
4) composer install を実行して実際のファイルをダウンロードします。
5) autoload を設定して、あなたのクラスが自動的に読み込まれるようにします。

注意点とコツ

バージョンの表現方法にはいろいろな書き方がありますが、初心者には「^」や「~」で近い将来の互換性を示すのが基本です。これにより、将来の更新で壊れにくくなります。

JSONは厳密な形式です。ダブルクォーテーションでキーと文字列を囲み、カンマで区切ります。実務ではこの点を守ることが、後のエラー回避につながります。

まとめ

この記事で、composer.json・とは？、および composer.json の役割、代表的なフィールド、使い方の基本、そして実務での注意点を押さえることができました。Composerを使うと依存関係の管理が楽になり、プロジェクトの再現性が高まります。初心者のうちから慣れておくと、将来の開発で大きな武器になります。

composer.jsonの同意語

Composer依存関係定義ファイル: PHPプロジェクトで、依存するライブラリとそのバージョンの条件を宣言する、いわば依存性のリスト。通常はプロジェクトのルートにあるcomposer.jsonがこれに当たる。
パッケージ依存宣言ファイル: プロジェクトが必要とする外部パッケージとバージョン情報をJSON形式で宣言するファイル。
Composer設定ファイル: Composerの動作を制御する設定情報を含むファイル。実質は依存関係の宣言が中心。
プロジェクトマニフェスト: プロジェクトの構成要素と依存関係を総称して説明する文書的ファイル。
JSON形式の依存関係ファイル: 依存関係をJSONで整理したファイル。機械に読み取らせる前提のデータ構造。
Composerのマニフェストファイル: Composerが読み取る、プロジェクトの依存関係と基本情報をまとめたファイル。
PHPのパッケージ管理用定義ファイル: PHPプロジェクトのパッケージ管理の定義情報を集約したファイル。
依存関係宣言JSONファイル: このファイルには、どのライブラリを使うかと、そのバージョンの条件をJSON形式で記述します。
Composer用の宣言ファイル: Composerが認識する依存関係・設定を宣言するファイル。
ライブラリ依存を宣言するファイル: 外部ライブラリの利用を宣言して、インストール時に自動取得される対象を決めるファイル。

composer.jsonの対義語・反対語

手動管理.json: 依存関係を自動で解決・更新する機能を使わず、手動でライブラリを管理する想定のファイル名。
依存関係なし.json: 外部ライブラリへの依存を一切宣言していない状態を表すファイル名。
空.json: 中身が空で、設定や依存情報を何も含まない状態を表すファイル名。
最小構成.json: 設定を最小限に絞った状態を表すファイル名。Composer の豊富な機能を避けるイメージ。
設定なし.json: 設定自体が存在しない、もしくは無効化された状態を示すファイル名。
composer.lock: 依存の正確なバージョンを固定して再現性を高めるファイル。反対のイメージは、依存を動的に解決するファイル。
package.json: Node.js のパッケージマネージャ用設定ファイル。別エコシステムの依存管理ファイルとして、対照的なイメージ。
自動解決拒否.json: 自動での依存解決を拒否する設定を示唆するファイル名。

composer.jsonの共起語

Composer: PHPの依存関係管理ツール。プロジェクトのパッケージを自動的にインストール・更新する仕組みを提供します。
composer.json: Composerの設定ファイルで、依存関係・自動読み込み・スクリプトなどをJSON形式で定義します。
PHP: Composerを利用するための実行環境となるプログラミング言語。
Packagist: デフォルトの公開パッケージリポジトリで、パッケージの取得元としてよく使われます。
dependencies: プロジェクトが必要とする他のライブラリの集合。通常は require で宣言します。
require: 本番環境で必須となる依存パッケージを宣言するセクション。
require-dev: 開発時にのみ必要な依存パッケージを宣言するセクション。
autoload: 自動読み込みの設定。クラスの名前空間とファイルの対応を定義します。
autoload-dev: 開発環境用の自動読み込み設定。
psr-4: PSR-4規約に基づく自動読み込み設定。名前空間とディレクトリ構成を対応づけます。
psr-0: 旧式の自動読み込み規約（PSR-0）を定義する場合に使用します。
classmap: 特定ディレクトリをクラスマップとして登録し、読み込み時に検索します。
files: 起動時に読み込まれるファイルを列挙するオプション。
extra: パッケージに対する追加設定を格納するセクション。
config: Composerの挙動を細かく制御する設定をまとめたセクション。
minimum-stability: 依存パッケージの最低安定性を指定します（stable, RC, beta, alpha, dev など）。
prefer-stable: 安定版を優先するかどうかを指定します。
repositories: 追加のパッケージリポジトリを指定します（デフォルトは Packagist）。
name: パッケージの識別子。vendor/package の形式で記述します。
version: パッケージのバージョン。
description: パッケージの説明文を記述します。
license: ライセンス情報を指定します（例: MIT、GPL-3.0など）。
keywords: パッケージの検索キーワードを配列で指定します。
type: パッケージの種類。library か project など。
authors: 著者情報の配列。
provide: このパッケージが提供する機能を宣言します。
replace: 他パッケージの代替として使用できることを宣言します。
conflict: 競合する可能性のあるパッケージを宣言します。
scripts: イベント時に実行されるコマンドの定義。post-install-cmd などを含みます。
post-install-cmd: 依存パッケージのインストール後に実行されるコマンドの指定（scriptsセクション内で使用）。
post-update-cmd: 依存パッケージの更新後に実行されるコマンドの指定（scriptsセクション内で使用）。
platform: プラットフォーム要件を config.platform で指定します（例: php のバージョン）。
bin: このパッケージが提供する実行ファイルを示します（vendor/bin へ配置されることが多い）。
homepage: プロジェクトの公式ページURLを指定します。
suggest: 他のパッケージを“提案”として推奨する依存関係を列挙します。
dist: 配布の設定情報を記述します（パッケージのソースやディストリビューション情報）。
source: ソースURLやブランチ情報を記述する場合に使われます。

composer.jsonの関連用語

composer: PHP の依存関係管理ツール。パッケージの検索・解決・インストール・更新などを行います。
composer.json: プロジェクトの依存関係と設定を JSON 形式で記述するファイル。名前やライセンス、オートロード設定などを定義します。
composer.lock: 実際にインストールされたパッケージの正確なバージョンを固定するファイル。再現性のあるビルドを実現します。
Packagist: 公式の PHP パッケージリポジトリ。Composer のデフォルトのパッケージ供給源です。
autoload: 自動読み込み設定のセクション。クラスファイルの自動読み込みルールを定義します。
PSR-4: 自動読み込み規約の一つ。名前空間とディレクトリ構成を対応させる標準です。
PSR-0: 旧来の自動読み込み規約。現在は PSR-4 が主流となっています。
require: このプロジェクトが必須とする依存パッケージとバージョン制約を列挙します。
require-dev: 開発時にのみ必要な依存パッケージを列挙します。
scripts: インストールや更新時に実行されるカスタムスクリプトを定義します。例として post-install-cmd などがあります。
config: インストール挙動や解決の挙動を調整する設定を格納します。たとえば優先インストール先や最適化設定など。
minimum-stability: 依存パッケージの最低安定性を指定します。stable がデフォルトです。
prefer-stable: 安定版を優先してインストールするかどうかを設定します。
repositories: 追加のパッケージリポジトリを宣言します。リポジトリの種類や場所を指定します。
autoload-dev: 開発用のオートロード設定を定義します。
bin: 実行可能ファイルのパスを列挙します。通常は vendor/bin に展開されます。
name: パッケージの名前。ベンダー名とパッケージ名を組み合わせるのが一般的です。
description: パッケージの要約説明です。
type: パッケージのタイプを示します。例: library, project, metapackage など。
license: ライセンス情報を記述します。
authors: 著者の情報を配列で記述します。名前やメール、役割などを含めます。
keywords: パッケージを表すキーワードの配列。検索性を高めます。
replace: このパッケージが他のパッケージを置換できることを宣言します。他のパッケージの依存を回避する際に便利です。
provide: 仮想パッケージを提供することを宣言します。互換性のある別パッケージを示す際に使います。
conflicts: 競合するパッケージを宣言します。同時にインストールできない組み合わせを示します。
extra: パッケージ固有の追加設定を格納する小さな領域です。
support: サポート情報のセクション。ドキュメントやIssue トラッカー、連絡先などを案内します。
vendor: 依存パッケージが展開されるディレクトリ。通常はプロジェクトのルートに作成されます。
composer install: composer.json の依存関係を解決して vendor にパッケージをインストールします。composer.lock に基づく再現性が保たれます。
composer update: 依存関係を更新して最新の解決方針に従い、composer.lock を更新します。