2025/2/28の勉強会で発表されたものです。

1. DDEVでらくらく
Drupalローカル環境構築
2025/02/28
TaKo

2. DDEVとは
• 簡単にローカルWeb開発環境を起動できるオープン
ソースツール
• PHP と Node.js をサポート
• Dockerベースのツール
• コンテナ管理などを簡素にしてくれる
• Drupalの開発に推奨されているツール
★簡単にDrupalのローカル環境を構築できる
“The Drupal community selected DDEV as the recommended local development environment”
訳「Drupal コミュニティは、2024年6月にDDEVを推奨ローカル開発環境として選択」
出典：Drupal Wiki guide on Drupal.org 「Install Drupal using DDEV Installing Drupal」 https://www.drupal.org/docs/getting-started/installing-drupal/install-drupal-using-ddev#s-ddev (2025/02/21)

3. DDEVのインストール
MacOSの場合はhomebrewでインストール可能
＊Dockerもhomebrewでインストールできる
出典: DDEV 「Get Started」 https://ddev.com/get-started/ (2025/02/21)

4. DDEVでDrupalローカル環境を構築
以下の3ステップで構築できる
1.Drupal coreを準備
2.DDEVの設定ファイルを作成
• プロジェクトの種類などを指定するファイルを作成する
3.環境をビルド
• 設定に従い、Dockerコンテナなどを生成する

5. 1. Drupal coreを準備
ComposerでDrupal coreをダウンロードする
参考:https://new.drupal.org/download
composer create-project drupal/recommended-project ddev_drupal
...省略...
cd ddev_drupal
＊緑字はダウンロード先ディレクトリ名を示す
＊内容は一部省略
＊composerについては割愛

6. 2. DDEVの設定ファイルを作成
コマンド実行し設定ファイルを作成する
Project name (ddev-drupal): ddev-drupal
Docroot Location (web):
Project Type [backdrop, cakephp, craftcms, drupal, drupal6, drupal7, drupal8, drupal9, drupal10,
drupal11, laravel, magento, magento2, php, shopware6, silverstripe, symfony, typo3, wordpress]
(drupal11):
ddev config
対話形式で、設定できる
＊カッコ内の文字列はデフォルト値を示す
ディレクトリ内のをスキャンし、自動で適切と思われる値を入れてくれる様子
＊青字は入力値の例を示す
＊出力内容は一部省略

7. 2. DDEVの設定ファイルを作成
ミドルウェアのバージョンや
種類を指定することもできる
• PHPのバージョン
• WEBサーバの種類
• DBMSの種類
• などなど
name: ddev-drupal
type: drupal11
docroot: ""
php_version: "8.3"
webserver_type: nginx-fpm
xdebug_enabled: false
additional_hostnames: []
additional_fqdns: []
database:
type: mariadb
version: "10.11"
use_dns_when_possible: true
composer_version: "2"
web_environment: []
corepack_enable: true
設定ファイルの内容 抜粋

8. 3. 環境をビルド
以下のコマンドを実行する
ddev start
Successfully started ddev-drupal
Your project can be reached at https://ddev-drupal.ddev.site
See 'ddev describe' for alternate URLs.
以下のようなメッセージが出力されていればビルド成功
メッセージ記載のURLで、構築したサイトにアクセスできる

9. 3. 環境をビルド
ビルドが正常にできていれば、
Drupalインストール画面が表示される

10. ■付録 初期インストールもらくらく
DDEVが開発用の設定ファイルを自動で作成してくれるため
→DBコネクション設定などのステップを省略できる
less web/sites/default/settings.ddev.php
<?php
$host = "db";
$port = 3306;
$driver = "mysql";
$databases['default']['default']['database'] = "db";
$databases['default']['default']['username'] = "db";
$databases['default']['default']['password'] = "db";
$databases['default']['default']['host'] = $host;
$databases['default']['default']['port'] = $port;
$databases['default']['default']['driver'] = $driver;
$settings['hash_salt'] =
'6eb9ae758f0cdec1be31f959fafcd3c9d208bb175c9613039ed39109c00064
99';
// This will prevent Drupal from setting read-only permissions on
sites/default.
$settings['skip_permissions_hardening'] = TRUE;
// This will ensure the site can only be accessed through the intended host
// names. Additional host patterns can be added for custom configurations.
$settings['trusted_host_patterns'] = ['.*'];
// Set $settings['config_sync_directory'] if not set in settings.php.
if (empty($settings['config_sync_directory'])) {
$settings['config_sync_directory'] = 'sites/default/files/sync';
}
// Override drupal/symfony_mailer default config to use Mailpit.
$config['symfony_mailer.settings']['default_transport'] = 'sendmail';
$config['symfony_mailer.mailer_transport.sendmail']['plugin'] = 'smtp';
$config['symfony_mailer.mailer_transport.sendmail']['configuration']['user'
] = '';
$config['symfony_mailer.mailer_transport.sendmail']['configuration']['pass'
] = '';
$config['symfony_mailer.mailer_transport.sendmail']['configuration']['host'
] = 'localhost';
$config['symfony_mailer.mailer_transport.sendmail']['configuration']['port'
] = '1025';
// Enable verbose logging for errors.
// https://www.drupal.org/forum/support/post-installation/2018-07-
18/enable-drupal-8-backend-errorlogdebugging-mode
$config['system.logging']['error_level'] = 'verbose';

11. 最後に
Drupalの
ローカル環境構築は
DDEVを使うとかんたん！