默认安装的不是Laravel v11而是较旧稳定版,因Packagist的latest指向滞后;应明确指定composer create-project laravel/laravel:^11.0并配置国内镜像、检查PHP≥8.2及必需扩展、运行php artisan key:generate生成APP_KEY、确保storage和bootstrap/cache可写。
composer create-project 装出来的不是最新版?
默认执行
会拉取
包的 latest 稳定版,但这个“latest”未必是你以为的“v11”——它取决于 packagist 上该包的 stable 分支指向。Laravel v11 在 2024 年 3 月才正式发布,而很多教程/镜像源缓存还没同步,容易装到 v10.48 或更早。
实操建议:
明确指定版本:用
(注意
符号,支持小版本更新)
加
加速下载(从压缩包而非 git clone)
国内用户务必先配置阿里云或腾讯云 Composer 镜像:
如果报
,大概率是镜像源没切干净,删掉
再试
php 版本和扩展不满足,artisan 命令直接报错
Laravel v11 要求 PHP >= 8.2,且必须启用
、
、
、
、
、
、
这些扩展。少一个,运行
就会卡在 autoload 或直接抛 Fatal Error。
常见错误现象:
→
没加载成功,通常是
或
缺失
→ 表面是路径问题,实际常因
命令调用的是系统自带的老版本(如 CentOS 自带 PHP 7.2)
→ Laravel v9+ 已弃用 mcrypt,出现这提示说明你误装了老项目模板或 composer.lock 锁死了旧依赖
验证方式:在项目根目录下跑
,缺哪个补哪个;再用
确认版本。
APP_KEY 为空导致 session 和加密失败
新项目首次运行前,
里的
是
开头的空值。不生成真实密钥,所有基于
、
、
的功能都会失效,比如登录后拿不到 session,或者
报
。
Laravel 13.2.0
PHP中文网提供Laravel 13.2.0版本下载,Laravel框架 是基于 PHP 8.3+ 的高性能框架,官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索,支持属性驱动开发与队列路由,大幅提升开发效率。相比旧版,13.2.0 优化了缓存 TTL 管理与实时通信,无需 Redis 即可横向扩展。作为现代 Web 开发首选,它兼顾安全与极速体验,助您快速构建企业级应用。
下载
必须做的一步:
进项目目录,立刻执行
别手动改
里的
—— artisan 命令会自动写入并校验格式
如果部署到生产环境,
必须保密,不能提交到 Git;本地开发也建议加进
换过
后,所有已加密数据(如 Cookie、缓存的加密 session)全部失效,用户需重新登录
serve 启动后页面空白或 500,但控制台没报错
默认监听
,看起来启动成功,但浏览器打开是空白或 500,通常不是 Laravel 本身的问题,而是底层环境或权限链路断了。
排查重点:
检查
—— 90% 的真实错误都在这里,比如
确认
和
目录可写:
(Linux/macOS)
Windows 用户如果用 WSL,注意 Windows 权限映射可能导致
无法监听端口,换用
更可靠
Chrome 浏览器偶尔会缓存 500 响应,强制刷新(Ctrl+F5)或换 Edge/Firefox 验证是否真出错
真正麻烦的是日志里出现
或
—— 这说明 PHP 配置被主机商或 Docker 容器限制死,得改 php.ini 或容器配置,不是 Laravel 层能绕过的。
composer create-project laravel/laravellaravel/laravelcomposer create-project laravel/laravel:^11.0^--prefer-distcomposer config -g repo.packagist composer https://mirrors.aliyun.com/composer/zlib_decode(): data error~/.composer/cache/mbstringopensslpdotokenizerxmlctypejsonphp artisanClass 'Illuminate\Foundation\Application' not foundautoload.phpjsonmbstringCould not open input file: artisanphpMcrypt is requiredphp -m | grep -E 'mbstring|openssl|pdo'php -v.envAPP_KEYbase64:encrypt()sessionsigned URLsURL::signedRoute()InvalidSignatureExceptionphp artisan key:generate.envAPP_KEYAPP_KEY.gitignoreAPP_KEYphp artisan servehttp://127.0.0.1:8000storage/logs/laravel.logfile_put_contents(/var/www/storage/logs/laravel.log): failed to open stream: Permission deniedstoragebootstrap/cachechmod -R 775 storage bootstrap/cachephp artisan servephp -S 127.0.0.1:8000 -t publicopcache.restrict_apirealpath(): open_basedir restriction