本文介绍一种轻量、高效的方法，通过全局变量在 woocommerce 商品循环中实现“随机但不相邻重复”的内容轮播逻辑，避免同一 banner 连续出现，同时无需数据库查询或会话依赖。
本文介绍一种轻量、高效的方法，通过全局变量在 woocommerce 商品循环中实现“随机但不相邻重复”的内容轮播逻辑，避免同一 banner 连续出现，同时无需数据库查询或会话依赖。
在 WooCommerce 的商品列表页（Shop Loop）中，有时需要周期性插入动态内容（如推广 Banner），并希望每次插入的内容是随机的，但绝不允许相同内容连续出现两次——例如：Banner-001 → Banner-003 → Banner-001 是允许的，而 Banner-002 → Banner-002 则必须规避。
原代码使用 array_rand() 每次独立随机选取，无法记忆上一次结果，因此无法满足“非连续重复”这一关键约束。解决方案的核心在于：引入状态记忆机制，在单次页面请求生命周期内维持“上一个索引”或“当前轮播位置”。
以下是一种推荐实现方式：利用 PHP 全局变量（$GLOBALS）构建轻量级轮播队列，既避免数据库/缓存开销，又保证逻辑清晰、线程安全（单请求内无并发冲突）：
/**
* 返回一个不与前一次重复的随机 Banner（单次请求内轮询式去重）
*/
function wc_random_non_adjacent_banner() {
// 定义 Banner 内容数组（支持任意数量）
$banners = [
'<img src="/wp-content/uploads/2022/01/banner-001.svg" alt="Promo 1">',
'<img src="/wp-content/uploads/2022/01/banner-002.svg" alt="Promo 2">',
'<img src="/wp-content/uploads/2022/01/banner-003.svg" alt="Promo 3">',
'<img src="/wp-content/uploads/2022/01/banner-004.svg" alt="Promo 4">',
];
// 初始化：首次调用时打乱数组并重置计数器
if (!isset($GLOBALS['wc_banner_cycle']) || !isset($GLOBALS['wc_banner_index'])) {
shuffle($banners);
$GLOBALS['wc_banner_cycle'] = $banners;
$GLOBALS['wc_banner_index'] = 0;
} else {
// 移动到下一个索引（循环取模，确保不越界）
$GLOBALS['wc_banner_index'] = ($GLOBALS['wc_banner_index'] + 1) % count($banners);
}
// 返回当前索引对应的 Banner
return $GLOBALS['wc_banner_cycle'][$GLOBALS['wc_banner_index']];
}
/**
* 在 Shop Loop 中按规则插入 Banner（每第 7 个商品后插入）
*/
function add_banner_to_shop_loop() {
global $wp_query;
// 注意：current_post 从 0 开始计数；% 7 == 0 表示第 1、8、15... 个商品位置（即每 7 个一循环）
// 此处逻辑为：在第 7、14、21... 个商品（即索引 6、13、20...）之后插入 Banner
if ($wp_query->current_post > 0 && ($wp_query->current_post + 1) % 7 === 0) {
echo wc_random_non_adjacent_banner() . "\n";
}
}
add_action('woocommerce_shop_loop', 'add_banner_to_shop_loop');✅ 优势说明：
- 零数据库压力：全程使用内存变量，适合高并发场景；
- 天然去重：通过 shuffle() + 索引递增，确保相邻调用必为不同元素；
- 可扩展性强：增加 Banner 只需修改 $banners 数组，无需调整逻辑；
- 语义清晰：wc_random_non_adjacent_banner() 函数名直指核心需求，便于团队维护。
⚠️ 注意事项：
- 此方案适用于单次 HTTP 请求内的循环展示（如整个 Shop 页面加载），不跨页面持久化；若需用户级长期记忆（如“该用户本次浏览不重复”），应改用 $_SESSION 或 wp_cache_set() 配合唯一键；
- current_post 是循环内相对索引，请确认你的插入节奏是否符合预期（例如 % 7 == 0 实际对应第 1、8、15... 个商品；若需严格“每 7 个产品后插入”，建议用 ($wp_query->current_post + 1) % 7 === 0 更直观）；
- 图片路径建议使用 wp_get_attachment_image_src() 或 get_theme_file_uri() 替代硬编码 URL，提升主题兼容性与 CDN 友好性。
总结：通过全局变量构建伪随机轮播队列，是解决 WooCommerce Shop Loop 中“非连续随机”需求的简洁、健壮且高性能方案。它平衡了随机性、确定性与性能，是模板级动态内容管理的实用范式。
