ACF复选框字段foreach遍历仅显示首值、返回数组输出Array的问题求助

你遇到的两个异常分别对应两个常见的ACF复选框使用误区：

• 只输出第一个选中值：ACF复选框的返回格式不是固定的二维数组结构，如果字段后台设置的返回格式是「值」或「标签」，循环拿到的每一项是纯字符串，此时代码里写$department['label']相当于对字符串做数组键取值，会触发PHP语法警告直接中断循环，最终仅输出第一个可正常解析的内容
• 直接显示“Array”字样：你编写的函数返回了数组类型的$deps，如果直接在模板中echo这个返回值，PHP无法直接把数组转为可展示的文本，就会默认输出“Array”占位字符串

场景1：直接输出带自定义span标签的选中值 #

完全兼容ACF不同返回格式设置，不会触发循环中断问题：

function ms_get_department(){
    $departments = get_field('vakgebied');
    // 提前做空值、类型校验，避免无效循环
    if(empty($departments) || !is_array($departments)){
        return '';
    }
    $output = '';
    foreach($departments as $department){
        // 兼容两种返回结构：不管是数组格式还是纯字符串格式，都能拿到正确的展示文本
        $text = is_array($department) ? $department['label'] : $department;
        // 增加esc_html做内容转义，避免XSS风险
        $output .= '<span class="department-text">' . esc_html($text) . '</span>';
    }
    echo $output;
}

场景2：拿到整理后的选中值数组做二次处理 #

函数支持自定义返回类型，调用时按需选择即可，不会直接输出原始数组：

function ms_get_department($return_type = 'string'){
    $departments = get_field('vakgebied');
    if(empty($departments) || !is_array($departments)){
        return $return_type === 'array' ? [] : '';
    }
    $deps = [];
    foreach($departments as $department){
        $text = is_array($department) ? $department['label'] : $department;
        $deps[] = esc_html($text);
    }
    // 按需返回：选array就返回整理好的数组，选string就返回逗号拼接的可直接展示文本
    if($return_type === 'array'){
        return $deps;
    }
    return implode(', ', $deps);
}

• 不要直接echo 数组类型的返回值，如果拿到数组需要自己循环遍历拼接，或者直接用函数内置的字符串返回模式
• 尽量不要在循环内直接echo内容，把所有输出拼接到统一变量中最后处理，能避免意外的输出中断问题
• 编写输出逻辑时要加上esc_html()做内容转义，避免特殊字符破坏页面结构

内容的提问来源于stack exchange，提问作者Ricardio