Laravel 是一款具有表达力、优雅语法的 Web 应用程序框架。我们已为您下一个伟大构想奠定基础——让您无需纠结细节,专注创造。
📊 项目信息
- 语言
- Blade
- Stars
- ⭐ 84,356
- Forks
- 24,742
- 今日新增
- +13
- 排名
- #1
- 收录
- 语言榜
- 趋势日期
- 2026年5月29日
- 最后推送
- 2026/5/27
🏷️ 标签
frameworklaravelphp
Laravel 5分钟快速开始
Laravel 是一个优雅的 PHP Web 框架,本指南将帮助你在5分钟内创建并运行一个 Laravel 应用。
🖥️ 操作系统
macOSWindowsLinux
⚙️ 运行环境
PHP>=8.1
Composer>=2.0
🔧 工具
Composer— PHP 依赖管理
📝 操作步骤
1
安装 Laravel 项目
使用 Composer 创建一个新的 Laravel 项目
创建名为 example-app 的 Laravel 项目
$ composer create-project laravel/laravel example-app✓预期输出:下载并安装依赖,最后显示 'Application ready! Build something amazing.'
💡确保 Composer 已安装且 PHP 版本符合要求。如果网络慢,可换国内镜像。
2
进入项目目录
切换到新创建的项目文件夹
进入项目目录
$ cd example-app✓预期输出:无输出,命令行提示符改变
3
启动开发服务器
使用 Artisan 命令启动内置 PHP 开发服务器
启动开发服务器,默认监听 8000 端口
$ php artisan serve✓预期输出:Starting Laravel development server: http://127.0.0.1:8000
💡如果 8000 端口被占用,可使用 --port=8080 指定其他端口。
✅ 验证 Laravel 运行成功
在浏览器中访问 http://127.0.0.1:8000,看到 Laravel 欢迎页面即表示成功。
- ✓浏览器显示 Laravel 默认欢迎页面
- ✓页面包含 'Laravel' 标题和 'Documentation' 等链接
⚡ 快速提示
开发使用 php artisan make:model ModelName 快速创建模型
数据库使用 php artisan migrate 运行数据库迁移
🔍 常见问题排查
❓ Composer 安装缓慢或失败
→ 使用国内镜像:composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/
❓ php artisan serve 提示 'Command not found'
→ 确保 PHP 已添加到系统 PATH,或使用完整路径运行 PHP。
❓ 浏览器访问显示空白页
→ 检查 storage 和 bootstrap/cache 目录是否有写入权限,运行 chmod -R 775 storage bootstrap/cache
🎯 下一步
1
阅读官方文档
访问 https://laravel.com/docs 深入学习
2
创建路由和控制器
使用 php artisan make:controller 创建控制器,并在 routes/web.php 定义路由