詳細版:公式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 で提供します。公式版や公式の承認を示すものではなく、サイトデザインや無関係の記事へ適用する表示ではありません。