PHP未启用mbstring扩展会导致中文乱码、字符截断及mb_substr等函数报错；需通过php.ini启用extension=mbstring并重启服务，或在CLI、Docker、WAMP/XAMPP中对应配置并验证。
如果您在浏览器中运行PHP脚本时遇到中文乱码、字符截断或函数调用失败（如mb_substr、mb_strlen报错），则很可能是PHP未启用mbstring扩展。以下是开启mbstring扩展的多种方法：
一、通过php.ini文件手动启用
mbstring是PHP内置的多字节字符串处理扩展，需在配置文件中显式启用才能使用相关函数。修改php.ini是最直接且全局生效的方式。
1、找到当前PHP使用的php.ini文件路径：在Web服务器根目录下新建一个PHP文件，写入<?php phpinfo(); ?>，通过浏览器访问并搜索“Loaded Configuration File”项，确认完整路径。
2、使用文本编辑器以管理员权限打开该php.ini文件。
立即学习“PHP免费学习笔记（深入）”；
3、查找;extension=mbstring这一行（可能被注释或不存在）。
4、将其修改为extension=mbstring（Windows系统下若为DLL扩展，确保写为extension=php_mbstring.dll；Linux/macOS下通常为extension=mbstring.so）。
5、保存文件后，必须重启Web服务器（如Apache或Nginx）及PHP-FPM服务，使配置生效。
二、通过命令行启用（适用于CLI环境）
当仅需在命令行PHP中启用mbstring（例如执行Composer、Laravel Artisan命令），可绕过web服务器配置，单独为CLI版本启用扩展。
1、执行php --ini命令，查看CLI模式加载的php.ini路径。
2、编辑该php.ini文件，按第一种方法启用extension=mbstring。
3、执行php -m | grep mbstring，若输出mbstring则表示已加载成功。
4、注意：此操作不影响Web服务器中的PHP，需另行配置web版php.ini。
三、在Docker环境中启用
使用官方PHP镜像（如php:8.2-apache）时，mbstring默认未启用，需通过Dockerfile或配置挂载方式激活。
1、在Dockerfile中添加指令：RUN docker-php-ext-enable mbstring（适用于已编译安装的扩展）。
2、若使用Alpine镜像，需先安装扩展包：RUN apk add --no-cache php82-mbstring，再启用。
3、对于通过docker-compose.yml挂载自定义php.ini的情况，确保挂载后的文件中包含extension=mbstring且无分号注释。
4、构建镜像后必须重建容器，旧容器不会自动继承新配置。
四、通过WAMP/XAMPP控制面板启用
Windows用户若使用集成环境，可通过图形界面快速启用扩展，避免手动编辑配置文件出错。
1、点击WAMP/XAMPP系统托盘图标，展开PHP → PHP扩展选项。
2、在扩展列表中勾选php_mbstring（XAMPP）或mbstring（WAMP）。
3、等待服务自动重启，或手动点击“Restart All Services”。
4、访问phpinfo()页面验证，搜索“mbstring”确认“enabled”状态及“libmbfl version”信息存在。
5、若勾选后仍不生效，需检查php.ini是否为控制面板实际加载的配置文件。
五、验证mbstring是否已正确启用
无论采用何种启用方式，最终都必须通过代码或命令行确认扩展处于活动状态，避免因路径错误或服务未重启导致误判。
1、创建test_mb.php文件，内容为：<?php var_dump(extension_loaded('mbstring'));
2、在浏览器中访问该文件，返回bool(true)即表示成功。
3、也可在终端执行php -r "var_dump(extension_loaded('mbstring'));"进行验证。
4、若返回false，请回溯检查对应php.ini路径、扩展名拼写、服务重启动作是否全部完成。
