| この記事の要点 |
|
このカテゴリについて
Laravel でアプリを作り始めるまでに必要な、インストールと環境設定に関する記事をまとめています。Laravel 本体の導入だけでなく、作ったアプリを公開するための Web サーバー(Apache)と、アプリからメールを送るためのメールサーバー(Postfix)の設定も扱います。
ローカルで動かして学習するだけなら前半の 2 本、サーバーに公開するなら全体、と目的に合わせて必要な記事を選んでください。
読む順番
| 順番 | 記事 | この記事で分かること |
|---|---|---|
| 1 | Laravel のインストール手順まとめ | composer / Laravel インストーラー / Sail(Docker)/ Herd などの導入方法の違いと、プロジェクトの作成手順 |
| 2 | プロジェクト作成時の初期設定リスト | 作成直後にやっておくこと(.env、タイムゾーン・言語、DB 接続など)とおすすめ設定 |
| 3 | Apache Web サーバ設定 | Apache の設定ファイル構成、VirtualHost、モジュール。Laravel を公開する土台 |
| 4 | Postfix 基本設定 | メール送信サーバー Postfix のインストールと基本設定 |
| 5 | Postfix メールサーバ設定 | Postfix をメールサーバーとして運用するための詳細な設定 |
インストールから公開までの全体像
個々の手順は各記事で解説しているので、ここでは全体の流れだけを示します。
- PHP と Composer を用意する: Laravel はバージョンごとに必要な PHP のバージョンが決まっています。導入する Laravel の公式ドキュメントで要件を確認し、必要な PHP 拡張(mbstring、xml、pdo など)も入れておきます
- プロジェクトを作成する:
composer create-project laravel/laravel myappまたは Laravel インストーラーのlaravel new myapp - 初期設定をする:
.envを用意し、php artisan key:generateでアプリケーションキーを生成。DB の接続情報を書いてマイグレーションを実行 - ローカルで動作確認:
php artisan serveで開発サーバーを起動し、http://localhost:8000を開く - Web サーバーで公開する: Apache(または Nginx)のドキュメントルートを
publicディレクトリに設定し、storageとbootstrap/cacheに Web サーバーの書き込み権限を与える - メール送信を設定する: 自前の Postfix を使うか、外部の SMTP / メール配信サービスを使うかを決め、
.envのMAIL_で始まる項目を設定する
選び方のポイント
インストール方法
- 手元の PC で手軽に試したい: Composer で直接作成するか、Herd(Windows / macOS 向けの PHP 開発環境)を使う
- チームで環境を揃えたい・本番に近い構成で開発したい: Docker ベースの Sail を使う
- 既存の XAMPP 環境がある: XAMPP の PHP と Composer で作成できるが、PHP のバージョンが Laravel の要件を満たしているか確認する
Web サーバー
このカテゴリでは Apache を扱っています。.htaccess が同梱されているため Apache は導入しやすく、Nginx は設定ファイルに書き換えルールを直接書く必要がある代わりに、静的ファイルの配信などで軽量です。どちらを使う場合も「公開するのは public だけ」という原則は同じです。
メール
Postfix を自分で構築すると自由度は高いものの、迷惑メール扱いを避けるための SPF・DKIM・DMARC の設定や、送信元 IP の評判管理まで自分で行う必要があります。問い合わせ通知など送信件数が少ない用途なら、外部の SMTP サーバーやメール配信サービスを Laravel から使う方が手軽な場合もあります。
つまずきやすいポイント
- 「No application encryption key has been specified」:
php artisan key:generateの実行漏れ - 画面が真っ白・500 エラー:
storage/logs/laravel.logを確認。多くは storage の書き込み権限か .env の設定ミス - .env を変更したのに反映されない: 設定キャッシュが残っている。
php artisan config:cacheで作り直す - トップページ以外が 404: Apache の mod_rewrite が無効、または
AllowOverrideで .htaccess が読まれていない
関連
- Composer インストール完全ガイド(Windows / macOS / Linux 対応)
- PHP インストール方法完全ガイド (Win/Mac/Linux)
- Laravel .env 設定完全ガイド(DB / APP_KEY / config:cache / 複数環境)
- Apacheのドキュメントルートを変更する方法
- Laravel No application encryption key has been specified エラー
同階層のページ
- インストールと設定
- クイックスタート & チュートリアル(初心者向け)
- クイックスタート & チュートリアル(中級者向け)
- ルーティング
- Bladeテンプレート(ビュー/レイアウト)
- コントローラー
- マイグレーションとテーブル定義
- データベースの設定
- Eloquentモデル (ORM)
- SQLとクエリビルダー
- バリデーション
- .envファイルの設定値へのアクセス
- 動作環境による分岐処理
- configフォルダ配下の設定値へのアクセス
- assetヘルパーを利用したpublicフォルダへのアクセス
- storageフォルダへのアクセス
- アプリケーション名の変更
- メンテナンス
- ログイン画面(認証システム)の作成
- ログインの必須化
- ログインユーザー情報の取得
- ルートの認証化
- 本番サーバーへのデプロイ方法
- 多言語化
- csrf_field
- ファイルのダウンロード
- CSVのアップロードおよび読み込み(maatwebsite/excel)
- ページタイトルの設定
- コマンド一覧
- エラー一覧
- SQLの実行ログ出力方法
- キャッシュのクリア
- Selectの結果の最初もしくは最後に任意の値を追加する方法
- ajaxでPOST通信する際の注意点
- ソーシャルログインの実装
- セッション情報の確認
- ログイン、ユーザー登録、パスワードリセット後のリダイレクト先の変更方法
- redirectやreturn viewにメッセージを付与する方法
- クッキー(cookie)の設定と取得
- クラスの再読み込み
- csrfの有効時間を変更する方法
- ViewComposerを用いてviewに共通の値を付与する方法
- View::shareを用いて共通の値を各ビューに渡す方法
- ミドルウェアを用いた処理の共通化
- Middleware内でAuth::check()などを使用する方法
- Controller以外でリダイレクトする方法
- セッションの値の取得/保存/更新/削除
- $requestの値を変更する方法
- 常時SSL化
- ページング(ページネーション)をする方法
- vue.jsとの連携
- Vue.jsと連携するSPA実行環境構築
- .envの値をvue.jsで参照する方法
- vue.jsを本番環境にリリースする方法
- could not find driver(Windows, MySQL編)
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09