ACF自定义多字段类型开发报错：无法通过数组形式调用字段name/value

报错原因 #

你代码里的$field['name']['youtube-id']写法错误——ACF的$field['name']是字符串类型（比如field_123456），不是数组，直接用数组下标访问必然触发“试图获取非数组的属性”的错误，这就是你看到的报错根源。

正确的实现方式 #

1. 修正输入框的name和value属性

要让ACF把多个输入值合并成一个数组存储，需要把输入框的name设置为原字段名+数组后缀的格式，同时处理value的默认值判断：

<!-- YouTube ID 输入框 -->
<input type="text"
  name="<?php echo esc_attr( $field['name'] . '[youtube-id]' ); ?>"
  value="<?php echo esc_attr( isset( $field['value']['youtube-id'] ) ? $field['value']['youtube-id'] : '' ); ?>"
/>

<!-- 标题输入框 -->
<input type="text"
  name="<?php echo esc_attr( $field['name'] . '[youtube-title]' ); ?>"
  value="<?php echo esc_attr( isset( $field['value']['youtube-title'] ) ? $field['value']['youtube-title'] : '' ); ?>"
/>

<!-- 其他字段同理，替换对应的数组键名即可 -->

2. 确保字段值正确保存

在你的自定义字段类的update_value方法中，要确保返回数组格式的值（ACF会自动处理存储）：

function update_value( $value, $post_id, $field ) {
    // 可对提交的数组值做验证、过滤处理，比如移除空值
    $value = array_filter( $value );
    return $value;
}

3. 初始化字段默认值

如果需要在字段首次使用时设置默认数组，可在load_field方法中处理：

function load_field( $field ) {
    // 如果value为空，初始化空数组
    if ( empty( $field['value'] ) ) {
        $field['value'] = array(
            'youtube-id' => '',
            'youtube-title' => '',
            'youtube-description' => '',
            // 其他字段的默认值
        );
    }
    return $field;
}

关键说明 #

• ACF自定义多输入字段的核心逻辑是：通过name="字段名[键名]"的格式，让表单提交时自动把值打包成数组，ACF会将这个数组作为整个字段的value存储。
• 必须做isset()判断，避免字段首次加载或未提交值时出现“未定义索引”的警告。

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