跳转到主内容
极星编程网:以代码为星,赴技术山海!

Laravel怎么安装_Laravel安装入门步骤【教程】

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

相关文章