| この記事の要点 |
|
Laravel プロジェクトの作り方
Laravel の新規プロジェクトは大きく 2 つの方法で作れます。Composer 経由と Laravel Installer 経由です。どちらも結果は同じ Laravel スケルトンですが、Installer は対話形式で初期構成(認証スタック / テストフレームワーク / DB ドライバ等)を選べるのが特徴です。
方法 1: Composer で作成(最も基本)
# 最新版で作成
composer create-project laravel/laravel my-app
# バージョン指定(例: Laravel 11 系)
composer create-project "laravel/laravel:^11.0" my-app
# 開発用キャッシュを使わず最小構成で
composer create-project laravel/laravel --prefer-dist my-app
カレントディレクトリ直下に my-app/ が作られ、必要な依存パッケージがダウンロードされます。完了後はそのまま cd my-app で移動して開発を始められます。
方法 2: Laravel Installer(推奨)
Laravel Installer はグローバルに 1 度入れておけば、以後は laravel new 一発で対話的にプロジェクトを生成できます。Starter Kit(Breeze / Jetstream)の選択や、DB ドライバ・テストフレームワーク選択を CLI で案内してくれます。
# Installer を 1 度だけグローバル導入
composer global require laravel/installer
# パスを通す(.bashrc / .zshrc に追加)
export PATH="$HOME/.composer/vendor/bin:$PATH"
# 新規作成(対話的)
laravel new my-app
# 主なオプション
laravel new my-app --git # 自動で git init + 初コミット
laravel new my-app --pest # Pest を使う
laravel new my-app --breeze # Breeze スタータキット
laravel new my-app --jet # Jetstream スタータキット
作成直後の初期セットアップ
- 環境変数ファイル:
.env.exampleをコピーして.envを作成(composer create-project経由なら自動で生成済み) - アプリケーションキーを生成:
php artisan key:generate - DB 接続情報を
.envに設定(DB_CONNECTION/DB_HOST/DB_DATABASE等) - マイグレーション実行:
php artisan migrate - シンボリックリンク(公開ストレージ用):
php artisan storage:link - フロントエンド依存導入:
npm install&npm run dev
cd my-app
# 環境ファイル準備
cp .env.example .env # create-project では既に生成されている
php artisan key:generate
# DB(.env の DB_* を編集してから)
php artisan migrate
# ストレージリンク
php artisan storage:link
# フロントエンド
npm install
npm run dev
# 開発サーバ起動
php artisan serve
# → http://127.0.0.1:8000
主要ディレクトリ構成
| ディレクトリ | 役割 |
|---|---|
app/ | モデル / コントローラ / サービス(アプリのコア) |
routes/ | ルート定義(web.php / api.php) |
resources/ | Blade テンプレート / JS / SCSS など |
database/ | マイグレーション / シーダー / ファクトリ |
config/ | 設定ファイル群 |
public/ | ドキュメントルート(index.php) |
storage/ | ログ / キャッシュ / アップロード |
vendor/ | Composer 依存(.gitignore 対象) |
前提環境
| Laravel | PHP | 主要拡張 |
|---|---|---|
| 11.x | 8.2 以上 | BCMath, Ctype, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML |
| 10.x | 8.1 以上 | 同上 |
| 9.x | 8.0 以上 | 同上 |
加えて Composer 2.x、Web サーバ(開発時は php artisan serve でも可)、必要に応じて Node.js / npm(Vite ビルド用)が要ります。
Sail(Docker 環境)で作る
ローカルに PHP / MySQL を入れたくない場合、公式 Docker 環境 Laravel Sail で一発立ち上げできます。
# Sail 同梱で作成(mysql / pgsql / redis などを選ぶ)
curl -s "https://laravel.build/my-app?with=mysql,redis" | bash
cd my-app
./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate
よくあるトラブル
| 症状 | 原因 / 対処 |
|---|---|
composer create-project が失敗 | PHP バージョン / 拡張モジュール不足。php -v / php -m で確認 |
No application encryption key | php artisan key:generate 未実行 |
SQLSTATE[HY000] [2002] | DB 接続情報誤り。.env の DB_HOST / ポート / 認証情報を見直し |
| 403 / 404 が出る | ドキュメントルートが public/ になっていない(Apache / Nginx 設定) |
| Storage の画像が 404 | php artisan storage:link 忘れ |
関連
- Laravel — フレームワーク本体
- Composer — PHP の依存管理
- php artisan / Artisan コマンド一覧
- .env / 環境変数
- マイグレーション / Eloquent
子ページ
子ページはありません
同階層のページ
人気ページ
- 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