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

概要

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

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

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

前提条件

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

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

Craft CMSインストール手順

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

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

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

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

bash

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ディレクトリ内で以下のコマンドを実行してください。

bash

composer create-project craftcms/craft .

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

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

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

ServBayのデータベース管理ツール（phpMyAdmin）へアクセス
ブラウザでServBayのローカル開発パネルhttps://servbay.host/を開きます。パネル内で「phpMyAdmin」リンクをクリックし、phpMyAdminにアクセスします。
ヒント：ServBayのphpMyAdmin初期ユーザーは通常rootで、パスワードはServBay.devです。セキュリティのため、初回接続後はrootパスワードの変更や新しい管理ユーザーの作成をおすすめします。
データベースユーザーの作成
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つ登録します。

ServBayアプリを起動
ServBayアプリケーションを立ち上げます。
新しいサイトを追加
サイドメニューの「サイト」（旧バージョンでは“ホスト”）タブをクリックし、「+」ボタンまたは「サイト追加」ボタンで新規登録画面へ。
下記内容を編集します。
- 名前（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フォルダを指すこと！）
設定の保存
入力内容を確認・保存し、ServBayアプリがWebサーバー設定をリロードします。サイト一覧に新規サイト（例：servbay-craft.local）が追加されているはずです。

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

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

インストールページへアクセス
ブラウザでhttps://servbay-craft.local/にアクセス。Craft CMSは未インストール検出時、自動的にインストーラーページ（例：https://servbay-craft.local/index.php?p=admin/install）へリダイレクトします。
データベース情報の入力
インストーラーの「データベース設定」ステップで、ステップ3で作成した情報を入力：
- データベースサーバー： localhost
- データベース名： craft_user（作成したDB名）
- ユーザー名： craft_user（作成したDBユーザー名）
- パスワード： 上記DBユーザーのパスワード
「続行」をクリックして、Craft CMSがDB接続を行います。成功時は次のステップへ進みます。
管理者アカウントの作成
画面指示に従い、Craft CMSの管理者アカウントを設定します。ユーザー名・パスワード・メールアドレスを入力し、強力なパスワードを推奨。
「続行」をクリック。
サイト設定
サイト名など基本情報を入力。
「インストール完了（Finish Up）」ボタンをクリックします。データベーステーブルや設定ファイルの自動生成が実施されます。
完了後、管理画面のログインページにリダイレクトされます。

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

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

.envファイル確認： Craft CMSは.envで環境変数（DB情報など）を管理します。インストール時に自動生成されており、プロジェクトルート（servbay-craft-app/）にあります。例えばCRAFT_ENVIRONMENTをdevに変更可能です。
プラグイン導入： 管理画面の「プラグイン」から拡張機能を簡単にインストール・管理できます。
コンテンツ構造の設計： 「設定」でフィールド、セクション、カテゴリー、タグ等、サイト独自のデータ構造を設定します。
メール設定： ローカルでのメール送信テストには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サイトやアプリ制作を始めましょう！

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

概要 ​

前提条件 ​

Craft CMSインストール手順 ​

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

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

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

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

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

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

よくある質問（FAQ） ​

まとめ ​