phpEnv不提供MariaDB线程池配置能力，需手动安装thread_pool插件并设置thread_handling=pool-of-threads等参数，且插件与配置缺一不可。
phpEnv 本身不提供 MariaDB 线程池配置能力 —— 它只是 Windows 下的 PHP + Web 服务器（Apache/Nginx）+ 数据库（MySQL/MariaDB）集成环境管理工具，底层 MariaDB 实例仍需手动启用线程池插件并配置参数。
确认 MariaDB 版本是否支持线程池
MariaDB 5.5+ 原生支持线程池，但默认不启用；phpEnv 自带的 MariaDB 多为 10.x（如 10.3/10.4/10.6），基本都支持。先验证：
mysql -u root -p -e "SELECT VERSION(); SHOW VARIABLES LIKE 'thread_handling';"
若返回 thread_handling 值为 one-thread-per-connection，说明线程池未启用；正确值应为 pool-of-threads。
- phpEnv 安装包里 MariaDB 的
my.ini通常位于phpEnv\Extensions\MariaDB\my.ini或phpEnv\Extensions\MariaDB\data\my.ini - 不要直接改
my.ini后就重启服务 —— MariaDB 必须显式安装thread_pool插件，否则即使配置了也会忽略 - 部分 phpEnv 封装的 MariaDB 编译时未启用
THREAD_POOL特性（尤其旧版），INSTALL PLUGIN thread_pool SONAME 'thread_pool.so'会报错Plugin 'thread_pool' is not loaded
手动安装 thread_pool 插件并启用
插件名固定为 thread_pool，但动态库文件名因平台而异：thread_pool.dll（Windows）、thread_pool.so（Linux）。phpEnv 是 Windows 工具，所以找 .dll：
立即学习“PHP免费学习笔记（深入）”；
- 进入 MariaDB 的
lib/plugin/目录（如phpEnv\Extensions\MariaDB\lib\plugin\），确认存在thread_pool.dll - 若不存在，需从同版本官方 MariaDB ZIP 包中提取（注意架构一致：x64/x86），不能混用版本
- 以管理员身份运行 phpEnv 内置的 MySQL 客户端，执行：
INSTALL PLUGIN thread_pool SONAME 'thread_pool.dll';
- 成功后检查：
SHOW PLUGINS;中thread_pool状态应为ACTIVE
在 my.ini 中配置线程池关键参数
仅安装插件还不够，必须通过配置让 MariaDB 启动时使用线程池模式。编辑 my.ini，在 [mysqld] 段落下添加或修改：
thread_handling = pool-of-threads thread_pool_size = 4 thread_pool_max_threads = 64 thread_pool_idle_timeout = 60
-
thread_handling是开关，必须设为pool-of-threads，否则插件不生效 -
thread_pool_size建议设为 CPU 核心数（非超线程数），phpEnv 多用于开发机，2~4 足够；设太高反而增加调度开销 -
thread_pool_max_threads控制池内最大并发工作线程，短连接洪峰场景可调高，但超过 128 易引发锁争用 - phpEnv 默认没配
thread_pool_min_threads，它控制预热线程数，不设则按thread_pool_size启动
重启 MariaDB 并验证是否真正生效
phpEnv 界面点“重启 MariaDB”或命令行执行：phpenv service mariadb restart。之后立即验证：
mysql -u root -p -e "SHOW VARIABLES LIKE 'thread_handling'; SELECT * FROM information_schema.PROCESSLIST WHERE USER='system user' AND COMMAND='Thread Pool';"
- 第一行输出必须是
pool-of-threads；如果不是，说明my.ini路径不对、配置段落写错位置，或 MariaDB 启动时根本没读这个文件（可用mysqld --verbose --help | findstr "Default options"查实际加载路径） - 第二条查询若返回若干
system user的Thread Pool线程，说明池已运转；空结果可能意味着还没触发调度（等几个并发请求后再查） - 常见坑：
thread_pool插件无法与query_cache_type=1共存（MariaDB 10.2+ 已弃用 query cache，但旧版 phpEnv 可能还开着），冲突会导致启动失败
线程池不是“开个开关就变快”，它只对大量短连接（如 PHP-FPM 每次请求建新连接）有明显收益；若你用的是持久连接（mysqli::real_connect 带 MYSQLI_CLIENT_FOUND_ROWS 以外的 flag）或 PDO 的 PDO::ATTR_PERSISTENT，效果几乎为零 —— 这点容易被忽略。
