Laravel顺利安装需满足三点：PHP≥8.1（Laravel 13强制）、必需扩展（openssl/pdo/mbstring/tokenizer/xml/ctype/json/zip）全部启用、系统支持（如exec函数可用）；不推荐PHP<7.4或未启用OpenSSL等环境。

Laravel 框架对 PHP 环境有明确要求，不是所有 PHP 版本或配置都能顺利安装运行。能否“顺利安装”，关键看三点：**PHP 版本、必需扩展是否启用、以及系统基础支持是否到位**。 以下是可以顺利安装 Laravel（当前主流版本如 10.x / 11.x / 12.x / 13.x）的 PHP 环境条件：

✅ 支持的 PHP 版本范围

截至 2026 年，Laravel 最新稳定版为 13.33，官方要求：

• PHP ≥ 8.1.0（Laravel 13 强制要求）
• Laravel 12 支持 PHP 8.0–8.3
• Laravel 11 要求 PHP 8.0+，但已不推荐用于新项目
• PHP 7.4 及更早版本仅适用于 Laravel ≤ 9.x，且已停止安全更新

✅ 必须启用的 PHP 扩展

缺一不可，否则安装会失败或运行时报错（如 `Class 'Illuminate\Foundation\Application' not found` 或 `No supported encrypter found`）：

• OpenSSL（HTTPS、加密、Composer 下载依赖必需）
• PDO（数据库操作基础）
• Mbstring（多字节字符串处理，路由、验证、本地化依赖）
• Tokenizer（Artisan 命令、模板编译必需）
• XML（部分包、测试工具、Laravel Dusk 等需要）
• Ctype（字符类型判断，框架底层频繁调用）
• JSON（配置解析、API 响应基础）
• Zip（Laravel Installer、`php artisan vendor:publish`、打包部署常用）

注意：ext-fileinfo 在某些 Laravel 版本（如 10+）中也建议启用，避免 `mime_content_type()` 相关警告；ext-pcntl 非必需，但开启后可支持队列监听、多进程优化。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

✅ 推荐的集成环境（Windows / macOS / Linux）

这些环境预装了兼容版本的 PHP 和扩展，开箱即用程度高：

立即学习“PHP免费学习笔记（深入）”；

• Windows：XAMPP（PHP 8.2+ 版）、WAMP Server（v3.3+）、Laragon（专为 Laravel 优化，含 Artisan 图形菜单）
• macOS：MAMP PRO（支持多 PHP 切换）、Homebrew + PHP 8.2/8.3（`brew install php@8.3`）
• Linux（Ubuntu/CentOS）：APT/YUM 安装 PHP 8.2+ + 扩展包（如 `php8.2-mbstring php8.2-xml php8.2-zip`），配合 Nginx/Apache 配置即可
• 容器化：Docker 官方 `php:8.3-apache` 或 `laravelphp/php` 镜像，最干净可控

❌ 明确不推荐或无法安装的环境

• PHP 7.3 及更低版本（Laravel 10+ 已完全放弃支持）
• 未启用 OpenSSL 的 PHP（Composer 无法下载包，`curl error` 或 `failed to open stream`）
• Windows 上使用旧版 phpStudy 2016（默认 PHP 5.6/7.0，扩展缺失且无法升级到 8.1+）
• SAE、早期云虚拟主机（PHP 5.3/5.4，无 shell 权限，不支持 Composer）
• 禁用 `exec()` / `shell_exec()` 的共享主机（Artisan 命令将失效）