PHP strtr 数组替换的最长键优先规则与模板占位处理
来源:17golang原创
时间:2026-11-19 15:38:45 250浏览 收藏
PHP 里处理模板占位符时,strtr() 的数组形式通常比连续调用 str_replace() 更稳:它会优先尝试更长的键,替换出的新值也不会再次被当成待替换文本。这样,:id 和 :id2 同时存在时,不容易因为替换顺序改变结果。
官方参考:https://www.php.net/manual/en/function.strtr.php
- 数组形式的
strtr($text, $pairs)适合一轮完成模板占位替换。 - 重叠键按最长键优先尝试;替换结果不会再次参与本轮匹配。
- 三参数形式按字节翻译字符,中文场景应优先使用数组形式。
两参数数组形式的匹配边界
先把占位符设计成有边界的键,例如 :id、:id2。数组形式会把键当作子串映射,并优先处理更长的键,因此 :id2 不会被短键 :id 抢先截走。替换后的文字不再重新扫描,所以替换值中即使出现另一个键,也不会触发隐式的二次展开。
'A-7',
':id2' => 'A-700',
];
// 数组形式按更长的键优先匹配,结果不会再次回到键表中搜索。
$result = strtr($template, $pairs);
echo $result;
?>
这个写法的关键不是把键排序后再循环,而是把一次替换的边界交给 strtr()。业务占位符建议统一使用前缀、大小写和命名规则,避免把 id 这种过短的普通词直接当作键。

三参数形式为什么不适合中文模板
strtr($text, $from, $to) 是字符翻译模式,按单字节位置把 $from 映射到 $to。UTF-8 中文一个字符通常占多个字节,直接把中文放进这种模式可能拆坏编码。需要替换中文短语或模板变量时,使用二维关联数组:
'小林',
'{{date}}' => '周五',
];
// 只替换当前输入中的键,不把替换结果当成新的模板输入。
$rendered = strtr($text, $pairs);
echo $rendered;
?>
如果需求是把单字节字符集中的若干字符逐个翻译,三参数形式仍然有用;如果需求是替换词组、中文文本或占位符,数组形式更符合任务边界。
strtr 与 str_replace 的选择清单
| 任务 | 优先选择 | 理由 |
|---|---|---|
| 占位键可能互相包含 | strtr 数组形式 | 更长键优先,替换值不回扫 |
| 多个搜索词必须按业务顺序处理 | str_replace | 数组元素按给定顺序处理 |
| 单字节字符逐个翻译 | strtr 三参数形式 | 适合字符到字符的映射 |
| 需要正则、捕获组或条件匹配 | preg_replace | 固定字符串映射不是正则任务 |
连续调用 str_replace() 时,要特别留意前一次的替换值是否会被下一次命中;这可能造成意外的嵌套展开。模板系统还应限制键集合来源,避免让用户输入直接成为替换键和值。

常见问题
strtr 会把替换出来的占位符继续展开吗?
不会。数组形式替换后,新值不会再次参与当前这次匹配;如果业务需要多轮展开,应显式设计循环次数和终止条件。
为什么 :id2 没有被 :id 替换掉?
这是数组形式的最长键优先规则在起作用。若占位符命名不清晰,仍建议使用成对分隔符或统一前缀,减少普通文本误命中。
中文字符串应该用哪个 strtr 签名?
使用 strtr($text, $pairs) 的数组形式,把完整中文短语或占位键作为数组键;不要把中文拆进三参数的字节翻译模式。
-
366 收藏
-
272 收藏
-
312 收藏
-
297 收藏
-
451 收藏
-
331 收藏
-
493 收藏
-
121 收藏
-
157 收藏
-
447 收藏
-
文章 · php教程 | 21小时前 | 文件处理 · 面向对象 · php教程 · php SplFileInfo SplFileInfo::getFileInfo getFileInfo setInfoClass 文件信息对象500 收藏
-
文章 · php教程 | 22小时前 | 正则表达式 · 迁移 · php教程 · php split replace MATCH RegexIterator getMode GET_MATCH ALL_MATCHES344 收藏
-
177 收藏
-
文章 · php教程 | 23小时前 | 反射 · php教程 · php 函数反射 ReflectionFunction ReflectionFunctionAbstract getExtensionName238 收藏
-
330 收藏
-
165 收藏
-
469 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习