本文讲解在 php 的 foreach 循环中只显示一次固定标题（如 "title"）的两种可靠方法：一种是利用键值判断首项动态插入标题，另一种是将标题逻辑移出循环、结构更清晰的推荐写法。
在 PHP 开发中，常遇到需要为一组循环数据添加统一标题（如 <p>TITLE</p>），但又不希望该标题随每次迭代重复输出。原始代码将标题直接写在 foreach 内部，导致每轮都渲染一次，显然不符合需求。
✅ 方法一：利用键索引判断首项（轻量适配）
通过 foreach ($array as $key => $value) 获取当前元素的键（索引），当 $key === 0 时仅执行一次标题输出：
<?php
$colors = ["red", "green", "blue", "yellow"];
foreach ($colors as $key => $value) {
if ($key === 0) {
echo "<p>TITLE</p>";
}
echo htmlspecialchars($value) . "<br>";
}
?>✅ 输出效果：
TITLE red<br> green<br> blue<br> yellow<br>
⚠️ 注意事项：
- 使用 === 0（严格等于）而非 == 0，避免字符串 "0" 等意外匹配；
- 建议对 $value 执行 htmlspecialchars() 防止 XSS（尤其当数据来自用户输入时）；
- 此方案保持“标题在循环内”的形式，适合极简模板场景，但可读性略弱。
✅ 方法二：分离逻辑 —— 更推荐的专业写法
真正符合 PHP 最佳实践的方式，是将标题与数据渲染职责解耦：先单独输出标题（可加空数组保护），再用独立 foreach 渲染全部内容：
<?php
$colors = ["red", "green", "blue", "yellow"];
if (!empty($colors)) {
echo "<p>TITLE</p>";
foreach ($colors as $value) {
echo htmlspecialchars($value) . "<br>";
}
}
?>✅ 优势显著：
- 语义清晰：标题 ≠ 数据项，逻辑归属明确；
- 健壮性强：!empty() 同时检查数组存在性与非空，比 count() > 0 更高效且安全；
- 易于维护：后续若需添加副标题、分隔线或样式容器，只需修改外层结构，不影响循环体；
- 符合 PSR-12 等编码规范：避免在循环中混杂控制流逻辑。
? 总结建议
虽然技术上可通过 $key === 0 在循环内实现“一次标题”，但结构分离才是更专业、可扩展、易测试的解决方案。除非受限于极其特殊的模板引擎约束（如无法修改循环外区域），否则应优先采用方法二。简洁不等于简陋——清晰的职责划分，才是高质量 PHP 代码的基石。
