INTEREST JOURNAL DRUPAL & WEB

Drupalガイド詳細:3.6 Composerでファイルと依存関係を管理する

約2,100文字 読了目安:約5分

English ↗
この記事の目次

詳細版:公式User Guide 3.6を翻訳・再構成した非公式の解説です。原文の更新表示は2025年4月14日、今回の参照日は2026年11月6日です。Drupal実機での手順検証は未実施です。

公式原文 ↗ · 前へ: 3.5 DDEVでローカル環境を用意する · 第3章の入口 · 次へ: 3.7 対話式インストーラーを実行する

このページの目的

ComposerでDrupalや拡張のファイルを取得・更新する考え方を学びます。DBの初期化やモジュールの有効化とは区別します。3.3のツール を先に読み、作業環境へComposerが用意されていることを確認します。

コアを新しく取得する

公式は、導入先の一つ上のディレクトリで、次のコマンドを使う例を示しています。mydirは新しく作るプロジェクト名です。

composer create-project drupal/recommended-project mydir

Web公開先はmydir/web、Composerのプロジェクトルートはmydirとして区別します。この例は版を固定していません。対象系列・要件を先に選び、既存サイトの中へ重ねて新規作成しないようにします。

追加モジュール・テーマを取得する

原文はプロジェクトURLの末尾を短い名前として使い、Geofieldを例に次を示しています。Composer管理済みプロジェクトのルートで行う取得の例です。

composer require drupal/geofield

ファイルを取得したことと、Drupalで機能を導入・有効化することは別です。対象の互換性や依存関係は、プロジェクトの説明で確認します。

更新と再現を区別する

原文にはcomposer update drupal/geofield --with-dependenciesや、古い特定版を指定する例があります。本ページでは、それらの古い番号を現在の推奨版としては示しません。

Composer公式 では、lockファイルがある場合のinstallはそこに記録した版を使うと説明しています。updateによる依存関係の見直しと、既に決めた構成を再現する処理を区別します。composer.jsonとcomposer.lock、vendor/、オートローダーなど、相互に整合した成果物を扱います。

コア更新の読み替え

Drupal公式のComposer更新手順 ↗ は、core-recommended構成について次を例示しています。

composer update "drupal/core-*" --with-all-dependencies

構成がdrupal/coreだけの場合などは手順が異なります。この一行だけで更新が完了するわけではなく、バックアップ、依存関係、DB更新、キャッシュ、ステータス確認などは第13章の要約 と公式手順で確認します。ここで上記コマンドは実行していません。

本サイトの確認例

変更前後のJSONとlockの差分、対象パッケージの実際の版、WebとCLIのPHP要件、Drupal側の状態を記録します。原文にはローカルで準備して本番へ転送する説明もありますが、単独フォルダーを無条件に削除する手順としては適用せず、整合したビルドと復旧手順を確認します。

更新注釈:テンプレートと起動処理

Drupal 11.4.0 ↗ はSymfony Runtimeの採用とlegacy-projectの非推奨化を案内しています。新規構築にはrecommended-projectを使い、独自フロントコントローラーがある場合は変更記録を確認します。既存のものは少なくともDrupal 12までは動くとの説明があり、直ちにすべて書き換える指示ではありません。

章の既存注釈 も参照してください。

出典・帰属・変更内容

原典はDrupal User Guide 3.6 ↗ です。原文のAttributionsに記載された貢献者・元資料:Jennifer Hodgdon ↗ · Hans Fredrik Nordhaug ↗ · Joe Shindelar ↗ · Drupalize.Me · “Using Composer to manage Drupal site dependencies” ↗ · Drupal Community Documentation ↗ 。各人の執筆・編集・翻案の役割は公式原文、全体の帰属は公式A.1 ↗ を参照してください。

原著の著作権は各貢献者にあり、公式著作権ページ ↗ は© 2015–2025と表記しています。変更点は、日本語への翻訳、説明・手順の再構成、独自の準備・確認・見直し例、原文の表記や更新情報への補足です。公式の画面画像・動画は転載していません。本文は原典と同じCC BY-SA 2.0 で提供します。公式版や公式の承認を示すものではなく、サイトデザインや無関係の記事へ適用する表示ではありません。

前へ: 3.5 DDEVでローカル環境を用意する · 第3章の入口 · 次へ: 3.7 対話式インストーラーを実行する

第2章の詳細一覧 · 第4章 · ガイド全体 · 公式情報を検索

この章の目次へ ↗