Laravelで管理画面付きのHPを作る際のディレクトリ構成について

Question

これまで、Laravelで簡単な社内向けシステムを作ってきました。今度、管理画面つきのホームページをLaravelで組もうと思ってるのですが、はたとディレクト構成のことで悩み出しました。

社内向けシステムの時は、言ってみれば管理画面のみを作るということだったのでディレクトリ構成に悩むということありませんでした。

管理画面は、少し省略しますが

httpdocs/
　└ admin/
　   ├ app/
　   │  └ Http/
　   │     └ Controllers/
　   │           └ NewsController.php
　   ├ resources/
　   │     └ views/
　   │         └ news/
　   │             └ index.blade.hphp
　   ├ routes/
　   │    └ web.php
　   └ public/
         └ index.php

という構成で、下記のようなルーティングを設定し

Route::get('/news', [App\Http\Controllers\NewsController::class, 'index']);

https://sample.com/admin/news/にアクセスすれば管理画面のお知らせ一覧を出す、などといった形にしています。

フロント側をまったく考慮していなかったので、ドキュメントルートは/httpdocs/admin/にしており、/httodocs/admin/.htaccesに

RewriteCond %{REQUEST_URI} (.\w+$) [NC]
RewriteRule ^(.*)$ public/$1 

の処理を書いて、/public/index.phpが起点になるようにしています。

この状態だと、例えばフロント側のニュース一覧のURLをhttps://sample.com/news/と想定したとすると、Laravelアプリケーションを動かすことができないかと思います。

ドキュメントルートやディレクトリ構成を一から考え直す必要があると思っているのですが、フロントありでLaravelの開発をしたことがなく、どういう構成にすればいいのかが考え付きません。

フロントと管理画面をセットで組む場合、一般的にどうこう構成にするのがセオリーというのはあるのでしょうか。

周囲でもLaravelでのノウハウがなく、参考にできるアプリケーションもないので自分で調べたりしているのですが、意外と情報が見つからずに悩んでいます。

何かヒントになるようなことでも教えていただけると有難いです。
サーバー環境はCentOS8、PHP7.4+MySQL、Laravelは8.12です。

よろしくお願いいたします。

Answer 1

Laravelは常に、Webサーバで設定する「Webディレクトリ」のルートから提供するべきです。WebディレクトリのサブディレクトリからLaravelアプリケーションを提供しないでください。そうしてしまうと、アプリケーション内に存在する機密ファイルが漏洩する可能性があります。

https://readouble.com/laravel/8.x/ja/installation.html

解決策は、基本一つです。
それはシンボリックリンクを貼る方法です。

htdocsの親ディレクトリにLaravelのプロジェクトをClone（もしくはそれに準ずる方法でアップロードし）、そのプロジェクト内へのシンボリックリンクを、htdocsディレクトリの中に、adminという名前で作成してください。

Comments

[avantgarden]

ありがとうございます。

・サーバーのドキュメントルートは/htdocsに変更

・下記のディレクトリ構成に変更

admin/
├ app/
│ └ Http/
│ └ Controllers/
│ └ NewsController.php
├ resources/
│ └ views/
│ └ news/
│ └ index.blade.hphp
├ routes/
│ └ web.php
htdocs/
├ admin/
│ └ index.php　（管理画面の起点となるindex.php）
└ index.php　（フロント側の起点となるindex.php）

・下記のシンボリックリンクを張る
ln -s /var/www/admin/public /var/www/htdocs/admin/

という理解で合ってますでしょうか。

フロント側のアプリケーションをどう配置するかという疑問が残ります。
そもそも上記の理解が間違っていたらすみません…

[avantgarden]

すいません、内容を理解しまして、ディレクトリ構成とシンボリックリンクを下記のように変更しました。サーバーのドキュメントルートは/htdocsです。

project/　（プロジェクト名がadminである必要はないので適当に変更）
├ app/
│ └ Http/
│ └ Controllers/
│ └ NewsController.php
├ resources/
│ └ views/
│ └ news/
│ └ index.blade.hphp
├ routes/
│ └ web.php
├ public/
│ └ index.php
htdocs/
└ admin（/var/www/project/publicへのシンボリックリンク）

シンボリックリンク：「ln -s /var/www/project/public admin」

これで、
https://sample.com/admin
へのアクセスで管理画面のアプリケーションは動きました。

ただ、２点疑問が出てきました。

■ルーティングの変更が必要かと思ったのですが、上記構成に変更後も、
Route::get('/news', [App\Http\Controllers\NewsController::class, 'index']);
https://sample.com/admin/news
にアクセスしてもエラーになりません。

Route::get('/admin/news', [App\Http\Controllers\NewsController::class, 'index']);
と変更せずに動く理由が分かりません…

■https://sample.com/news
とアクセスした場合もLaravelアプリケーションが動くようにしたいですが、どのようにシンボリックリンクを張ればいいでしょうか？Laravelの/public/index.phpにたどり着ければ、あとはルーティングで管理画面とフロントの処理を分ければいけると思うのですが。

Answer 2

■https://sample.com/news

とアクセスした場合もLaravelアプリケーションが動くようにしたいですが、どのようにシンボリックリンクを張ればいいでしょうか？Laravelの/public/index.phpにたどり着ければ、あとはルーティングで管理画面とフロントの処理を分ければいけると思うのですが。

一つの手段ではありますが、ドキュメントルートの .htaccess でリクエストに対する処理を無理やり /public/index.php にねじ曲げる方法があります。

# .htaccess
RewriteCond %{REQUEST_URI} ^/news.*$
RewriteRule ^ /admin/index.php [L] # project/public/index.phpの場所

上記のように記載することで、 https://sample.com/news に対するリクエストをindex.phpで受け取ることができます。

ただ、もしこのサイトを修正する時間があるのであれば、ドキュメントルートを public/index.php に振り直してルーティングを適切に組み直したり、Laravelの処理を特定のディレクトリ配下に封じ込めることをお勧めします。
（/news/配下に封じ込めるのであれば、/news/index.phpなどでLaravelのindex.phpが起動するように設定するなど）
バックエンドの知見は深いようにお見受けしたので当然承知の上とは思いますが、推奨されていない歪な実装は今後拡張する上で間違いなく身動きが取れなくなると思います。