PHP 8.1扩展安装分两种路径：系统包管理器一键安装（如apt install php8.1-mbstring）或源码编译时通过./configure --enable-mbstring --with-curl等参数启用，二者需匹配CLI与Web环境。

PHP 8.1 扩展不是“单独装”的，而是分两种路径：系统包管理器一键安装（适合 CLI 和 Web 环境一致的场景），或源码编译时通过 ./configure 参数启用（适合定制化部署、多版本共存、或 Web Server 模块集成需求）。Mbstring 和 cURL 是最常被 Laravel、Composer、ThinkPHP 8 等框架依赖的核心扩展，缺一即报错，比如 Class 'Composer\Autoload\ClassLoader' not found 或 Call to undefined function mb_strlen()。

用 apt 安装（Ubuntu/Debian 快速方案）

适用于已通过官方仓库或 Ondřej Surý PPA 安装 PHP 8.1 的用户。注意包名必须严格匹配 PHP 版本：

• 确认当前 CLI 使用的 PHP 版本：php -v（输出应含 8.1.x）
• 检查是否已加载：php -m | grep -E "(mbstring|curl)"
• 缺失则执行（以 PHP 8.1 为例）：
  sudo apt update && sudo apt install php8.1-mbstring php8.1-curl php8.1-xml php8.1-zip php8.1-openssl
• 重启 Web 服务（如 Apache/Nginx）或对应 PHP-FPM 实例：
  sudo systemctl restart apache2 或 sudo systemctl restart php8.1-fpm

源码编译时启用（精确控制、模块集成必需）

若你从 php.net 下载源码自行编译（例如对接 Apache 或定制 FPM），mbstring 和 curl 必须在 ./configure 阶段显式声明，否则不会生成对应模块：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

• --enable-mbstring：启用多字节字符串支持（非可选扩展，是核心功能层）
• --with-curl：链接系统 libcurl 库（需提前安装 libcurl4-openssl-dev 或 libcurl-devel）
• 典型最小安全配置示例：
  ./configure \
--prefix=/usr/local/php8.1 \
--with-config-file-path=/etc/php8.1 \
--enable-fpm \
--enable-mbstring \
--with-curl \
--with-openssl \
--with-zlib \
--enable-xml
• 编译后验证：/usr/local/php8.1/bin/php -m | grep -E "(mbstring|curl)"

群晖 / 多环境常见陷阱

Web Station 或 Docker 等环境中，CLI 和 Web 进程可能使用不同 PHP 实例，导致扩展“看似装了却无效”：

• 不要只运行 php -m，要查 Web Station 绑定的实际路径（如 /volume1/@appstore/PHP81/usr/bin/php）
• 用该完整路径验证：/volume1/@appstore/PHP81/usr/bin/php -m | grep mbstring
• 群晖需在 DSM → Web Station → 对应 PHP 版本 →「扩展」页手动勾选并「重启该 PHP 版本」
• Composer 安装也必须用同一路径执行：/volume1/@appstore/PHP81/usr/bin/php composer-setup.php

Windows / Cygwin 环境补充

若使用 Windows + Cygwin 或 WAMP/XAMPP，通常无需编译，只需编辑 php.ini 启用对应 DLL：

• 取消注释或添加：
  extension=mbstring
extension=curl
extension=openssl
extension=xml
• 确保 extension_dir 指向正确的 ext/ 目录（如 C:\php\ext）
• 重启 Web 服务后，用 phpinfo() 页面确认状态

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！