ServBay環境でのCraft CMSインストールと設定

概要

Craft CMSは、柔軟なコンテンツモデリング、直感的なユーザーインターフェース、開発者フレンドリーな機能で人気の高いパワフルなコンテンツ管理システム（CMS）です。複雑かつカスタマイズ性の高いWebサイト構築に最適です。

ServBayをCraft CMS用のローカル開発環境として利用すると、事前設定済みのPHP、データベース（MySQLやPostgreSQL等）、Webサーバー（CaddyまたはNginx）、さらにComposerやコマンドラインツールも搭載されており、インストールとセットアップ作業が大幅に簡易化されます。

このガイドでは、ServBay環境でCraft CMSプロジェクトをインストール・設定する手順を詳しく解説します。

前提条件

はじめる前に、以下の条件を満たしていることを確認してください。

1. ServBayのインストールと起動： macOSにServBayが正常にインストールされており、必要なPHPバージョン（Craft CMSの推奨バージョンについてはCraft CMS公式ドキュメントを参照）やデータベース（通常はMySQLまたはPostgreSQL）が有効になっているか確認してください。ServBayは複数のPHPバージョンやデータベースに対応しており、要件に合わせて切り替え・構成が可能です。
2. コマンドラインの基本操作に慣れていること： ディレクトリ作成やComposer実行など、いくつかのコマンドをターミナルで操作する必要があります。
3. Composerの理解： Craft CMSは依存関係管理にComposerを使用します。ServBayにはComposerがプリインストールされていますが、composer create-projectコマンドの実行方法を把握しておきましょう。

Craft CMSインストール手順

以下はServBay環境でCraft CMSをセットアップする具体的な手順です。

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

まず、ServBayの標準Webルート /Applications/ServBay/www 内に新しいプロジェクトフォルダを作成します。ServBayではこのディレクトリがWebサーバーのサービスディレクトリとして自動設定されているため、アクセスが簡単です。

ターミナルで以下のコマンドを実行してください。

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

この操作で/Applications/ServBay/wwwディレクトリ下にservbay-craft-appという新しいフォルダができ、そこへ移動します。

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

ServBayにはComposerが組み込まれているため、プロジェクトディレクトリ内で直接Composerを使ってCraft CMSを作成できます。公式でもComposerによるインストールが推奨されています。

servbay-craft-appディレクトリ内で以下のコマンドを実行してください。

composer create-project craftcms/craft .

このコマンドは、Craft CMSの最新版とすべての依存パッケージをカレントディレクトリ（.）へダウンロードします。Composerのプロセスが完了するまでお待ちください。

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

Craft CMSは、コンテンツや設定情報の保存にデータベースが必要です。ServBay同梱のphpMyAdminまたはAdminerツールを使用してデータベースおよびユーザーを作成します。ここではphpMyAdminを例に説明します。

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

   ブラウザでServBayのローカル開発パネルhttps://servbay.host/を開きます。パネル内で「phpMyAdmin」リンクをクリックし、phpMyAdminにアクセスします。

   ヒント：ServBayのphpMyAdmin初期ユーザーは通常rootで、パスワードはServBay.devです。セキュリティのため、初回接続後はrootパスワードの変更や新しい管理ユーザーの作成をおすすめします。

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

   Craft CMSへの接続にrootを使うことも可能ですが、安全性と権限管理の観点から個別のアプリケーションごとにユーザーを作成するのがベストプラクティスです。

   1. ユーザーアカウント画面へ

      phpMyAdminトップ画面の上部メニューにある「ユーザーアカウント」をクリックします。

   2. 新しいユーザーアカウントの追加

      「ユーザーアカウントを追加」をクリックし、下記情報を入力します。

      • ユーザー名： 例：craft_user（Craft CMS用のユーザー名）
      • ホスト名： localhost または「ローカル」
      • パスワード： 安全なパスワードを指定してください。例示のpassword123などは本番利用禁止です。ローカル開発環境では簡易パスワードでも可ですが、セキュリティ意識は保ちましょう。
      • 再入力： 確認のため同じパスワードを入力
      • 「データベースをユーザーと同じ名前で作成し、すべての特権を与える」を選択。これにより、craft_userという名前のDBが自動生成され、同名ユーザーに全権限が付与されます。
      • 「全ての特権を与える」にチェック
      • ページ下部の「実行」をクリック

   これで、craft_userという名のDBユーザー＆DB（craft_user）が全権限付きで作成されました。

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

ServBayのWebサーバー（Caddy/Nginx）にCraft CMSプロジェクトをサービスさせるため、“サイト”を1つ登録します。

1. ServBayアプリを起動

   ServBayアプリケーションを立ち上げます。

2. 新しいサイトを追加

   サイドメニューの「サイト」（旧バージョンでは“ホスト”）タブをクリックし、「+」ボタンまたは「サイト追加」ボタンで新規登録画面へ。

   下記内容を編集します。

   • 名前（Name）： 例：My Craft Siteなど分かりやすいサイト名
   • ドメイン（Domains）： servbay-craft.localなどローカルアクセス用ドメイン（ServBayが自動でDNS設定）
   • サイト種別（Type）： PHPを選択
   • PHPバージョン： Craft CMS互換（前提条件準拠）のバージョンを選択可（ServBayは複数バージョン共存可能）
   • Webサイトルート： 最重要ポイントです。Craft CMSの公開用ファイル（index.php等）はプロジェクト内webサブディレクトリに置かれています。Webサーバーのルートは必ずここを指定しましょう。 /Applications/ServBay/www/servbay-craft-app/web （ステップ1で作成したプロジェクト配下のwebフォルダを指すこと！）

3. 設定の保存

   入力内容を確認・保存し、ServBayアプリがWebサーバー設定をリロードします。サイト一覧に新規サイト（例：servbay-craft.local）が追加されているはずです。

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

セットアップしたローカルドメインでブラウザからCraft CMSのWebインストーラーを起動します。

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

   ブラウザでhttps://servbay-craft.local/にアクセス。Craft CMSは未インストール検出時、自動的にインストーラーページ（例：https://servbay-craft.local/index.php?p=admin/install）へリダイレクトします。

2. データベース情報の入力

   インストーラーの「データベース設定」ステップで、ステップ3で作成した情報を入力：

   • データベースサーバー： localhost
   • データベース名： craft_user（作成したDB名）
   • ユーザー名： craft_user（作成したDBユーザー名）
   • パスワード： 上記DBユーザーのパスワード

   「続行」をクリックして、Craft CMSがDB接続を行います。成功時は次のステップへ進みます。

3. 管理者アカウントの作成

   画面指示に従い、Craft CMSの管理者アカウントを設定します。ユーザー名・パスワード・メールアドレスを入力し、強力なパスワードを推奨。

   「続行」をクリック。

4. サイト設定

   サイト名など基本情報を入力。

   「インストール完了（Finish Up）」ボタンをクリックします。データベーステーブルや設定ファイルの自動生成が実施されます。

   完了後、管理画面のログインページにリダイレクトされます。

ステップ6：初期設定と基本的な操作

Craft CMSの管理画面へログイン後、以下の初期設定や操作を行うとよいでしょう。

1. .envファイル確認： Craft CMSは.envで環境変数（DB情報など）を管理します。インストール時に自動生成されており、プロジェクトルート（servbay-craft-app/）にあります。例えばCRAFT_ENVIRONMENTをdevに変更可能です。
2. プラグイン導入： 管理画面の「プラグイン」から拡張機能を簡単にインストール・管理できます。
3. コンテンツ構造の設計： 「設定」でフィールド、セクション、カテゴリー、タグ等、サイト独自のデータ構造を設定します。
4. メール設定： ローカルでのメール送信テストにはServBay付属のMailpitまたはMailhog利用がおすすめです。.envまたは管理画面のメール設定で「SMTP」を選び、サーバーはlocalhost、ポートはMailpit/MailhogのSMTPポート（ServBayパネルで確認可能）を指定してください。

よくある質問（FAQ）

• Q：インストール中にDB接続エラーが出る場合は？
  • A： Craft CMSインストーラーで入力したDBサーバーアドレス（localhost）、DB名、ユーザー名、パスワードがphpMyAdmin作成時と一致しているか確認してください。また、ServBayのデータベース（MySQLやPostgreSQL）が起動中かも確認しましょう。
• Q：servbay-craft.localアクセス時に404や空白ページが表示される場合は？
  • A：
    • ServBayのサイト追加時、「Webサイトルート」が正しく /Applications/ServBay/www/servbay-craft-app/web を指しているか確認。ここが最も多い間違いポイントです。
    • CaddyやNginx、PHPサービスがServBayで有効になっているか確認。
    • サイト一覧のservbay-craft.local構成が有効化されているかもチェック。
• Q：ComposerでのCraft CMSインストールが非常に遅い、または失敗する？
  • A： ネットワーク環境やComposerのミラー設定が原因かもしれません。必要に応じてComposerミラーソースを国内ミラー（アリババクラウドやPackagist Chinaなど）に切り替えてみてください。
• Q：インストール完了後、管理画面やフロントページでスタイルや画像が表示されない？
  • A： ファイル権限設定の不備が主な原因です。storageやweb/cpresourcesなどのディレクトリにServBay実行ユーザーが書き込み可能かを確認しましょう。多くの場合ServBayが自動対応しますが、問題があれば権限をリセットしてみてください。

まとめ

上記の手順をすべて完了すれば、ServBayローカル開発環境でCraft CMSが正常にインストール・構成されているはずです。ServBayの統合環境によって、PHPバージョン管理、DB設定、Webサーバー構築が容易になり、Craft CMS本体の開発に専念できます。早速Craft CMSが持つ強力なコンテンツモデリング機能を活用し、自分だけのWebサイトやアプリ制作を始めましょう！