phpEnv怎么开启Enchant扩展 phpEnv配置拼写检查方法-php教程-PHP中文网

phpenv 中 enchant 扩展默认未编译进 php 二进制包，需手动下载匹配版本的 php_enchant.dll、配置 php.ini 并正确设置字典路径，否则 enchant_broker_init() 会失败。

phpenv怎么开启enchant扩展 phpenv配置拼写检查方法

phpEnv 中 Enchant 扩展默认不启用，需手动开启

phpEnv 是 Windows 下的 PHP 集成环境（类似 XAMPP），但它的 Enchant 扩展默认是禁用状态，且 php.ini 里没有现成的 extension=enchant 行——不是漏写，而是压根没编译进默认 PHP 二进制包。直接取消注释或加 extension 会报 PHP Warning: Unable to load dynamic library 'enchant'。

确认 PHP 是否带 Enchant 支持（先看有没有）

运行 php -m | findstr enchant（Windows 命令行）或 php -i | grep enchant（Git Bash/WSL）。如果无输出，说明当前 phpEnv 自带的 PHP 版本不含 Enchant 模块——这很常见，尤其 PHP 8.0+ 的精简版。

phpEnv 官方打包的 PHP 通常只含常用扩展，enchant 属于可选拼写检查模块，需额外下载对应 DLL
不同 PHP 版本（如 7.4、8.1、8.2）对应的 php_enchant.dll 不通用，必须严格匹配线程安全（TS/NTS）和架构（x64/x86）
Enchant 依赖系统级拼写引擎：Windows 上靠 hunspell 或 ispell 后端，但 phpEnv 不自带词典文件，需手动放好路径

启用步骤：下载 DLL + 配置 php.ini + 设置字典路径

以 phpEnv 附带的 PHP 8.1 TS（线程安全）x64 版本为例：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

去 PECL Enchant 页面下载对应版本的 php_enchant.dll（例如 enchant-2.2.15-8.1-ts-vc15-x64.zip）
解压后把 php_enchant.dll 放到 phpEnv 的 ext/ 目录下（如 D:\phpEnv\php\php-8.1-ts\ext\）
在 php.ini（通常是 D:\phpEnv\php\php-8.1-ts\php.ini）末尾添加：
```
extension=enchant
```
Enchant 在 Windows 上需要指定字典路径，否则 enchant_broker_init() 返回 false。在 php.ini 加：
```
enchant.aspell.dictionary.path="D:\phpEnv\aspell-dicts"<br>enchant.myspell.dictionary.path="D:\phpEnv\myspell-dicts"
```
（你得自己建这两个目录，并放入对应格式的 .aff/.dic 文件）
重启 Apache/Nginx，再运行 php -m 确认 enchant 出现在列表里

验证拼写检查是否真能用（别被 extension 加载成功骗了）

即使 extension=enchant 加载成功，enchant_broker_init() 也可能失败——这是最常踩的坑。写个最小验证脚本：

<?php <br>$broker = enchant_broker_init();<br>if (!$broker) {<br>    echo "Enchant broker init failed\n";<br>    exit;<br>}<br>$dicts = enchant_broker_list_dicts($broker);<br>var_dump($dicts); // 应该输出至少一个 ['en_US', 'zh_CN'] 类似数组<br>?>

如果 $dicts 为空或报错 enchant_broker_request_dict(): No dictionary found for language，说明字典路径不对、语言代码不支持，或词典文件损坏。Windows 下推荐用 winlibs 提供的 hunspell 词典包，解压后把 en_US.aff 和 en_US.dic 放进 enchant.myspell.dictionary.path 指向的目录即可。

注意：phpEnv 自带的 Apache 不会自动重读 php.ini，改完配置后必须彻底停止服务再启动，不能只“重启”。