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

Contao は、オープンソースの強力なコンテンツ管理システム（CMS）で、中小企業のサイトやポータル、複雑な Web アプリケーションの構築に最適です。本ガイドでは、macOS 向けの便利なローカル Web 開発環境「ServBay」で Contao をインストールし、設定する手順をわかりやすくご紹介します。これにより、すぐに Contao プロジェクトの開発を始めることができます。

ServBay は、PHP・Composer・データベースサービス（MySQL/MariaDB、PostgreSQL）・Web サーバー（Caddy、Nginx、Apache）を統合し、ローカル開発環境の構築を大幅に簡素化するオールインワンの環境です。ServBay を利用することで、Contao の動作に必要な依存関係を簡単に満たせます。

Contao とは？

Contao は、PHP ベースのオープンソース CMS で、直感的な操作性・高度な柔軟性・強力な管理画面で知られています。細かな権限管理、バージョン管理、多言語対応、レスポンシブ画像処理、拡張性の高いモジュール構造など機能が豊富で、プラグインによる機能拡張も容易に行えます。Contao の設計思想は「開発者やデザイナーがゼロから構築せずとも、柔軟にカスタマイズできる堅実な基盤を提供すること」です。

前提条件

Contao のインストールを始める前に、次の条件を満たしていることをご確認ください。

1. ServBay をインストールして起動していること: macOS に ServBay をインストール済みで、アプリが起動中であること。Contao のシステム要件を満たす PHP バージョンと、必要なデータベースサービス（MySQL または MariaDB など）が ServBay で有効になっているか確認してください（最新の要件については Contao 公式ドキュメント を参照）。
2. Composer: ServBay には Composer が標準で組み込まれています。別途インストールは不要です。
3. ターミナル操作: Composer コマンドを実行するためにターミナルが使える必要があります。

Contao インストール手順

以下では、ServBay 環境下で Contao をインストール・設定する流れを詳しく解説します。

手順 1：プロジェクトディレクトリの作成

まず、ServBay のデフォルトのサイトルートディレクトリ /Applications/ServBay/www に移動し、Contao プロジェクト用の新しいサブディレクトリを作成します。

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

ここから servbay-contao-app ディレクトリ内に Contao をインストールします。

手順 2：Composer で Contao プロジェクトを作成

Contao の推奨インストール方法は Composer の利用です。ServBay には Composer が組み込まれているため、以下のコマンドをプロジェクトディレクトリ内で実行してください。

composer create-project contao/managed-edition .

このコマンドで Contao Managed Edition の最新版と全ての依存パッケージがカレントディレクトリ（.）にインストールされます。ネットワーク環境によっては多少時間がかかります。

Contao Managed Edition について:
contao/managed-edition は、Contao の公式パッケージで、Contao コアと推奨依存モジュールを含み、標準的なプロジェクト構成がセットされています。なお、このエディションでインストールすると、Web サイトのルートディレクトリはプロジェクト配下の web フォルダになります。

手順 3：データベースとユーザーの作成

Contao はコンテンツや設定の保存にデータベースを利用します。ServBay には phpMyAdmin や Adminer など、便利なデータベース管理ツールが搭載されています。ここでは phpMyAdmin を例に手順を説明します。

1. ServBay の phpMyAdmin を開く

   ServBay のローカル管理画面 https://servbay.host/ へアクセスします。ページ内のリンクから phpMyAdmin にジャンプできます。

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

   Contao 用に専用のデータベースユーザー作成を推奨します。

   a. ユーザーアカウント画面に移動

   phpMyAdmin のトップページで、上部メニューから「ユーザーアカウント」をクリック。
   

   b. 新しいユーザーを追加

   「ユーザーアカウントを追加」を選択し、次の項目を入力：
   
   *   **ユーザー名:** Contao 用 DB 接続ユーザー名（例：`contao_user`）
   *   **ホスト名:** `localhost` を選択。これによりローカルからのみ接続可能となり、セキュリティが向上します。
   *   **パスワード:** **強力なパスワード**を設定してください。（例示の `password123` のような簡単なものは避け、実際にはパスワード生成ツール等で複雑なものを設定してください）
   *   **再入力:** パスワードを再度入力。
   
   「ユーザーにデータベースを作成する」項目では通常「ユーザー名と同じ名前のデータベースを作成し、すべての権限を与える」オプションが選べます。これで `contao_user` という名前のデータベースが自動で作成され、新しいユーザーに全権限が付与されます。
   
   *   忘れず「すべての権限を与える」にチェックを入れてください。
   *   一番下の「実行」ボタンでユーザーとデータベースの作成を完了します。
   

手順 4：ServBay でサイトを設定

次に、先ほど作成した Contao プロジェクトディレクトリを指すように ServBay で新しいサイト構成を作成しましょう。

1. ServBay で新サイトを追加

   ServBay アプリを立ち上げ、左のナビゲーションから「サイト」タブをクリック。右下の「追加」ボタンで新しいサイト設定画面を開きます。

2. サイト情報の入力

   • 名前: サイト名を分かりやすく設定（例：My Contao Site）
   • ドメイン: ローカル開発向けに .local や .servbay.demo など推奨（例：servbay-contao.local）。ServBay が自動でローカルに名前解決します。
   • サイトタイプ: PHP を選択。
   • PHP バージョン: Contao の要件を満たすバージョンを設定。（公式ドキュメント参照のうえ適切なものを選んでください）
   • サイトルートディレクトリ: ここは重要です！
     Composer の contao/managed-edition で構築した場合、公開ディレクトリは web サブディレクトリ (index.php などが配置) となるため、/Applications/ServBay/www/servbay-contao-app/web まで正確に指定してください。

3. 設定の保存

   入力が完了したら、画面下の「保存」ボタンでサイト構成を登録します。ServBay が自動で反映処理を行います。

手順 5：Contao ウェブインストーラーの実行

設定が完了したら、ブラウザから設定済みのドメインを使って Contao の Web インストーラーを実行しましょう。

1. インストール画面へアクセス

   Web ブラウザを開き、設定したドメインの末尾に /contao/install をつけてアクセスします。例：https://servbay-contao.local/contao/install

   正しく設定されていれば、Contao のインストール画面が表示されます。

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

   インストーラーが DB 接続情報の入力を求めてきます。手順 3 で作成した DB・ユーザー情報を入力してください。

   • データベースホスト名: localhost
   • データベース名: contao_user（DB 名がユーザー名と同じ場合）
   • ユーザー名: contao_user
   • パスワード: 手順 3 で指定したパスワード

3. 管理者情報の入力

   画面の指示に沿って、管理用ユーザー名・パスワード・メールアドレス等を入力。セキュリティのため、必ず強力なパスワードを設定してください。

4. インストール完了まで進める

   以降は画面の案内に従い、DB テーブル等のセットアップを進めます。最後に「インストール」や「完了」ボタンをクリックしてインストールを終了します。

手順 6：動作確認と管理画面へのログイン

インストール終了後、Contao が正しく動作しているか確認し、管理画面にもログインしてみましょう。

1. サイトのフロントページへアクセス

   設定したドメイン（例：https://servbay-contao.local/）をブラウザで開きます。Contao のウェルカムページや空のページが表示されれば、Web サーバー設定やフロントエンドの表示は成功です。

2. Contao 管理画面へログイン

   Contao 管理画面は通常 https://servbay-contao.local/contao です。

   手順 5 で設定した管理者情報でログインしてください。正しくログインできれば、Contao の管理インターフェースに入り、コンテンツ作成・拡張機能の導入・Web サイト設定が行えます。

よくある質問（FAQ）

Q：https://servbay-contao.local/ や https://servbay-contao.local/contao/install でエラーになる場合は？

A：

• ServBay の稼働状態を確認: ServBay アプリが起動中で、PHP および Web サーバー（Caddy もしくは Nginx）が動作中か確認してください。
• ServBay サイト設定を再確認: サイト設定のドメイン・サイトタイプ・PHP バージョン・サイトルートディレクトリ（特に web ディレクトリ指定）を再度チェックしましょう。
• ドメイン解決の確認: ServBay は .local ドメインのローカル解決を自動処理します。他のドメインや問題がある場合は ServBay の再起動や、（通常 ServBay により自動管理される）システム hosts ファイルのチェックをお試しください。
• Web サーバーログを確認: ServBay の Web サーバーログ（Caddy・Nginx）に詳細なエラー記録が残っている場合があります。

Q：データベース接続に失敗する場合は？

A：

• DB サービスの稼働確認: ServBay の MySQL/MariaDB あるいは PostgreSQL サービスが動作中であるか確認。
• DB 情報を再チェック: Contao インストーラーの入力情報（ホスト名・データベース名・ユーザー名・パスワード）が phpMyAdmin で設定したものと一致しているか見直してください。
• ユーザー権限の確認: 作成したデータベースユーザーが Contao の DB に十分な権限を持っているかを確認しましょう。

Q：インストール時に権限エラーが発生した場合は？

A：
Contao インストーラーは特定のディレクトリに書き込み権限が必要です。ServBay の初期設定で通常は十分ですが、問題が出た場合はターミナルからプロジェクトディレクトリのパーミッションを適切に調整できます。

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # your_username をご自身の macOS ユーザー名に置き換えてください
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao の動作に書き込みが必要なディレクトリ

chmod 777 の使用は本番運用環境では推奨されませんが、ローカル開発環境に限定して一時的にパーミッション問題を解決するための一般的手段です。

まとめ

本ガイドに従って、ServBay ローカル開発環境に Contao CMS を無事インストール・設定できたはずです。ServBay の統合環境により、Composer 依存解決・DB 準備・Web サーバー設定といった煩雑な作業が大幅に容易になり、Contao 開発の本質に集中できます。

これから Contao 管理画面でコンテンツ制作やページデザイン、拡張機能やテーマの導入・サイト構築にぜひ取り組んでみてください。

さらに Contao の機能や使い方について詳しく知りたい場合は、Contao 公式ドキュメント を参照してください。