Drupal CMS 再構築

• 最近、仮想環境とコンテナのメリットが少し理解できて来ています。簡単に追加削除できる異なる指定環境（PHPのバージョンやDBのバージョンなど）のLAMP環境が簡単に用意出来ます。
• 異なる指定環境（PHPのバージョンやDBのバージョンなど）で開発出来ることは、複数のプラットフォームが異なるWebサイトを構築したりする際に非常に恩恵があります。

1. インストール済みのDrupal CMSのアッデート > アップデートが上手く進まないので、再インストールを行う > 既存のDrupal CMSの削除
2. 新しいDrupal CMSのインストールをAppにて行ってみる > Appのインストールに問題があるので断念 > AppでインストールしたDrupal CMSを削除
3. DDEVでDrupalCMSのインストール > エラーの確認と対応

DDEVでのDrupalの削除

DDEVでのDrupalプロジェクトの削除は、DDEVが管理するWebやDBを削除します。DDEVでの削除後、ディレクトリにはDrupalの設定ファイルが残りますが、使用しないのであればディレクトリ毎削除しても大丈夫なのでディレクトリも削除します。

// DDEVのプロジェクト削除
---
% ddev delete drupal-cms  --omit-snapshot --yes
---
# ddev delete : プロジェクトの削除
# drupal-cms : プロジェクトディレクトリ
#  --omit-snapshot : DBのバックアップ
# --yes  : 削除の確認をしない
---
// DDEVプロジェクトの確認
% ddev list
┌──────────┬────────────────────┬────────────┬───────────────────────────┬──────────┐
│ NAME     │ STATUS             │ LOCATION   │ URL                       │ TYPE     │
├──────────┼────────────────────┼────────────┼───────────────────────────┼──────────┤
│ dr-cv-tm │ stopped            │ ~/dr-cv-tm │                           │ drupal11 │
├──────────┼────────────────────┼────────────┼───────────────────────────┼──────────┤
│ dr103    │ stopped            │ ~/dr103    │                           │ drupal10 │
├──────────┼────────────────────┼────────────┼───────────────────────────┼──────────┤
│ dr11     │ stopped            │ ~/dr11     │                           │ drupal11 │
├──────────┼────────────────────┼────────────┼───────────────────────────┼──────────┤
│ Router   │ OK                 │ ~/.ddev    │ http://127.0.0.1:10999    │          │
└──────────┴────────────────────┴────────────┴───────────────────────────┴──────────┘
# drupal-cmsは削除されています

DDEVでプロジェクトの削除が完了しましたので、ディレクトリの削除をします。Finderでディレクトリを選択して"ゴミ箱に入れる"を選択し、その後ゴミ箱を空にすれば完全に削除できます。コマンドラインから削除する場合は以下になります。

#Drupal CMSのディレクトリを削除
% rm -rf drupal-cms
# drupal-cmsのパスを確認してください

DDEVのDrupal CMSのインストール

久しぶりにDDEVを使いMacBookにDrupalをインストールしますので、DDEVの使い方を復習します。

DDEVの基本にプロジェクトはディレクトリ単位となっています。ディレクトリ内に.ddevを置いてプロジェクトを管理します。

# プロジェクトのディレクトリを作成し移動
% mkdir dcms-01 && cd dcms-01
--- 
# プロジェクトの設定をします。
% ddev config --project-type=drupal11 --php-version=8.3 --docroot=web
# プロジェクトはDrupal :Drupal11を使用 : --project-type=drupal11
# PHPのバージョンは8.3系 :  --php-version=8.3
# ドキュメントルートのパスをwebディレクトリとする :  --docroot=web
# 本来DBの指定などを行う必要がありますが、QuickInstallはこのあたりをデフォルトで行ってくれます。
--- 
# DDEVの起動
% ddev start
---
# Drupal CMSのインストール
% ddev composer create-project drupal/cms
# Composerを使いインストールをします。
---
# Drupalの起動と設定
% ddev launch
# Drupal CMSが立ち上がり、サイトのタイプを選択(Blogを選択)
メールアドレスとパスワードを入力するとDrupal CMSの管理画面にログインします。
---

インストール状況の確認

ddev describeで設定状況の確認が出来ます。ローカルなのでDBのパスワードがdb/db、root/rootとなっていますが、本番環境では推測されないUser/Passを設定ください。

web,db,mailpit(ローカルフォームメールのテストで重宝します)とコンテナになっています。Dockerのメリットにプロジェクト毎にWEBのPHPのバージョンを変えたり、DBのバージョンを変えることが出来ます。

# インストール状況の確認
% ddev describe
┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Project: dcms-01 ~/dcms-01 https://dcms-01.ddev.site                                                                    │
│ Docker platform: orbstack                                                                                               │
│ Router: traefik                                                                                                         │
├──────────────┬──────┬──────────────────────────────────────────────────────────────────────────────┬────────────────────┤
│ SERVICE      │ STAT │ URL/PORT                                                                     │ INFO               │
├──────────────┼──────┼──────────────────────────────────────────────────────────────────────────────┼────────────────────┤
│ web          │ OK   │ https://dcms-01.ddev.site                                                    │ drupal11 PHP 8.3   │
│              │      │ InDocker -> Host:                                                            │ Server: nginx-fpm  │
│              │      │  - web:80 -> 127.0.0.1:32788                                                 │ Docroot: 'web'     │
│              │      │  - web:443 -> 127.0.0.1:32789                                                │ Perf mode: mutagen │
│              │      │  - web:8025 -> 127.0.0.1:32790                                               │ Node.js: 22        │
├──────────────┼──────┼──────────────────────────────────────────────────────────────────────────────┼────────────────────┤
│ db           │ OK   │ InDocker -> Host:                                                            │ mariadb:10.11      │
│              │      │  - db:3306 -> 127.0.0.1:32791                                                │ User/Pass: 'db/db' │
│              │      │                                                                              │ or 'root/root'     │
├──────────────┼──────┼──────────────────────────────────────────────────────────────────────────────┼────────────────────┤
│ Mailpit      │      │ Mailpit: https://dcms-01.ddev.site:8026                                      │                    │
│              │      │ Launch: ddev mailpit                                                         │                    │
├──────────────┼──────┼──────────────────────────────────────────────────────────────────────────────┼────────────────────┤
│ Project URLs │      │ https://dcms-01.ddev.site, https://127.0.0.1:32789,                          │                    │
│              │      │ http://dcms-01.ddev.site, http://127.0.0.1:32788                             │                    │
└──────────────┴──────┴──────────────────────────────────────────────────────────────────────────────┴────────────────────┘

Drushで翻訳のインストール

言語設定 /admin/config/regional/language のデフォルトが英語になっていますので日本語を追加してデフォルトにします。ここで日本語を指定してもすぐに日本語が反映されず、管理画面が全て英語のままですので、Drushで一気に翻訳を進めて管理画面を日本語にしてしまいます。

# 翻訳の更新が必要なプロジェクトを表示
% ddev drush locale:check
--- 
# 翻訳ファイルをダウンロード＆インポート
% ddev drush locale:update
---
# キャッシュをクリア
% ddev drush cr 
--- 

エラーの考察

今回インストールしたDrupal CMSのDrupal Coreは最新のDrupal Core 11.2.2となっています。モジュールも最新版がインストールされていますが、一部開発用のモジュールがコアプログラムにインストールされ、エラーや警告が出ています。

この開発用モジュールが出す、エラーや警告はDrupal公式で認定されています。（エラーや警告は基本無視して大丈夫）私が前回ハマったautomatic_updates や package_manager のエラーや警告の解消の根本的な原因が実は、Drupal公式が認定していたエラーや警告で、そのエラーや警告を潰すために四苦八苦してしまったのが顛末だったと今回気がつきました。。。

Drupal CMSはDrupalの従来のイメージである、開発者が使用するCMSというイメージからWordPressのような一般ユーザーが気軽に利用出来るCMSとしての裾野を広げる為に進化しています。

インターフェースの洗練や、コマンドラインではなくGUIで全て完結出来るインターフェースや目的毎にパッケージ化されたディストリビューションなど、よりユーザーライクなCMSへと変貌を遂げています。

モジュールやテーマが、WordPressのように管理画面からワンクリックでダウンロードして自動インストールしたり、更新もcronで自動化するなど、ユーザーがシステムを意識せずサイトを構築し、運営できる機能を実装している途中なので、今回のようなエラーや警告を出してしまっています。

# エラー

Package Manager

Package Manager is available for early testing. To install the module set the value of 'testing_package_manager' to TRUE in your settings.php file.

# 警告

Experimental modules installed

実験用のジュールが見つかりました: Navigation, Package Manager。実験用のモジュールはテスト目的でのみ提供されています。自己責任で使用してください。

settings.phpのパーミッションの変更

Home > 管理 > レポート > サイトの状態 

保護が無効
ファイル sites/default/settings.php は変更に対して保護されていないため、セキュリティー上の危険性があります。 ファイルのパーミッションを書き込み禁止に変更してください。

ローカルでの使用なので、基本無視しても問題ありませんが、Drupalインストールのルーティンなので対応します。本番環境では必ず対応してください。

パーミッションの変更

iTermからコマンドを入れ、パーミッションを変更します。

DDEVの構成

DDEVはコンテナで動いています。以下が構成図になります。

|-ddev-dcms-01
|  |-db
|  |-web
|
|-ddev-router
|  |-ddev-router
|
|-ddev-ssh-agent
   |-ddev-ssh-agent

DDEVでコンテナにssh接続

DDEVのsshでコンテナに入りsettings.phpの権限を変更します。

# ddevのsshを使用しコンテナにログインします。
% ddev ssh
---
#ディレクトリ構成の確認
$ cd web/sites/default
$ ls -al
# settings.phpの権限は読み書きとなっています。
-rw--r--r---  1 s-takeda dialout 36727 Dec  7 18:37 settings.php
---
# 権限の変更をします。
$ chmod 444 settings.php
# 変更の確認をします。
$ ls -al
// 読み込みのみの444に変更されています。
-r--r--r--  1 s-takeda dialout 36727 Dec  7 18:37 settings.php
---
# キャッシュをクリアします。
$ drush cr
 [success] Cache rebuild complete.
 ---

# sshの終了
$ exit
---
# 参照 Macのターミナルで作業する際は、パスの関係でコマンドの入力前にddevを入れる必要がありますがコンテナ内ではddevを入れる必要がありません。
# Macのターミナル
% ddev drush cr
# Orbstackのコンテナ内
$ drush cr

仮)Dupalのセキュリティ管理

本来今回の記事でまとめようと考えていたDrupalのセキュリテイ管理についてまとめてみます。ただ、セキュリティに関連する記事となるためどこまでを記事としてまとめて良いのかが悩みどころです。