在新加坡服务器运行Laravel 12应用,需要满足哪些PHP与扩展依赖?

发布人:A5数据发布时间:2026-11-15 13:36阅读量:25

交付验收时,Laravel 12 的最低 PHP 版本和扩展是否齐全,只是兼容判断的第一步:实际运行还取决于项目锁定的 Composer 依赖、PHP-FPM 使用的运行时、数据库驱动,以及应用自身要求的可选扩展。新加坡服务器的地理位置不会改变 Laravel 的版本要求;应核对服务器操作系统提供的 PHP 构建、扩展和数据库连接能力是否与项目一致。

Laravel 12 的 PHP 基线是 PHP 8.2。低于 8.2 不符合要求;达到 8.2 也不等于一定可交付,因为项目中的第三方依赖可能限制 PHP 版本,或要求额外扩展。验收应以项目的 composer.json、composer.lock 和实际提供 Web 请求的 PHP 环境共同判断,而不是只看服务器上某个 PHP 命令的版本。

1. PHP 版本:确认项目与 Web 运行时一致

核对项:PHP 版本、运行方式和项目依赖的版本范围。

Laravel 12 至少需要 PHP 8.2。PHP 8.1 及更早版本不满足该框架的运行要求;PHP 8.2 及以上版本还需要通过项目依赖的兼容性检查。不能只凭版本号较新,就判定所有业务代码和第三方包都兼容。

检查对象判断依据验收结论
PHP 8.1 或更早低于 Laravel 12 的最低要求不通过
PHP 8.2达到框架最低版本继续核对锁定依赖与扩展
高于 PHP 8.2 的版本框架与依赖的版本约束都允许,且已在目标运行环境验证条件通过

先检查命令行 PHP 的版本和加载配置:

php -v
php --ini

但这只能说明当前命令行程序的情况。网站通常由 PHP-FPM 或其他 Web 运行时执行;同一台服务器可能同时安装多个 PHP 版本,命令行与 PHP-FPM 也可能加载不同的配置和扩展。交付时应确认站点实际绑定的 PHP-FPM 版本、对应配置文件和扩展加载情况。不要把命令行显示的 PHP 8.2,直接当作网站已经运行在 PHP 8.2。

1. PHP 版本:确认项目与 Web 运行时一致配图

旧业务环境还要单独判断。若现有应用依赖 PHP 8.1 或更早版本,不能只把服务器的 PHP 全局升级后,就认定 Laravel 12 与旧应用都能运行。应按站点确认各自的 PHP 运行时和依赖要求;共享主机上的另一个业务系统不能替代 Laravel 12 项目自身的兼容性验证。

2. PHP 扩展:区分框架基础要求与项目附加要求

核对项:Laravel 12 所需的基础扩展是否由实际 Web 运行时加载;项目依赖是否增加扩展要求。

Laravel 12 的基础扩展要求包括以下项目。不同系统可能将扩展编入 PHP,或以独立软件包提供;验收重点是目标 PHP 运行时能够加载,而不是安装包名称是否完全相同。

扩展或功能核对重点
Ctype字符类型判断相关功能可用
cURL网络请求等相关功能可用
DOMDOM 文档处理可用
Fileinfo文件类型识别可用
Filter输入过滤功能可用
Hash哈希相关功能可用
Mbstring多字节字符串处理可用
OpenSSL加密及 TLS 相关能力可用
PCRE正则表达式功能可用
PDO数据库抽象接口可用
Session会话功能可用
TokenizerPHP 代码词法分析功能可用
XMLXML 相关功能可用

可先在命令行查看扩展列表:

php -m

也可以按名称逐项检查:

php -r '$required = ["ctype", "curl", "dom", "fileinfo", "filter", "hash", "mbstring", "openssl", "pcre", "PDO", "session", "tokenizer", "xml"]; foreach ($required as $ext) { printf("%-12s %s\n", $ext, extension_loaded($ext) ? "OK" : "MISSING"); }'

这些命令仍然只检查当前命令行 PHP。实际验收应以 PHP-FPM 对应的运行时为准,并确认站点处理请求时能加载所需扩展。排查时优先核对 PHP-FPM 绑定的版本、配置文件和模块列表;不要仅根据操作系统上“已安装某个 PHP 扩展包”推断 Web 环境一定可用。

还要查看项目自身对扩展的声明。composer.json 可能直接要求 ext-* 扩展,第三方 Composer 包也可能提出额外要求。常见的项目附加需求包括 intl、gd、imagick、zip、bcmath 或 redis,但它们不是 Laravel 12 的通用基础要求,应按项目实际使用的功能和依赖判断。例如,图像处理包可能需要图像扩展;使用 Redis 的项目可能需要相应客户端扩展或兼容的 PHP 客户端包。

因此,基础扩展检查通过后,不能省略 Composer 平台检查。反过来,某个应用没有使用某项可选功能,也不应仅因为其他项目安装了对应扩展,就把它当作本项目的必需条件。

3. Composer 依赖:以项目锁文件判断能否解析和运行

核对项:框架版本、依赖锁定结果、PHP 版本约束及扩展约束是否彼此兼容。

composer.json 表示项目允许的依赖范围,composer.lock 则记录本项目实际锁定的依赖版本。只看 laravel/framework 的版本,不足以覆盖所有第三方包;例如,某个认证、支付、队列或图像处理包可能对 PHP 版本或扩展提出更严格的要求。

在项目目录中,可以查看 Laravel Framework 版本并检查锁定依赖的平台要求:

composer show laravel/framework
composer check-platform-reqs --lock

依赖已安装后,再运行:

composer check-platform-reqs

第一条 check-platform-reqs 命令用于核对锁文件中的 PHP 和扩展要求;未带 --lock 的命令用于核对已安装依赖。两者都不能被 composer.json 中的版本声明替代。若项目设置了 config.platform,它可能影响 Composer 解析依赖时采用的模拟 PHP 平台;实际交付环境仍需按真实 PHP 版本和扩展进行检查。

判断时重点看以下情况:

  • composer.json 的 PHP 约束是否包含目标 PHP 版本。
  • composer.lock 中已锁定的依赖是否都接受该 PHP 版本。
  • 锁定依赖所需的扩展是否在目标 PHP-FPM 环境中加载。
  • 新旧环境使用的锁文件是否相同,是否存在未提交或未同步的依赖变更。
  • Composer 检查是否报告缺失扩展、PHP 版本不符合或包约束冲突。

若命令行 Composer 检查通过,但网站启动时报缺少扩展或类不存在,应优先比较命令行 PHP 与 PHP-FPM 的版本及已加载模块。若锁文件本身的依赖约束与目标 PHP 不兼容,则不能通过单纯补装扩展解决,需要先确认项目实际允许的依赖组合,再决定是否调整依赖版本。

4. 数据库与 PDO 驱动:数据库版本和 PHP 连接能力分别验收

核对项:数据库版本是否达到 Laravel 12 的支持基线,PHP 是否安装对应 PDO 驱动,项目 SQL 是否适用于目标数据库。

Laravel 12 的常见数据库版本基线如下。它们用于初步判断框架与数据库的大致兼容范围,不代表项目中所有查询、迁移脚本或第三方包都已适配该数据库版本。

数据库常见最低版本基线PHP 侧需要核对
MySQL5.7PDO 与 pdo_mysql
MariaDB10.3PDO 与 pdo_mysql
PostgreSQL10PDO 与 pdo_pgsql
SQLite3.26PDO 与 pdo_sqlite
SQL Server2017PDO 及相应 SQL Server 驱动

例如,MySQL 服务器版本达标,不代表 PHP 已能连接它:PHP 仍需加载对应 PDO 驱动。可以查看当前命令行 PHP 提供的 PDO 驱动:

php -r 'echo implode(", ", PDO::getAvailableDrivers()), PHP_EOL;'

该结果同样需要在实际 Web 运行时复核。对于 SQL Server 等数据库,驱动的安装方式和可用版本还可能受操作系统、PHP 版本及驱动构建方式影响,不应只根据数据库服务器版本判断连接一定可用。

数据库达到最低基线后,还应核对项目实际使用的数据库类型和 SQL 特性。重点包括迁移脚本能否执行、字段类型和索引是否受支持、JSON 等功能是否符合业务用法,以及现有字符集、排序规则和 SQL 模式是否会改变查询结果。兼容性异常应定位到具体 SQL、迁移或驱动,不要把“框架支持该数据库”理解成“旧数据库配置和所有业务语句无需检查”。

新加坡服务器连接位于其他地区的数据库时,网络延迟可能影响请求耗时,但它不是 PHP 版本或扩展兼容性条件。若数据库并不部署在同一台服务器,应把“PHP 驱动可连接”和“网络链路满足业务要求”作为两项分别验收,避免混为一项。

A5idc数据提供新加坡物理服务器方案,也覆盖香港、美国、日本、韩国、中国台湾及马来西亚等地区。新加坡产品具备不同CPU、存储及优化或国际线路资源,可为Laravel 12网站、业务后台及数据库承载应用运行环境提供基础设施选择;多地区布局也适用于面向不同访问区域的部署需求。

5. 操作系统与实际运行环境:确认软件包落在正确的 PHP 实例上

核对项:系统发行版、CPU 架构、PHP 软件包来源及 PHP-FPM 配置是否相互匹配。

Laravel 12 不要求服务器必须位于某个特定地区,也不以“新加坡”作为运行时条件。操作系统的作用主要体现在:能否提供符合要求的 PHP 版本、扩展是否可为该 PHP 版本安装,以及 PHP-FPM 是否正确加载这些模块。发行版和版本不同,扩展软件包的命名、仓库来源和可用版本也可能不同,不能把某一系统的软件包名称直接套用到另一系统。

验收时可以逐项确认:

  • 系统发行版仍在维护范围内,且所用 PHP 软件包来自适配该系统的仓库。
  • PHP CLI 与站点 PHP-FPM 的版本、架构和扩展配置符合预期。
  • 新装扩展对应的是站点实际使用的 PHP 版本,而非服务器上另一个版本。
  • PHP-FPM 启动正常,站点能够加载应用入口文件并连接所需数据库。
  • 操作系统或 PHP 升级后,重新执行项目平台依赖检查并复核关键业务功能。

如果一台服务器承载多个旧业务,不要将“某个站点能运行”当作所有站点共用一套 PHP 版本的证据。按站点核对运行时;新旧项目的 PHP 约束不同,就分别验证各自环境,避免为满足 Laravel 12 而意外改变旧业务的运行条件。

6. 可选扩展与前端构建:按项目功能判断,不误列为框架硬性要求

核对项:项目是否实际依赖特定 PHP 扩展,生产环境是否需要 Node.js。

可选扩展应从依赖声明和应用功能中确认,而不是依据服务器上常见的软件清单猜测。比如,应用使用图片缩放或格式转换时,相关图片库可能要求 gd 或 imagick;依赖特定国际化格式化功能时,可能需要 intl;使用特定 Redis 客户端时,可能需要 redis 扩展,或使用项目声明的其他客户端包。应以锁定依赖的要求和实际业务调用为准。

Node.js 与 PHP 扩展也要区分。Laravel 应用若使用 Vite 等前端构建工具,Node.js 通常用于生成前端资源;若部署包已包含构建完成的静态资源,生产服务器是否需要 Node.js 取决于项目的发布流程,而非 Laravel 12 的 PHP 基础要求。核对时查看项目的 package.json、构建脚本和发布产物,不要把 Node.js 版本误写成 PHP 运行时依赖。

交付判断可以压缩为三层:

  1. 框架基线通过:PHP 不低于 8.2,Laravel 12 所需基础扩展可用。
  2. 项目依赖通过:锁定的 Composer 包接受目标 PHP 版本,所有声明的扩展在实际 Web 运行时可加载。
  3. 业务连接通过:数据库版本与 PDO 驱动适配,项目迁移、关键查询及实际请求在目标环境验证正常。

任何一层不通过,都不应以“服务器已装 PHP 8.2”作为兼容验收结论。对于旧业务并存的服务器,记录各站点的 PHP-FPM 版本、扩展列表、Composer 检查结果和数据库驱动情况;系统软件包或运行时变更后,按同一清单复核受影响站点。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9631.html

相关推荐