Laravel 5.5 在 Windows 上最快落地的方式是 Laragon + composer global require "laravel/installer",5 分钟内可访问 http://blog.dev;Linux/macOS 推荐 composer create-project 拉取项目,但必须立即执行 php artisan key:generate 和 chmod -R 777 storage/ bootstrap/cache/。

直接上结论:Laravel 5.5 在 Windows 上最快落地的方式是 Laragon + composer global require "laravel/installer",不装 Homestead、不配 Apache/Nginx 手动虚拟主机,5 分钟内能跑出 http://blog.dev 页面;Linux/macOS 用户则推荐用 composer create-project 直接拉项目,但必须立刻补上 php artisan key:generate 和 chmod -R 777 storage/ bootstrap/cache/,否则必报错。
Windows 下用 Laragon 启动 Laravel 5.5 为什么比 XAMPP 快?
因为 Laragon 自带 PHP + MySQL + Apache 三件套,并且默认启用 Auto virtual hosts —— 只要把项目放进 C:\laragon\www\,它自动识别文件夹名生成 http://folder_name.dev 域名,不用改 hosts、不用配 vhost.conf。
实操要点:
- 安装 Laragon 后,务必在它的 Terminal(Cmder)里执行
composer global require "laravel/installer",否则laravel new blog命令会提示“不是内部或外部命令” - 创建项目时,别在普通 CMD 或 PowerShell 里运行
laravel new,必须用 Laragon 自带的 Terminal,它已预置好 PATH - 如果访问
http://blog.dev显示 404,检查 Laragon 左下角状态栏是否显示 Apache/MySQL 为绿色“Running”,没启动就点Start All - Laragon 默认 PHP 版本可能是 7.2+,而 Laravel 5.5 要求 PHP >= 7.0.0 且含
openssl、mbstring、tokenizer扩展 —— 点右上角齿轮 → PHP → 查看已启用扩展,缺哪个勾哪个
composer create-project 创建 Laravel 5.5 项目时常见报错
命令本身没问题:composer create-project --prefer-dist laravel/laravel blog "5.5.*",但执行完常卡在“Class 'Illuminate\Foundation\Application' not found”或白屏,根本原因是 vendor/autoload.php 没加载成功。
原因和解法:
- 没运行
composer install:虽然create-project通常会自动装依赖,但某些网络环境会跳过,进项目目录手动跑一遍composer install -
.env文件缺失或格式错误:复制.env.example为.env后,必须运行php artisan key:generate,否则APP_KEY为空,Laravel 5.5 会直接抛出No supported encrypter found - PHP 版本太低或扩展未启用:用
php -v和php -m | grep -E "(openssl|mbstring|tokenizer)"确认,尤其 WAMP/XAMPP 用户容易忽略php.ini中扩展行前的分号 - storage 目录无写权限:Linux/macOS 下必须
chmod -R 777 storage/ bootstrap/cache/;Windows 一般不报此错,但若用 IIS 或 Nginx 部署,仍需确认 IUSR 或 nginx 用户有写入权
为什么 php artisan serve 不能替代真实 Web 服务器?
它只是 PHP 内置服务器,仅用于快速验证逻辑,Laravel 5.5 的路由、重写(如 public/.htaccess)、静态资源处理都依赖 Apache/Nginx 的 rewrite 规则。直接访问 http://localhost:8000 可能漏掉 CSS/JS,或导致 Auth::user() 返回 null。
关键差异:
-
php artisan serve不读取.htaccess,所以public/外的请求不会被重写到index.php,API 路由可能 404 - Session、File Storage、Queue Worker 等组件在内置服务器下行为不稳定,尤其是 Windows 下常出现
file_put_contents权限拒绝 - Laragon / XAMPP / 宝塔等环境默认走 Apache/Nginx,其
DocumentRoot应设为项目public/目录,不是项目根目录 —— 错设会导致vendor/被直接暴露 - 调试时建议统一用真实服务器:Laragon 访问
http://blog.dev,宝塔访问http://yourdomain.com,避免切换环境引入歧义
最易被忽略的一点:Laravel 5.5 的 config/app.php 中 'cipher' => 'AES-128-CBC' 是硬编码的,如果你手动生成了 APP_KEY 但长度不对(比如用了 16 字符而非 32 字符 base64),就会触发 The only supported ciphers are AES-128-CBC and AES-256-CBC。别自己拼 key,只信 php artisan key:generate 的输出。


















