laravel项目5分钟内可运行:先验证php≥8.1和composer≥2.5,再执行composer create-project创建项目,cd进入后运行php artisan storage:link,最后用php artisan serve启动,默认访问http://127.0.0.1:8000。

想在本地快速跑起一个Laravel项目用于测试或演示,又不想被环境配置、PHP版本、Composer依赖卡住半天?用Laravel内置的内置服务器+最小化安装流程,5分钟内完成从零到可访问首页的全部操作。
确认基础环境是否就绪
打开终端,依次执行以下命令验证:php -v → 确保输出 PHP 8.1 或更高版本;composer --version → 必须显示 Composer 2.5+;which php 和 which composer 输出路径不能指向 Homebrew 或 Docker 内部路径——【若其中任一命令报错或版本过低,后续所有步骤都会失败】。
Windows 用户请直接使用 WSL2 环境,CMD 或 PowerShell 中的 PHP 很可能缺少 OpenSSL 扩展,会导致后续 artisan 命令静默退出。
创建并初始化 Laravel 项目
执行 composer create-project laravel/laravel blog --prefer-dist --no-interaction,加 --no-interaction 可跳过环境选择提示,避免卡在交互式问答上。
等待约 60~90 秒,目录 blog/ 生成后进入:cd blog。
运行 php artisan storage:link —— 这一步必须做,否则上传文件功能和部分资源路径会 404,且不会报错,只在浏览器里表现为图片不显示、CSS 加载失败。
启动开发服务器
方法一:直接启用内置服务器
执行 php artisan serve,默认监听 http://127.0.0.1:8000。终端出现 “Server running on http://127.0.0.1:8000” 即表示成功。
方法二:指定端口与主机(适合多项目并行)
执行 php artisan serve --host=0.0.0.0 --port=8080,这样局域网其他设备也能通过本机 IP 访问,比如 http://192.168.1.100:8080。
方法三:后台静默运行(Mac/Linux)
执行 php artisan serve > /dev/null 2>&1 &,进程转入后台,不占用当前终端。关闭时用 kill %1 或查 ps aux | grep serve 后 kill 对应 PID。
验证首页是否正常加载
第一步:打开浏览器,访问 http://127.0.0.1:8000。
第二步:页面应显示 Laravel 默认欢迎页,右下角有 “You are using Laravel v11.x” 字样。
第三步:按 Ctrl+U 查看源码,搜索 laravel-logo,确认 HTML 中存在该 class —— 【若只看到空白页或 “No input file specified”,说明 public/index.php 未被 Web 服务器正确路由,此时不是代码问题,而是你误用了 Apache/Nginx 而非 artisan serve】。











