4.

Apache / Nginx でドキュメントルートを変更する手順(Laravel public/ への切替も)

編集
この記事の要点
  • Apache: httpd.conf または sites-available/*.confDocumentRoot ブロックを変更
  • Nginx: server { root /path/to/public; } を変更
  • Laravel / Symfony / CakePHP は public/ サブディレクトリをドキュメントルートに指定するのが正解
  • 変更後は 権限(chown www-data, chmod, SELinux context)と設定リロードが必須
  • シンボリックリンクが使えれば ln -s /var/www/myapp/public /var/www/html で代用可能

ドキュメントルートとは

Web サーバが HTTP リクエストに対してファイルを探しにいく起点ディレクトリのことです。例えば http://example.com/foo.html でドキュメントルートが /var/www/html なら、/var/www/html/foo.html を返します。

変更したい代表ケース:

  • Laravel / Symfony / CakePHP を新規導入し、public/ サブディレクトリを公開したい
  • 複数アプリを仮想ホストで運用したい
  • 新サーバへの移行で公開先パスが変わった

Apache での変更(Ubuntu / Debian)

# /etc/apache2/sites-available/myapp.conf

    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /var/www/myapp/public

    
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    

    ErrorLog  ${APACHE_LOG_DIR}/myapp-error.log
    CustomLog ${APACHE_LOG_DIR}/myapp-access.log combined
# サイトを有効化
sudo a2ensite myapp.conf
sudo a2dissite 000-default.conf      # デフォルトを無効に

# 構文チェック
sudo apachectl configtest

# 設定リロード
sudo systemctl reload apache2

Apache: CentOS / RHEL の場合

# /etc/httpd/conf/httpd.conf もしくは /etc/httpd/conf.d/myapp.conf


    ServerName example.com
    DocumentRoot /var/www/myapp/public

    
        AllowOverride All
        Require all granted
    
# 構文チェック
sudo apachectl configtest

# リロード
sudo systemctl reload httpd

# SELinux が有効な場合(CentOS デフォルト)
sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/myapp(/.*)?"
sudo restorecon -Rv /var/www/myapp

Nginx での変更

# /etc/nginx/sites-available/myapp.conf
server {
    listen 80;
    server_name example.com www.example.com;

    root /var/www/myapp/public;     # ← ドキュメントルート
    index index.php index.html;

    access_log /var/log/nginx/myapp-access.log;
    error_log  /var/log/nginx/myapp-error.log;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}
# 有効化
sudo ln -s /etc/nginx/sites-available/myapp.conf /etc/nginx/sites-enabled/

# 構文チェック
sudo nginx -t

# リロード
sudo systemctl reload nginx

Laravel 等のフレームワーク向け

Laravel / Symfony / CakePHP は必ず public/ をドキュメントルートに指定します。プロジェクトルートを直接指定すると、.envvendor/ がインターネットに丸見えになる重大セキュリティ事故が起きます:

# プロジェクト構成
/var/www/myapp/
├── app/                ← 非公開(コード本体)
├── bootstrap/
├── config/
├── database/
├── public/             ← ★ここをドキュメントルートに
│   ├── index.php
│   └── .htaccess
├── resources/
├── routes/
├── storage/            ← 非公開(ログ・キャッシュ)
├── tests/
├── vendor/             ← 非公開(依存ライブラリ)
├── .env                ← 非公開(パスワード等)
└── composer.json

事故例: ドキュメントルートを /var/www/myapp にすると、http://example.com/.env でパスワードが取得できてしまいます。

権限の設定

ドキュメントルート変更とセットで権限を再設定します:

# 所有者を Web サーバユーザに(Ubuntu: www-data, CentOS: apache, nginx)
sudo chown -R www-data:www-data /var/www/myapp

# ディレクトリ: 755(自分書込, 他読込)
sudo find /var/www/myapp -type d -exec chmod 755 {} \;

# ファイル: 644
sudo find /var/www/myapp -type f -exec chmod 644 {} \;

# Laravel: storage/ と bootstrap/cache/ は書き込み可能に
sudo chmod -R 775 /var/www/myapp/storage
sudo chmod -R 775 /var/www/myapp/bootstrap/cache
sudo chown -R www-data:www-data /var/www/myapp/storage /var/www/myapp/bootstrap/cache

SELinux 環境(CentOS / RHEL)

SELinux が有効な場合、ファイルパーミッションが正しくてもコンテキストが合わないと 403 になります:

# 現在のコンテキスト確認
ls -lZ /var/www/myapp/public/

# httpd_sys_content_t をディレクトリに付与
sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/myapp(/.*)?"
sudo restorecon -Rv /var/www/myapp

# Laravel storage/ は書き込み可能なコンテキストに
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/myapp/storage(/.*)?"
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/myapp/bootstrap/cache(/.*)?"
sudo restorecon -Rv /var/www/myapp/storage /var/www/myapp/bootstrap/cache

# SELinux を一時的に Permissive にしてテスト
sudo setenforce 0
# 問題が直ったらコンテキスト不足が原因確定
sudo setenforce 1

シンボリックリンクで対応する方法

共用サーバ等で DocumentRoot を変更できない場合、シンボリックリンクで対応できます:

# 既存の /var/www/html を退避してリンクに
sudo mv /var/www/html /var/www/html.bak
sudo ln -s /var/www/myapp/public /var/www/html

# Apache の FollowSymLinks が必要
# 
#     Options FollowSymLinks
# 

動作確認

# Apache 設定の最終確認
apache2ctl -S       # VirtualHost と DocumentRoot 一覧
apache2ctl configtest

# Nginx 設定の確認
sudo nginx -T | grep -E "root|server_name"

# 実際にリクエスト
curl -I http://example.com/

# ログ確認
sudo tail -f /var/log/apache2/error.log
sudo tail -f /var/log/nginx/error.log

よくあるトラブル

症状原因対処
403 Forbidden権限不足 / SELinux コンテキストchmod 755 / restorecon
変更前のページが表示されるキャッシュ / 別仮想ホストが優先apache2ctl -S で確認
500 Internal Server Error.htaccess の文法エラー / 設定ミスerror.log 確認
404 Not Foundパスを間違えている / index.php 無しパス確認 + index ディレクティブ
ディレクトリ一覧が表示されるindex ファイル無 + Indexes 有効Options -Indexes

FAQ

Q: 複数アプリを同一サーバで運用したい
A: 仮想ホスト(VirtualHost / server ブロック)を ServerName ごとに分けて、それぞれ別の DocumentRoot を設定します。

Q: ユーザディレクトリ ~user/public_html を公開したい
A: Apache なら mod_userdir + UserDir public_html を有効化。Nginx は location ~ ^/~([^/]+)/(.+)?$ { alias /home/$1/public_html/$2; }

Q: 動かないが error.log にも何も出ない
A: VirtualHost 自体が読まれていない可能性。apache2ctl -S で表示されるか確認、a2ensite 漏れを疑います。

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. インストール (CentOS編)
  2. 起動・停止コマンドとステータスの確認 (CentOS編)
  3. VPSへの導入例(CentOS編)
  4. ドキュメントルートの変更方法
  5. phpを動かす際に必要な設定
  6. サブドメインの設定方法