laravel / laravel

84,36224,740+11 todayBlade

Laravel is a web application framework with expressive, elegant syntax. We’ve already laid the foundation for your next big idea — freeing you to create without sweating the small things.

📊 Project Info

Language: Blade
Stars: ⭐ 84,362
Forks: 24,740
Today: +11
Ranking: #1
Collection: Language
Trending Date: June 2, 2026
Last Push: 5/27/2026

🏷️ Topics

frameworklaravelphp

Laravel 5分钟快速开始

Laravel 是一个优雅的 PHP Web 框架，本指南将帮助你在5分钟内创建并运行一个 Laravel 应用。

🖥️ OS

macOSWindowsLinux

⚙️ Runtime

PHP>=8.1

Composer>=2.0

🔧 Tools

Composer— PHP 依赖管理

📝 Steps

安装 Laravel 项目

使用 Composer 创建一个新的 Laravel 项目

创建名为 example-app 的 Laravel 项目

$ composer create-project laravel/laravel example-app

✓Expected: 下载并安装依赖，最后显示 'Application ready! Build something amazing.'

💡确保 Composer 已安装且 PHP 版本符合要求。如果网络慢，可换国内镜像。

进入项目目录

切换到新创建的项目文件夹

进入项目目录

$ cd example-app

✓Expected: 无输出，命令行提示符改变

启动开发服务器

使用 Artisan 命令启动内置 PHP 开发服务器

启动开发服务器，默认监听 8000 端口

$ php artisan serve

✓Expected: Starting Laravel development server: http://127.0.0.1:8000

💡如果 8000 端口被占用，可使用 --port=8080 指定其他端口。

✅ 验证 Laravel 运行成功

在浏览器中访问 http://127.0.0.1:8000，看到 Laravel 欢迎页面即表示成功。

✓浏览器显示 Laravel 默认欢迎页面
✓页面包含 'Laravel' 标题和 'Documentation' 等链接

⚡ Quick Tips

开发使用 php artisan make:model ModelName 快速创建模型

数据库使用 php artisan migrate 运行数据库迁移

🔍 Troubleshooting

❓ 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

🎯 Next Steps

阅读官方文档

访问 https://laravel.com/docs 深入学习

创建路由和控制器

使用 php artisan make:controller 创建控制器，并在 routes/web.php 定义路由