本文介绍如何在 WordPress 批量导入逻辑中，准确判断 foreach 循环遍历全部数据后未执行任何插入操作，并仅显示一次“无数据导入”提示，避免重复输出或逻辑误判。
本文介绍如何在 wordpress 批量导入逻辑中，准确判断 `foreach` 循环遍历全部数据后未执行任何插入操作，并仅显示一次“无数据导入”提示，避免重复输出或逻辑误判。
在 WordPress 自定义数据同步或 API 导入场景中，常通过 foreach 遍历远程文章列表（如 $posts），结合 post_exists() 检查本地是否已存在同名文章，仅对不存在的条目调用 wp_insert_post() 执行导入。但一个常见痛点是：当整批 50 条（或任意数量）记录均已在库中存在时，循环全程不触发任何插入，开发者却无法感知该“静默跳过”状态——若直接在循环内判断 if (!$current_post_id) 并 echo，会导致提示重复输出 50 次；而错误地将 $my_post 声明为数组或在循环外初始化插入结构，则会破坏 wp_insert_post() 的单次调用契约，导致插入失败或数据错乱。
正确解法是引入作用域可控的计数器变量，在循环前初始化，在每次成功导入时递增，循环结束后统一校验其值。这是一种轻量、可靠且符合 PHP 最佳实践的状态跟踪方式。
以下是优化后的完整代码示例：
<?php
echo "Page: " . $page_placement . "/" . $total_pages . "\n\n";
// 初始化导入计数器
$imported = 0;
foreach ($posts as $post) {
// 检查标题是否已存在（忽略内容等其他字段）
$current_post_id = post_exists(
$post->title->rendered,
'',
'',
'',
''
);
if ($current_post_id === 0) {
// 构建新文章数组（注意：每次循环独立创建，非复用/追加）
$my_post = [
'post_type' => 'post',
'post_status' => 'pending',
'post_title' => wp_strip_all_tags($post->title->rendered),
'post_content' => wp_strip_all_tags($post->content->rendered),
'post_excerpt' => wp_strip_all_tags($post->excerpt->rendered),
'post_author' => 1,
'post_date' => $post->date,
];
// 执行插入
$post_id = wp_insert_post($my_post);
if ($post_id > 0) {
// 关联分类与标签（需确保 taxonomy 已注册）
wp_set_object_terms($post_id, 'Global', 'category');
wp_set_object_terms($post_id, 'Global', 'post_tag');
echo "ID: " . $post->id . " - Title: " . $post->title->rendered . " has been imported.\n";
$imported++; // ✅ 仅在此处递增
} else {
error_log("Failed to insert post: " . $post->title->rendered);
}
}
}
// 循环结束后统一判断：0 表示全跳过，无新增
if ($imported === 0) {
echo "No records were imported — all posts already exist in the database.\n";
}✅ 关键要点说明：
- 计数器必须在 foreach 外声明（如 $imported = 0;），确保其生命周期覆盖整个循环及后续判断；
- 仅在 wp_insert_post() 成功后递增（建议配合返回值检查，如 $post_id > 0），避免因插入失败仍计数导致误判；
- 切勿在循环内拼接或重用 $my_post 数组——每次导入需全新构造，否则可能因引用传递或键冲突引发不可预期行为；
- 提示语应具备业务含义，例如明确指出“all posts already exist”，便于运维快速定位原因，而非简单输出“No record imported”。
此模式不仅适用于 WordPress 导入，也广泛适配于各类需要“批量处理 + 空结果反馈”的 PHP 场景，如 API 数据拉取、定时任务日志汇总、条件过滤后的动作兜底等。掌握该模式，可显著提升脚本的可观测性与健壮性。
