本文介绍一种轻量级、无数据库查询的 php 方案，利用全局变量维护已用索引状态，确保 woocommerce 商品列表中每隔 7 个商品插入的随机 banner 图片不会连续重复出现，同时支持循环复用——即同一图片可多次出现，但绝不相邻。
本文介绍一种轻量级、无数据库查询的 php 方案，利用全局变量维护已用索引状态，确保 woocommerce 商品列表中每隔 7 个商品插入的随机 banner 图片不会连续重复出现，同时支持循环复用——即同一图片可多次出现，但绝不相邻。
在 WooCommerce 的 woocommerce_shop_loop 钩子中实现「非相邻重复」的随机内容（如 Banner 图片）展示，关键在于打破每次独立调用 array_rand() 带来的完全无状态随机性。原代码中每次触发都重新随机选取，无法避免连续两次选中同一数组项；而理想行为是：本次选中索引 i 后，下一次在该上下文中应从剩余 n−1 个索引中随机选择，形成类似「洗牌后顺序遍历」的效果。
以下方案采用全局变量 + 洗牌预加载 + 索引轮进策略，兼顾性能与逻辑正确性：
✅ 核心思路
- 一次性洗牌：首次调用时对 $input 数组执行 shuffle()，生成一个伪随机但固定的排列；
- 顺序轮进：通过全局计数器 $GLOBALS['counter'] 按序取值，保证相邻调用绝不会重复；
- 自动重置：当轮进至末尾（即 counter == count($input) - 1）时清除计数器，下次触发将重新洗牌，实现长期多样性。
✅ 完整实现代码
// 定义随机不相邻输出函数
function random_non_adjacent_banner() {
$input = array(
'<img src="/wp-content/uploads/2022/01/banner-001.svg">',
'<img src="/wp-content/uploads/2022/01/banner-002.svg">',
'<img src="/wp-content/uploads/2022/01/banner-003.svg">'
);
// 首次初始化：洗牌并设置起始计数器
if ( ! isset( $GLOBALS['banner_sequence'] ) || ! isset( $GLOBALS['banner_counter'] ) ) {
$shuffled = $input;
shuffle( $shuffled );
$GLOBALS['banner_sequence'] = $shuffled;
$GLOBALS['banner_counter'] = 0;
} else {
$GLOBALS['banner_counter']++;
}
$counter = $GLOBALS['banner_counter'];
$sequence = $GLOBALS['banner_sequence'];
$count = count( $sequence );
// 到达末尾时重置（下一次调用将重新洗牌）
if ( $counter >= $count - 1 ) {
unset( $GLOBALS['banner_counter'] );
}
return $sequence[ $counter ];
}
// 注册到 WooCommerce 商品循环钩子
function add_banner_every_seventh_product() {
global $wp_query;
// 每隔 7 个商品（即第 7、14、21... 个位置）插入 Banner
if ( $wp_query->current_post > 0 && $wp_query->current_post % 7 === 0 ) {
echo random_non_adjacent_banner() . "\n";
}
}
add_action( 'woocommerce_shop_loop', 'add_banner_every_seventh_product' );
⚠️ 注意事项与优化建议
- 作用域安全：该方案依赖 PHP 全局变量，在单次 HTTP 请求生命周期内有效，完全避免数据库/Session/Cookie 开销，适合高并发场景；
- 多列布局兼容性：$wp_query->current_post 基于循环总序号，不受 columns 设置影响，可稳定按产品流位置触发；
- 扩展性提示：若需跨页面保持“不相邻”状态（如分页间连续），则必须改用 transient 或用户元数据存储上一次索引，但会增加 I/O 成本；
- 健壮性增强：可在 random_non_adjacent_banner() 中加入 empty($input) 判断，并对单元素数组做特殊处理（此时无法避免“相邻”，应直接返回唯一项）。
此方法简洁、高效、可维护，完美契合 WooCommerce 主题开发中对轻量级动态内容编排的实际需求。
