metaphone()函数返回代表英文发音的可变长字符串键（如"sn"），基于英语音素规则生成，大小写不敏感；设length参数仅为压缩提示，结果可能略超；php 8.0+下不再返回false，空串输入返回空串。
metaphone() 函数到底返回什么
它不返回“相似度分数”，也不返回布尔值判断是否匹配，而是返回一个代表英文发音的字符串键（比如 "SN" 或 "PRKRMNK"）。这个键是基于英语音素规则生成的，长度可变，且对大小写不敏感。你拿到的是一个“发音指纹”，后续要靠自己做相等比较（===）或分组统计。
传 length 参数时的实际行为
length 不是硬截断，而是一个“最多生成多少个音素”的提示。PHP 会尽量压缩到该长度，但可能略超——因为某些音素（如 "X" 被转成 "KS"）本身占两个字符，无法拆开。所以 metaphone("Asterix", 5) 返回 "ASTRKS"（6 字符），不是 bug，是设计如此。
- 设为
0（默认）：不限长度，最完整发音表示 - 设为正整数：尝试压缩，但结果长度可能等于或略大于该值
- 不要用它来“标准化长度”做哈希索引——键长不可控
和 soundex() 最关键的区别在哪
soundex() 只保留首字母 + 最多 3 位数字编码，丢失大量发音细节；metaphone() 理解 "gh" 不发音、"ph" 读 /f/、"kn" 的 k 静音等规则，因此对真实英文单词更鲁棒。比如：
metaphone("through") → "0R"，metaphone("threw") → "0R"，但 soundex("through") 是 "T600"，soundex("threw") 是 "T600" —— 表面一样，实际 metaphone 在更多边缘 case 下仍保持一致性。
不过注意：metaphone() 专为英语设计，对非英语词（如 "Müller"、"Zhang"）效果差，别强用。
PHP 8.0+ 的兼容性坑
PHP 8.0 起，metaphone() **不再失败返回 false**，任何合法字符串输入都返回非空字符串。这意味着你不能再写 if (metaphone($str) === false) 来判错——它永远不会进这个分支。错误只发生在传了非字符串类型（如 null、数组）时触发 TypeError，而不是静默失败。
所以真正要做的防御是：
- 用
is_string($str)提前过滤 - 对空字符串
""，metaphone("")返回空字符串""，不是false - 别依赖返回值类型做逻辑分支，统一当字符串处理
发音匹配这件事，核心从来不是函数怎么调，而是你怎么组织比较逻辑——比如先按 metaphone() 分桶，再在桶内用 levenshtein() 细筛，漏掉这层设计，光调对函数也没用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
