Laravel 6 を Apache (XAMPPなど) で動かすインストール手順と開発用の設定方法 / Twin Turbo Computing

はじめに

Webプログラミングを行う際、僕はローカル環境の構築に Docker をよく使います。

Docker は本番に近い環境で開発を進めることができるので便利なのですが、構築の手間や動作コストなどのデメリットもあります。

そのため、学習や実験などでちょっと試すときには Windows や Mac 上の Apache を使って行っています。

ところで Laravel の開発では artisan server コマンドを使って動かすのが一般的なようで、インストール方法を調べると、その記事が多く見受けられます。しかし僕としてはやはり Apache で動かしたかったで、いろいろと試してきました。

そこで今日は、僕が Laravel で実験する際によく使っている、Laravel 6 を Composer でインストールして Apache HTTP Server 上で動かすまでの手順を、 XAMPP の場合を例にご紹介します。

今回の記事では XAMPP や Apache、Composer のインストール手順は割愛します。

目次

公式ドキュメントで紹介されているように、下記コマンドで Laravel 6 をインストールします。

下記例は XAMPP を想定し、ドキュメントルートの「lara6」というフォルダにインストールしています。インストールパスや、フォルダ名は適宜変更してください。

> cd c:\xampp\htdocs
> composer create-project --prefer-dist laravel/laravel lara6 "6.*"

このままだと http://localhost/lara6/public のようになるので、この /public を省略するようにします。httpd.conf などで変更する方法もあるのですがちょっと手間なので、僕は .htaccess で変更しています。

.htaccess は下記 gist で公開されているものを使っています。タイトルは laravel 5.5 となっていますが 6 でも使用可能です。

Php laravel 5.5 project .htaccess file · GitHub: https://gist.github.com/liaotzukai/8e61a3f6dd82c267e05270b505eb6d5a

リダイレクトがうまくいかない場合は .htaccess の内容が間違っていないか（コピペミスなど）、もしくは apache の設定で .htaccess や mod_rewrite が無効になっていないか確認してください。

これはちょっと余談ですが、僕はメール送信の確認に Laravel のログファイル出力機能を使用しています。誤操作防止もかねてインストール直後に .env ファイルを下記のように変更しています。

/.env

MAIL_DRIVER=log
MAIL_HOST=
MAIL_PORT=

Mail & Local Development (Mail - Laravel - The PHP Framework For Web Artisans): https://laravel.com/docs/6.x/mail#mail-and-local-development

最後にもう少し、僕が実際にどう使っているかをご紹介します。実験用プログラムのフォルダを用意し、hosts と httpd-vhosts.conf を編集してhttp:://example.localhost のような URL でそのフォルダにアクセスするようにしています。

そして、そのフォルダの中で上記コマンドを使って Laravel をインストールし、http:://example.localhost/lara6 という感じで使うことが多いです。

もし /lara6 のようなサブディレクトリの中ではうまく確認できない場合は、http://lara6.localhost/ などでアクセスできるように設定して試しています。

hosts や httpd-vhosts.conf の設定方法については割愛しますが、検索サイトで hosts、httpd-vhosts、バーチャルホスト、サブドメイン、などの単語で検索すれば見つかると思います。