本文详解如何在 ACF Pro 中通过严谨的 PHP 条件判断，根据「是否接受预订」「是否接受付款」等 Yes/No 单选字段的组合状态，安全、可维护地输出对应 HTML 结构，并规避常见语法错误与逻辑陷阱。
本文详解如何在 ACF Pro 中通过严谨的 PHP 条件判断，根据「是否接受预订」「是否接受付款」等 Yes/No 单选字段的组合状态，安全、可维护地输出对应 HTML 结构，并规避常见语法错误与逻辑陷阱。
在 WordPress 主题模板中使用 ACF Pro 实现条件化内容展示时，逻辑清晰与语法严谨缺一不可。上例中，开发者试图根据 reservations（接受预订）和 payments（接受付款）两个 Radio 类型字段（值为 'yes' 或 'no'）的四种组合，分别渲染不同按钮结构。但原始代码因基础语法缺失（如 if 语句漏写右括号 )）导致 PHP 解析失败、页面崩溃——这是初学者高频踩坑点。
✅ 正确写法需同时满足三点：
- 语法完整：每个 if / elseif 后的条件表达式必须用 ) 闭合；
- 结构清晰：推荐使用替代语法（if (cond) : ... elseif (cond) : ... endif;），避免大段 {} 嵌套带来的括号匹配混乱；
- 健壮性保障：对 ACF 字段值做存在性与有效性双重校验，防止空值或意外值引发异常。
以下是优化后的完整实现（兼容 ACF Pro 6.x，推荐置于 single.php、page.php 或自定义模板文件中）：
<?php
// 获取字段值（使用 get_field 避免直接输出，便于后续逻辑处理）
$reservations = get_field('reservations');
$payments = get_field('payments');
$res_link = get_field('reservations_link');
$pay_link = get_field('payments_link');
// 安全校验：仅当两个主开关均为 'yes' 或 'no' 时才执行渲染
if (in_array($reservations, ['yes', 'no']) && in_array($payments, ['yes', 'no'])) :
?>
<div class="wp-block-column" style="padding:28px 20px 0 20px; min-height:109px">
<?php if ($reservations === 'yes' && $payments === 'yes') : ?>
<a class="button-reserve cta" href="<?php echo esc_url($pay_link); ?>"
style="text-decoration:none; margin-bottom:8px" target="_blank">Make a Payment</a>
<a class="button-reserve cta" href="<?php echo esc_url($res_link); ?>"
style="text-decoration:none" target="_blank">Reserve Your Spot</a>
<?php elseif ($reservations === 'yes' && $payments === 'no') : ?>
<a class="button-reserve cta" href="<?php echo esc_url($res_link); ?>"
style="text-decoration:none" target="_blank">Reserve Your Spot</a>
<?php elseif ($reservations === 'no' && $payments === 'yes') : ?>
<a class="button-reserve cta" href="<?php echo esc_url($pay_link); ?>"
style="text-decoration:none" target="_blank">Make a Payment</a>
<?php endif; ?>
</div>
<?php
endif;
?>? 关键注意事项：
- 永远使用 === 严格比较：避免 'yes' == 1 等隐式类型转换导致的逻辑错误；
- URL 输出务必 esc_url()：防止 XSS 漏洞，ACF 的 the_field() 不做自动转义，而 get_field() 返回原始值，需手动过滤；
- 避免重复调用 get_field()：先统一获取并赋值变量，提升性能与可读性；
- 覆盖全部有效组合：本例含 3 种显式分支，但建议明确补全 else（即 res=no && pay=no）以体现逻辑完备性，例如输出提示文案或留空 <div>；
- 调试技巧：开发阶段可临时加入 var_dump([$reservations, $payments]); die(); 快速验证字段值是否符合预期。
? 进阶建议：若组合逻辑复杂度上升（如新增第 3 个开关），可将判断逻辑封装为独立函数，或改用 switch + 多维键名（如 "{$reservations}_{$payments}"）提升可维护性。始终遵循「小步验证、逐层迭代」原则——先确保单个 if (get_field('reservations') === 'yes') 能正常工作，再叠加条件，大幅降低排错成本。
