ServBayローカル開発環境でのDrupalのインストールと設定

概要

Drupalは、強力で柔軟かつ拡張性に富んだオープンソースのコンテンツ管理システム（CMS）です。個人ブログや小規模サイトから大規模企業のポータルサイト、複雑なWebアプリケーションまで、あらゆるタイプのサイト制作で幅広く利用されています。豊富なコンテンツ管理ツール、細かなユーザー権限管理、そして強力なモジュール型アーキテクチャを備え、高いカスタマイズ性やパフォーマンスを求める開発者にも最適です。

ServBayはmacOS専用に開発されたローカルWeb開発環境ツールで、主要なWebサーバー（CaddyやNginx）、さまざまなプログラミング言語ランタイム（PHP、Node.js、Python、Go、Javaなど）、データベース（MySQL、PostgreSQL、MongoDB、Redis）、そしてComposerやnpmなどの開発ツールを統合しています。ServBay上でDrupalをインストール・設定すれば、堅牢で便利、多機能なローカル開発プラットフォームを手に入れることができます。

本記事では、ServBay環境でのDrupalのインストールと設定方法を詳しく解説し、ローカルでのDrupal開発環境構築をすばやく行えるようサポートします。

前提条件

Drupalのインストールを始める前に、以下の条件を満たしているかご確認ください。

1. ServBayがインストールされて動作していること：macOSにServBayが正しくインストールされ、正常に動作している状態である必要があります。
2. ServBayの基本操作ができること：ServBayのUIでパッケージ管理、サイト追加、内蔵ツール（phpMyAdminなど）へのアクセスができることを把握していること。
3. PHPおよびMySQL/MariaDBがインストール済みで稼働していること：ServBayにはデフォルトで複数バージョンのPHPやMySQL/MariaDBが含まれています。使用予定のPHPバージョンが有効になっていて、データベースサービスも開始していることを確認してください。
4. Composerがインストールされていること：ComposerはPHPプロジェクト依存管理の必須ツールで、ServBayには標準で組み込まれています。このガイドもComposerでDrupalプロジェクトを作成します。

Drupalのインストール手順

ServBay環境下でDrupalをインストール・設定する手順を順を追ってご説明します。

ステップ1：プロジェクトディレクトリの作成

まず、Drupalプロジェクト専用のディレクトリをServBayのウェブサイトルート /Applications/ServBay/www 配下に作成します。

ターミナルアプリを開き、以下のコマンドを実行してください。

cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app

これで /Applications/ServBay/www ディレクトリに servbay-drupal-app という新フォルダが作成され、その中に移動します。

ステップ2：ComposerでDrupalプロジェクトを作成

ServBayにはComposerが組み込まれているので、追加インストールは不要です。Drupal公式もComposerによるプロジェクト作成・依存管理を推奨しています。

先ほど作成した servbay-drupal-app ディレクトリで、次のComposerコマンドを実行してください。

composer create-project drupal/recommended-project .

このコマンドは drupal/recommended-project テンプレートを使って、カレントディレクトリ（.）に新しいDrupalプロジェクトを作成します。ComposerがDrupalコアや必要な依存ファイルを自動ダウンロードします。ネットワーク速度によって多少時間がかかる場合があります。

drupal/recommended-project のテンプレートでは、公開用ファイル（index.phpやCSS、JavaScriptなど）を web というサブディレクトリにまとめるのが標準構成です。これは最新のDrupalプロジェクトの推奨構成であり、セキュリティ向上にも役立ちます。

ステップ3：データベースとユーザーの作成

Drupalはサイトデータ、設定、ユーザー情報などを保存するためにデータベースが必要です。ServBay付属のphpMyAdminを使ってデータベースとユーザーを作成します。

1. ServBayのphpMyAdmin（データベース管理ツール）にアクセス

   WebブラウザでServBayのダッシュボードURL：https://servbay.host/ にアクセス。ダッシュボード内で「phpMyAdmin」リンク（通常「ツール」または「データベース」セクションにあります）をクリックし、phpMyAdmin画面に進みます。

   servbay.host はServBay内部管理UIに割り当てられた特別なローカルドメインです。

2. データベースユーザーの作成

   セキュリティと権限管理のため、Drupal用に専用のデータベースユーザーを作成してください。

   • ユーザーアカウントページへ：phpMyAdminのトップメニューの「ユーザーアカウント」をクリックします。
   • 新しいユーザーアカウントの追加：「ユーザーアカウントの追加」をクリック。
   • ユーザー情報の入力:
     • ユーザー名：好きなユーザー名（例：drupal_user）を入力。
     • ホスト名：localhostを指定または入力。これは、そのユーザーがローカルからのみDBに接続可能となり、安全性が高まります。
     • パスワード：強力なパスワードを入力してください。例での password123 はデモ用なので、実際は推測困難なパスワードを必ず設定しましょう。
     • 再入力：同じパスワードを再度入力します。
   • DB権限設定：「データベースをユーザー名と同名で作成し、すべての権限を与える」のチェックを入れます。これにより、ユーザー名（drupal_user）と同じ名前のDBが生成され、全権限がこのユーザーに自動付与されます。
   • グローバル権限：全権限を付与するチェックは外しておきます（不要です）。ユーザーには自分のDBに対してのみ権限があれば充分です。
   • 実行：情報に誤りがないか確認し、右下の「実行」ボタンをクリックしましょう。

   以上で、drupal_user という名前のデータベースと、そのみに全権限を持つ同名のDBユーザーが作成されました。

ステップ4：Webサーバーの設定（ServBayでサイト追加）

次に、ServBayでWebサイト設定を追加し、作成したDrupalプロジェクトの web ディレクトリにローカルドメインを割り当てます。

1. ServBay UIの起動：ServBayのアプリを開きます。
2. 新しいウェブサイト追加：左側のナビゲーションパネルから「サイト」を選択。
3. 追加ボタンをクリック：サイト一覧下部の「+」ボタンなどから新しいサイト設定を作成します。
4. ウェブサイト情報の入力：
   • 名前：分かりやすい名前（例：My Drupal Site）。
   • ドメイン：ローカルで利用するドメイン名（例：servbay-drupal.local）。.local ドメインはServBayで自動認識され、hostsファイル編集などは不要です。
   • サイト種別：PHP を選択。
   • PHPバージョン：目的のDrupalバージョンにあったPHPバージョンをセレクト。公式で動作要件を確認のこと。
   • サイトルートディレクトリ：Drupalのエントリーファイル（index.php）があるディレクトリです。Composerでプロジェクトを作成した場合は web ディレクトリとなるので、 /Applications/ServBay/www/servbay-drupal-app/web を指定してください。
5. 設定の保存：すべて入力できたら、「保存」ボタンを押して設定を反映します。ServBayがWebサーバー構成を自動アップデートして反映されます。

ステップ5：Drupalインストーラーの実行

これで、ブラウザから割り当てたローカルドメインにアクセスし、DrupalのWebインストールを開始できます。

1. インストールページへのアクセス

   ブラウザで以下のURLにアクセスします（Step 4で指定したドメイン＋ /core/install.php）： https://servbay-drupal.local/core/install.php

   Drupalのインストールウィザード画面が表示されるはずです。

2. 言語の選択

   デフォルト言語を選択し、「保存して次へ」をクリックします。

3. インストール構成タイプの選択

   一般的には「標準」を選択し、基本機能を持ったサイト構成が入ります。「保存して次へ」をクリック。

4. データベース情報の設定

   データベース接続情報を入力します。Step 3で作成した内容を使用します。

   • データベース種別：MySQL, MariaDB, Percona Server, or equivalent を選択
   • DB名：drupal_user（作成したDB名）
   • DBユーザー名：drupal_user（作成したユーザー名）
   • DBパスワード：Step 3で設定したパスワード
   • DBホスト名：localhost
   • 上級オプション：特殊な場合以外は変更不要です

   入力後、「保存して次へ」をクリック。DrupalがDBに接続し、初期データのインポートを開始します。

5. サイト情報の入力

   DB接続が成功したら、サイト設定画面となるので下記項目を入力します。

   • サイト名：ウェブサイトのタイトル
   • サイトEメールアドレス：通知などに使用されるメールアドレス
   • 管理者ユーザー名：管理画面にログインする際のユーザー名
   • 管理者パスワード：管理者アカウント用の安全なパスワード
   • 国/地域：該当地域を選択
   • タイムゾーン：任意のタイムゾーンを指定

   入力したら「保存して次へ」。Drupalが構成ファイル生成やサイトの初期設定を行います。

6. インストール完了

   インストールが完了すると、新たなDrupalサイトのトップページへリダイレクトされます。これでServBay環境下でのDrupalインストールが無事完了しました。

ステップ6：モジュールやテーマのインストール（概要）

Drupalの大きな強みは、その充実したモジュール・テーマエコシステムにあります。インストール後は、目的に合わせて機能追加・サイトカスタマイズが可能です。

1. Drupal管理画面へのログイン：https://servbay-drupal.local/user または https://servbay-drupal.local/admin にアクセスし、Step 5で作成した管理者アカウントでログイン。
2. モジュールの追加：「管理」メニューの「拡張（Extend）」から、新規モジュールを検索・インストール可能です。適宜機能拡張しましょう。
3. テーマの追加：「外観（Appearance）」セクションで、新しいテーマの追加・有効化や外観設定が行えます。

インストール後の初期設定および利用

Drupalの導入が完了したら、早速サイト構築を始めましょう。以下は基本的な操作例です。

コンテンツタイプとコンテンツの作成

Drupalの要は「コンテンツタイプ」です。これは、記事やページなどの構造（カラムやフィールド）を定義するものです。

1. コンテンツタイプの作成：管理画面の「構造」>「コンテンツタイプ」へ。既存タイプの編集または「コンテンツタイプを追加」で新規作成＆フィールド定義（タイトル、本文、画像など）。
2. コンテンツの作成：「コンテンツ」>「コンテンツを追加」で好きなコンテンツタイプを選び、各種フィールドにデータを入力、「保存して公開」をクリック。

ナビゲーションメニューの設定

メニュー機能では、サイト内のナビリンクを整理・管理できます。

1. メニュー作成：管理画面の「構造」>「メニュー」で、新規メニュー作成や既存メニューの管理。
2. メニュー項目の追加：任意メニューの編集内で「リンク追加」を選択。テキスト・ターゲットパス（内部例：/node/1や外部URL）を設定し保存。

ブロックレイアウトのカスタマイズ

「ブロック」はサイドバーやフッターなど、指定領域に配置できるパーツです。

1. ブロックの追加：管理画面「構造」>「ブロックレイアウト」。現在のテーマに割り当て可能な領域が一覧表示されています。ナビゲーションやカスタム内容ブロックを好きな位置へドラッグ配置できます。
2. ブロックの設定：エリア配置済みブロック横の「設定」ボタンから、タイトルや表示ページ、ロールごとの表示／非表示などを細かく管理できます。

注意点・よくある質問（FAQ）

• PHP設定を変更したい場合は？ Drupalが特定のPHP拡張や高度なメモリ制限（memory_limit）を必要とする場合は、ServBay UI の「パッケージ」セクションから該当PHPバージョンの設定ボタンを押し、php.ini ファイルの編集が可能です。変更後はPHPサービスを再起動してください（ServBayがプロンプト表示や自動再起動処理も可能）。
• サイトにアクセスできない場合
  • ServBayアプリが起動し稼働しているか確認
  • サイト設定（特にドメインやウェブルートディレクトリ）が正しいか再確認。必ず .../servbay-drupal-app/web をルートに指定。
  • Webサーバー（CaddyまたはNginx）が問題なく動作しているか
  • アクセスURLが正しいか確認（例：初期インストール時は https://servbay-drupal.local/core/install.php）
• データベース接続エラーの場合
  • インストーラー入力のDB名・ユーザー名・パスワード情報がphpMyAdminで作成したものと一致しているか
  • DBホストは必ずlocalhostと記載
  • ServBay内でMySQL/MariaDBサービスが稼働しているか
• Composer依存インストールエラー発生時は？ ネットワーク接続をまずチェックし（packagist.org へのアクセス必須）、必要に応じてComposerキャッシュのクリアやComposer自体のアップデート（ServBayでは定期的な内蔵バージョン更新もあり）が有効です。
• ファイル権限の問題 Drupal運用では一部ディレクトリ（例：web/sites/default/files と web/sites/default/settings.php）の書き込み権限が必須です。ServBayは通常macOSユーザー権限で動作するため問題が生じにくいですが、万一トラブル時は該当ディレクトリの権限を見直してください。

まとめ

このガイドに従い、ServBayローカル開発環境でのDrupalインストールと初期設定が完了しました。ServBayはDrupal開発に必要なあらゆるコンポーネントを統合し、高速かつ柔軟な開発テスト環境を実現します。あとはDrupalならではの豊富な機能や拡張性を活用して、あなたの理想のウェブサイト構築をスタートしてください。プロジェクト要件やフェーズに応じて、ServBayのマルチPHPバージョン、各種DBやサービスも自在に管理・切替可能です。ローカル開発・テスト・デバッグが効率的に進められるはずです。