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免费学习笔记（深入）”；
- 不要只运行
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=mbstringextension=curlextension=opensslextension=xml - 确保
extension_dir指向正确的ext/目录（如C:\php\ext） - 重启 Web 服务后，用
phpinfo()页面确认状态
