应检查真实PHP运行环境并安装缺失扩展：确认PHP版本与模块名匹配，修改正确的php.ini，重启对应服务（如php-fpm或Docker重建镜像），避免CLI与FPM配置混淆。
trae 启动 PHP 时提示 PHP Warning: Module 'xxx' not found 怎么办
这是 traefik（你可能打错了“trae”）本身不运行 PHP——你实际用的是类似 php -S 或 Docker 中的 PHP 容器，而 traefik 只是反向代理。所谓“trae 运行 PHP 提示模块缺失”，本质是后端 PHP 环境没装好扩展，traefik 日志里透出的只是下游错误。
先确认真实执行 PHP 的位置：检查你是否在容器里跑 php-fpm、本地用 php -S，还是用了 Laradock / XAMPP / WSL2 下的 PHP。模块缺失永远发生在 PHP 进程启动那一刻，跟 traefik 无关。
PHP 模块缺失常见触发点和验证方式
运行 php -m 查看已加载模块；若报错或列表里没有 curl、mbstring、pdo_mysql 等，说明扩展未启用。注意区分：
-
php -m和php -i | grep 'Loaded Configuration File'显示的php.ini路径必须一致，否则改了错的配置文件无效 - Docker 环境下，
docker exec -it xxx php -m才是真实容器内状态，宿主机的php -m完全无关 - CLI（命令行）和 FPM（Web）可能用不同
php.ini，比如/etc/php/8.2/cli/php.inivs/etc/php/8.2/fpm/php.ini
Ubuntu/Debian 下补装 PHP 模块的标准操作
以 PHP 8.2 为例，缺 gd 或 xml 就直接装对应包：
立即学习“PHP免费学习笔记（深入）”；
sudo apt update sudo apt install php8.2-gd php8.2-xml php8.2-mbstring php8.2-curl php8.2-sqlite3
装完别忘了重启服务：
- 如果用
php-fpm：sudo systemctl restart php8.2-fpm - 如果用
php -S（内置服务器）：关掉再重起命令即可，无需 reload - 如果用 Docker：必须重建镜像（
docker build），单纯docker restart不生效
Mac 上用 Homebrew 装 PHP 扩展容易踩的坑
Homebrew 安装的 PHP（如 php@8.2）默认不带多数扩展，需手动编译或启用：
- 先确认扩展目录：
php-config --extension-dir，通常是/opt/homebrew/lib/php/pecl/20220829（版本号随 PHP 小版本变） - 很多扩展（如
redis、igbinary）要单独pecl install redis，且需确保phpize可用（来自同版本 PHP） -
extension=redis.so要写进正确的php.ini；Homebrew 的默认配置文件路径常是/opt/homebrew/etc/php/8.2/php.ini，不是/usr/local/etc/php/8.2/php.ini - 改完
php.ini后，务必运行brew services restart php@8.2（如果用 brew services 管理）或手动 kill + restartphp-fpm
模块名拼写、PHP 版本对齐、配置文件路径、服务是否真正重启——这四点漏掉任一个，都会让你反复看到“Module not found”。
