recode扩展在PHP 7.4+中已被彻底移除，phpEnv不提供该扩展；应改用mb_convert_encoding()或iconv()替代，并可通过函数垫片兼容旧代码。
recode 扩展在 PHP 7.4+ 已被彻底移出核心，phpEnv 无法开启它——不是配置问题，是根本不存在。
你看到的 recode_string() 函数调用会直接报 Fatal error: Uncaught Error: Call to undefined function recode_string()，哪怕你在 php.ini 里加了 extension=recode，也会提示 PHP Warning: PHP Startup: Unable to load dynamic library 'recode'。
recode_string() 调用失败：先确认扩展是否真存在
- phpEnv 默认不打包
recode，也不提供 Windows 下的编译版本（该扩展本身就不支持 Windows） - 运行
php -m | grep recode，输出为空 → 扩展未加载 - 运行
php --ri recode，提示Extension 'recode' doesn't exist→ 模块根本没编译进 PHP - 查看
phpinfo()页面，搜索 “recode” → 不会出现任何模块信息
这些现象不是配置漏了，而是 phpEnv 的构建脚本早已剔除该模块。
替代方案：用 mb_convert_encoding() 或 iconv() 实现等效转换
recode_string("ISO-8859-1..UTF-8", $str) 这类调用，完全可被以下任一方式替代：
立即学习“PHP免费学习笔记（深入）”；
mb_convert_encoding($str, "UTF-8", "ISO-8859-1")iconv("ISO-8859-1", "UTF-8//IGNORE", $str)
关键区别在于：
-
mb_convert_encoding()更健壮，支持编码探测（如mb_detect_encoding($str, ["UTF-8", "GBK", "BIG5"])），但依赖mbstring扩展（phpEnv 默认已启用） -
iconv()性能略高，但对非法字节更敏感；加//IGNORE可跳过损坏字符，加//TRANSLIT可尝试音近替换（如é→e）
注意：utf8_encode() 和 utf8_decode() 仅限 ISO-8859-1 ↔ UTF-8，别用它处理 GBK、Shift-JIS 等编码，否则乱码不可逆。
如果你必须兼容旧代码里的 recode_string() 调用
不要试图重装扩展，而是在项目入口处做函数垫片（polyfill）：
if (!function_exists('recode_string')) {
function recode_string(string $request, string $string): string|false {
// 简单映射常见 recode 请求格式：a..b → a → b
if (preg_match('/^([^.]*)\.\.([^.]*)$/', $request, $m)) {
[$_, $from, $to] = $m;
// iconv 不支持某些 GNU Recode 别名（如 "us"="ASCII"、"lat1"="ISO-8859-1"）
$map = [
'us' => 'ASCII',
'lat1' => 'ISO-8859-1',
'iso646-de' => 'ISO-8859-1',
'flat' => 'ASCII',
];
$from = $map[$from] ?? $from;
$to = $map[$to] ?? $to;
return @iconv($from, $to . '//IGNORE', $string) ?: false;
}
return false;
}
}这个垫片覆盖不了全部 GNU Recode 语义（比如 "html..latin1" 这种 HTML 实体解码），但能应付绝大多数字符集直转场景。
真正难处理的是那些依赖 GNU Recode 内置表的冷门转换（如 EBCDIC ↔ UTF-8），这种需求现在极少见，应优先重构数据源而非硬扛旧逻辑。
recode 不是“没打开”，是 phpEnv 根本不带——别花时间找 dll/so 文件或改 configure 参数。把精力放在验证 mbstring 是否启用、检查 iconv 支持的编码列表（iconv -l）、以及清理旧代码里隐含的编码假设上，更实际。
