ローカル環境にDrupalをインストールしよう 〜Windows編〜

はじめに

この記事ではDrupalをローカル環境（お手元のPC）にインストールする手順をご紹介します。

ローカル環境は本番環境（＝WEBに公開されていて誰でもアクセスできる環境）と違い、動作検証や開発を自由に行える環境です。
そのため万が一トラブルが発生してもほかの方へ影響しないため、機能開発や検証の際には必ず利用されるものです。

なお今回はWindowsを使用している前提で手順をご紹介します。
Mac OSでの環境構築は以下の記事をご覧ください。

Drupalの動作要件

構成要素	要件
WEBサーバー	Apache 2.4.7以上 Nginx 1.1以上
データベース	MySQL 5.7.8以上 MariaDB 10.3.7以上 Percona Server 5.7.8 以上 PostgreSQL 12以上 SQLite 3.26以上
メモリ	最小1GB ※ライブラリを管理するためのComposerを使用するために必要です。
PHP	8.1以上 8.1.6を推奨 最小64MBのメモリが必要

ローカル環境の活用方法

本番環境に影響なく動作検証ができる

WEBサイトやシステムを運用していると、既存不具合の調査や新機能追加のための検証などが必要なケースがあります。

そこで本番環境をしてしまうと万が一操作ミスをしてしまった場合にシステムやサイトが停止してしまう恐れがあります。
そうなってしまうとサイトやシステムを使うエンドユーザーに悪影響を及ぼしてしまいます。

そのようなことを防ぐために本番環境に影響させず調査や検証をできるようにするための環境がローカル環境です。

基本無料で環境を使用できる

本番環境と同等の環境を用意するには、
システム構成にもよりますがサーバーやデータベースを再度調達するためには料金も必要になります。

今回ご紹介する手順を使えばクラウドサービスのサーバーやデータベースを調達することなく、
無料で環境を構築することができます。

そのためコストを抑えて検証や調査が可能になります。

ローカル環境へのDrupalインストール

今回はXAMPPと呼ばれるツールを使います。
XAMPPを使うことでWEBサーバーやデータベース、PHPなどミドルウェアを自分で調達することなくDrupal環境を構築できます。

XAMPPのインストール

以下のリンクからXAMPPをダウンロードします。

インストーラがダウンロード出来たらインストールを進めます。

Drupalソースコードのダウンロード

Drupal.orgよりDrupalのソースコードをダウンロードします。
以下のリンクにアクセスしてソースコードをダウンロードします。

ダウンロードが完了したらzipフォルダを展開します。

展開が完了したらdrupal-10.2.2フォルダにアクセスします。
すると同名のフォルダがありますが、こちらの配下にあるファイルがDrupalのコアファイルです。

XAMPPのドキュメントルートにアクセスしてDrupalのコアファイルを任意のフォルダに配置します。

XAMPPのドキュメントルートはインストール時の設定にもよりますが、
とくに変更していなければC:\xampp\htdocsです。

まずドキュメントルートにdrupal-10.2.2をコピーしてきます。

コピーしてきたフォルダの名前をmy-drupal-siteに変更します。

以上でソースコードの準備は完了です。

WEBサーバーを起動する

XAMPPのコントロールパネルからApacheを起動します。

データベースを起動する

Apacheと同様にMySQLも起動します。

Drupal用データベースを作成する

MySQLのAdminをクリックしてphpMyAdminを開きます。

データベースを作成する にmy-drupal-siteを入力し、文字コードはutf32_general_ciを選択します。
作成をクリックしてデータベースを作成します。

Drupalのインストール

ここからはブラウザからインストールを進めていきます。
ブラウザを開いてhttp://localhost/my-drupal-siteにアクセスします。

最初に言語を選択します。
日本語を選択してSave and continueをクリックします。

インストールプロフィールは標準を選択します。

データベースの構成で先ほど作成したデータベースの情報を入力します。
データベース名にmy-drupal-siteを、
ユーザー名にrootを入力して次へ進みます。

サイトの環境設定ではサイト名やサイト管理者のメールアドレスを設定します。
必須項目（赤い*のついている項目）を入力します。

ようこそと書かれたトップページが表示されればインストールは完了です！

エラーへの対応

インストールは完了しましたがエラーが表示されているため解消していきます。
ページ上部のメニューよりレポート > サイトの状態にアクセスします。

サイトの状態でエラーを確認します。

私の環境では以下のエラーが確認できました。

• 信頼の置けるホストの設定：settings.php の trusted_host_patterns が設定されていません。セキュリティ面で脆弱となる恐れがあるため、設定することを強くおすすめします。

ローカル環境なので重大なエラーではありませんが後学のために解消しておきます。

ホストの設定

localhostを信頼できるホストとして設定します。
sites/default/settings.phpを修正します。

settings.php

// 修正前
# $settings['trusted_host_patterns'] = [];

// 修正後
$settings['trusted_host_patterns'] = [
  '^localhost$',
];

サイトの状態を確認してエラーが消えていれば対応完了です。

さいごに

今回はローカル環境へのDrupalインストール方法についてご紹介しました。

これからDrupal導入や開発を検討しており、動作検証や機能確認をしたい方はぜひ今回の記事を参考に触ってみてください。

MacOSでの環境構築手順も知りたい方は以下の記事もご覧ください。