pH7BuilderをLinuxサーバーへインストールした後、Apacheでアクセスしてもトップ画面が表示されない場合、原因はApacheの公開ディレクトリ設定、PHP設定、ファイル権限、URLリライト設定など複数考えられます。この記事では、pH7Builderを正常に表示するために確認すべきApache設定と、初期セットアップ時によく発生する問題の解決方法を解説します。
pH7Builderのトップ画面が表示されない主な原因
pH7BuilderはPHPで動作するWebアプリケーションのため、単純にファイルを配置しただけではApacheから正しく表示されない場合があります。
特にインストール直後に発生しやすい原因は以下の通りです。
- ApacheのDocumentRootがpH7Builderの公開フォルダを向いていない
- PHPの必要な拡張機能が不足している
- .htaccessが無効になっている
- Apacheのmod_rewriteが有効になっていない
- ファイル所有者や権限設定が適切ではない
- Composer依存パッケージのインストールが完了していない
まずはブラウザで表示されるエラー内容を確認してください。404、500エラー、真っ白な画面など、症状によって確認する場所が変わります。
ApacheのDocumentRoot設定を確認する
pH7Builderを/var/www/html/pH7Builderへ配置した場合、Apacheがどのディレクトリを公開しているか確認する必要があります。
例えばApacheの設定が以下のようになっている場合、アクセス先は異なります。
| 設定 | アクセスURL例 |
|---|---|
| DocumentRoot /var/www/html | http://サーバーIP/pH7Builder |
| DocumentRoot /var/www/html/pH7Builder | http://サーバーIP/ |
Apache設定ファイルは環境によって異なりますが、Ubuntuの場合は以下の場所を確認します。
/etc/apache2/sites-available/000-default.conf
pH7Builderをトップページとして表示したい場合は、DocumentRootをpH7Builderのディレクトリへ変更する方法があります。
Apacheのmod_rewriteを有効化する
pH7BuilderのようなPHPフレームワーク系アプリケーションでは、URLルーティングにApacheのrewrite機能を利用することがあります。
Ubuntuの場合は以下のコマンドでmod_rewriteを有効化します。
a2enmod rewrite
有効化後はApacheを再起動します。
systemctl restart apache2
また、Apache設定でAllowOverrideがNoneになっている場合、.htaccessが読み込まれません。
例として以下のような設定が必要になる場合があります。
<Directory /var/www/html/pH7Builder>
AllowOverride All
Require all granted
</Directory>
pH7BuilderのComposer依存ファイルを確認する
質問内容ではComposerをインストールされていますが、pH7Builder本体の依存ライブラリを取得する処理も必要です。
pH7Builderのディレクトリで以下を実行して確認します。
cd /var/www/html/pH7Builder
composer install
vendorディレクトリが存在しない場合、PHPライブラリが不足して正常起動できない可能性があります。
また、Composer実行時にエラーが出ている場合は、PHPバージョンや必要拡張が対応しているか確認してください。
PHPのバージョンと必要拡張を確認する
pH7Builderが要求するPHPバージョンと、実際にApacheが利用しているPHPバージョンが一致している必要があります。
確認コマンド例。
php -v
Apache側のPHP設定が異なる場合は、CLIでは動作していてもブラウザではエラーになることがあります。
また、以下のようなPHP拡張が不足していると起動できない場合があります。
- mbstring
- curl
- mysqliまたはpdo_mysql
- openssl
- gd
- xml
不足している場合はaptなどで追加インストールし、Apacheを再起動してください。
ファイル権限設定を見直す
pH7Builderではキャッシュやログ、アップロードファイルなどを書き込む必要があります。そのため、Apache実行ユーザーであるwww-dataが必要な場所へアクセスできる必要があります。
ただし、すべてのファイルを777にする方法はセキュリティ上推奨されません。
一般的には以下のように所有者と権限を調整します。
chown -R www-data:www-data /var/www/html/pH7Builder
find /var/www/html/pH7Builder -type d -exec chmod 775 {} \;
find /var/www/html/pH7Builder -type f -exec chmod 664 {} \;
特にcache、logs、uploadsなどの書き込みが必要なディレクトリは確認してください。
Apacheログを確認して原因を特定する
画面が表示されない場合、ブラウザだけでは原因が分からないことがあります。その場合はApacheのエラーログを確認します。
Ubuntuの場合、以下のコマンドで確認できます。
tail -f /var/log/apache2/error.log
例えば以下のようなエラーが出ている場合、それぞれ対応が異なります。
| エラー例 | 原因 |
|---|---|
| Permission denied | 権限不足 |
| PHP Fatal error | PHP設定や依存ライブラリ不足 |
| 404 Not Found | Apacheの公開パス設定 |
| 500 Internal Server Error | .htaccessやPHPエラー |
まとめ：pH7BuilderはApache設定とPHP環境確認が重要
pH7Builderインストール後にトップ画面が表示されない場合、単純なファイル配置だけではなくApacheの公開設定、rewrite設定、PHP環境、Composer依存関係、権限設定を順番に確認することが重要です。
特にApacheではDocumentRootと.htaccess設定が原因になることが多く、PHPアプリケーションではComposer installの実行忘れもよくある原因です。
まずApacheログを確認し、表示されているエラー内容に合わせて設定を修正することで、pH7Builderを正常に起動できる可能性が高まります。
コメント