laravel环境部署核心是精准匹配:php≥8.1且必须启用openssl、pdo、mbstring、tokenizer、xml、json、bcmath、ctype、fileinfo;composer需独立安装v2.7.7+并验证诊断;node.js推荐20.x lts以支持vite/mix构建。

部署 Laravel 环境,核心不是装得多,而是装得准——PHP 版本和扩展必须匹配 Laravel 当前主版本(2026 年主流为 v12.3+ / v13),Composer 要能跑通依赖安装,Node.js 要支撑前端资源编译。漏一项,composer install 就可能卡在 laravel/framework,甚至报 Class 'Illuminate\Foundation\Application' not found。
PHP:版本与扩展一个都不能少
Laravel 12/13 要求 PHP ≥ 8.1(PHP 8.0 已不被多数新包支持)。仅装 PHP 不代表可用,以下扩展必须启用:
- 必启扩展:OpenSSL、PDO、Mbstring、Tokenizer、XML、JSON、BCMath、Ctype、Fileinfo
-
常见疏漏点:Ubuntu 默认不启用 Fileinfo,需手动运行
sudo phpenmod fileinfo;宝塔用户请进「软件商店 → PHP 设置 → 安装扩展」勾选并重启服务 -
快速验证:终端执行
php -v查版本,再用php -m | grep -E "openssl|pdo|mbstring|tokenizer|fileinfo"核对是否全部加载
Composer:独立部署、版本要对
Composer 不是 PHP 自带工具,哪怕你刚装了 PHP 8.4,也必须单独安装。当前稳定版 v2.7.7 最低支持 PHP 7.2,但强烈建议搭配 PHP 8.1+,否则 Laravel 13、Symfony 7 等新包会直接拒绝安装。
- Linux/macOS 推荐一键安装:
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer - 安装后务必验证:运行
composer --version和composer diagnose,后者会检查 PHP CLI、扩展(json、mbstring、openssl、curl、zip)是否就绪 - 若遇
proc_open(): fork failed,说明主机禁用了该函数(常见于共享主机),只能本地装好再上传vendor/和composer.lock
Node.js:前端构建不可绕过
Laravel 项目默认含 Vite 或 Mix 构建流程,Node.js 是编译 JS/CSS、运行开发服务器的前提。2026 年推荐使用 Node.js 20.x LTS(长期支持版),避免旧版(如 16.x)与新版 Vite 插件不兼容。
- 验证命令:
node -v(应 ≥ v20.0.0)、npm -v(建议 ≥ 10.2.0) - 若项目使用 Laravel Mix,确保全局或本地装有
webpack相关依赖;若用 Vite,默认通过npm run dev启动,无需额外配置 - 注意:部分 Docker 开发容器(如 laravel-devcontainer)已预装 Node.js、npm、git、vim 等工具,可跳过手动安装
辅助工具:提升效率不踩坑
这些不是 Laravel 运行硬性依赖,但能显著降低部署和调试成本:
-
Git:管理代码、拉取官方脚手架(如
laravel new project)、协同开发基础 - 数据库客户端:HeidiSQL(Windows)、TablePlus(macOS/Linux)或 DBeaver(跨平台),方便快速查表、导入 SQL、调试迁移
-
调试增强包(开发阶段):
barryvdh/laravel-debugbar(Web 请求可视化)、itsgoingd/clockwork(全请求类型追踪,含 API 和 Artisan 命令) - 环境管理工具:Laragon(Windows 一键集成)、Laravel Sail(基于 Docker 的轻量方案)、或 VS Code + Remote - Containers(标准化开发容器)
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











