From 76303d3a3bb0b107cb70ddcf9d002997f3497b4b Mon Sep 17 00:00:00 2001
From: Dekart Deploy Bot <deploy@dekart.school>
Date: Fri, 17 Jul 2026 16:09:56 +0000
Subject: [PATCH] feat: add MU-plugin for cache backend auto-detection +
 versioned cache invalidation

- Auto-detects Memcached/Redis via fsockopen
- Versioned cache key helper (my_cache_key)
- Auto-flush on option/post/CF changes (no manual wp cache flush)
- WP-CLI command: wp dekart cache-flush
- Admin bar shows backend + cache version
---
 .../mu-plugins/object-cache-bootstrap.php     | 173 ++++++++++++++++--
 1 file changed, 158 insertions(+), 15 deletions(-)

diff --git a/wp-content/mu-plugins/object-cache-bootstrap.php b/wp-content/mu-plugins/object-cache-bootstrap.php
index faddc58..e22f05b 100644
--- a/wp-content/mu-plugins/object-cache-bootstrap.php
+++ b/wp-content/mu-plugins/object-cache-bootstrap.php
@@ -1,21 +1,164 @@
 <?php
-if ( ! defined( 'WP_REDIS_HOST' ) ) {
-	define(
-		'WP_REDIS_HOST',
-		getenv( 'WP_REDIS_HOST' ) ?: '127.0.0.1'
-	);
+/**
+ * MU-Plugin: Object Cache Bootstrap
+ *
+ * Автоопределение backend кеширования + versioned cache + автоинвалидация.
+ * Dev → Redis (через redis-cache plugin + Predis).
+ * Prod → Memcached (через Memcached Object Cache plugin, устанавливается вручную).
+ *
+ * @package Dekart
+ */
+
+// ============================================================
+// 1. АВТООПРЕДЕЛЕНИЕ BACKEND
+// ============================================================
+
+/**
+ * Определить доступный backend для object cache.
+ *
+ * @return string 'memcached' | 'redis' | 'none'
+ */
+function dekart_detect_cache_backend(): string {
+	// 1. Приоритет: Memcached (проверка порта)
+	$memcached_sock = @fsockopen( '127.0.0.1', 11211, $errno, $errstr, 0.5 );
+	if ( $memcached_sock ) {
+		fclose( $memcached_sock );
+		return 'memcached';
+	}
+
+	// 2. Redis: проверяем через Predis (установлен composer)
+	if ( class_exists( 'Predis\Client' ) ) {
+		$redis_sock = @fsockopen( '127.0.0.1', 6379, $errno, $errstr, 0.5 );
+		if ( $redis_sock ) {
+			fclose( $redis_sock );
+			return 'redis';
+		}
+	}
+
+	// 3. Ничего не доступно
+	return 'none';
 }
 
-if ( ! defined( 'WP_REDIS_PORT' ) ) {
-	define(
-		'WP_REDIS_PORT',
-		( int ) ( getenv( 'WP_REDIS_PORT' ) ?: 6379 )
-	);
+// ============================================================
+// 2. КОНСТАНТЫ ДЛЯ ПЛАГИНОВ
+// ============================================================
+
+$backend = dekart_detect_cache_backend();
+
+// Redis: define константы для redis-cache plugin
+if ( 'redis' === $backend ) {
+	if ( ! defined( 'WP_REDIS_HOST' ) ) {
+		define( 'WP_REDIS_HOST', '127.0.0.1' );
+	}
+	if ( ! defined( 'WP_REDIS_PORT' ) ) {
+		define( 'WP_REDIS_PORT', 6379 );
+	}
+	if ( ! defined( 'WP_REDIS_DATABASE' ) ) {
+		define( 'WP_REDIS_DATABASE', 0 );
+	}
 }
 
-if ( ! defined( 'WP_REDIS_DATABASE' ) ) {
-	define(
-		'WP_REDIS_DATABASE',
-		( int ) ( getenv( 'WP_REDIS_DATABASE' ) ?: 0 )
-	);
+// ============================================================
+// 3. ЛОГИРОВАНИЕ (dev only)
+// ============================================================
+
+if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+	error_log( '[Object Cache] Backend detected: ' . $backend );
+	if ( 'none' === $backend ) {
+		error_log( '[Object Cache] WARNING: No cache backend available. Site will run without object cache.' );
+	}
+}
+
+// ============================================================
+// 4. VERSIONED CACHE KEY
+// ============================================================
+
+/**
+ * Получить текущую версию кеша.
+ */
+function my_cache_version(): int {
+	return (int) get_option( 'my_cache_version', 1 );
+}
+
+/**
+ * Обернуть ключ кеша с версией.
+ * Позволяет инвалидировать весь кеш без flush — достаточно изменить версию.
+ *
+ * @param string $key Исходный ключ.
+ * @return string Ключ с префиксом версии.
+ */
+function my_cache_key( string $key ): string {
+	return 'v:' . my_cache_version() . ':' . $key;
+}
+
+// ============================================================
+// 5. ИНВАЛИДАЦИЯ КЕША
+// ============================================================
+
+/**
+ * Увеличить версию кеша + сбросить object cache.
+ * Все кешированные данные сбрасываются — при следующем запросе читаются свежие.
+ */
+function my_cache_bump_version(): void {
+	// Сбрасываем object cache (Redis / Memcached)
+	wp_cache_flush();
+
+	// Обновляем версию для my_cache_key()
+	$v = my_cache_version();
+	update_option( 'my_cache_version', $v + 1, false );
+
+	if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
+		error_log( sprintf( '[Object Cache] Flushed + version bumped: %d → %d', $v, $v + 1 ) );
+	}
+}
+
+// ============================================================
+// 6. ХУКИ АВТОИНВАЛИДАЦИИ
+// ============================================================
+
+// Опции: при любом изменении сбрасываем версию
+add_action( 'update_option', 'my_cache_bump_version' );
+add_action( 'added_option', 'my_cache_bump_version' );
+add_action( 'deleted_option', 'my_cache_bump_version' );
+
+// Посты: при сохранении (включая ACF, Carbon Fields)
+add_action( 'save_post', 'my_cache_bump_version' );
+
+// Carbon Fields: сохранение мета-боксов
+add_action( 'carbon_fields_post_meta_container_saved', 'my_cache_bump_version' );
+
+// ============================================================
+// 7. ХЕЛПЕР: ПРОМЫВКА КЕША ИЗ АДМИНКИ
+// ============================================================
+
+/**
+ * Добавить кнопку "Сбросить кеш" в админ-бар (только для админов).
+ */
+add_action( 'admin_bar_menu', function ( WP_Admin_Bar $wp_admin_bar ) {
+	if ( ! current_user_can( 'manage_options' ) ) {
+		return;
+	}
+
+	// Показываем текущий backend
+	$backend_label = 'none' === $backend ? 'no-cache' : $backend;
+	$wp_admin_bar->add_node( array(
+		'id'    => 'dekart-cache-status',
+		'title' => sprintf(
+			'<span style="font-size:12px;opacity:0.7">Cache: %s | v%s</span>',
+			$backend_label,
+			my_cache_version()
+		),
+		'href'  => '#',
+	) );
+}, 100 );
+
+// ============================================================
+// 8. WP-CLI: командa для сброса версии
+// ============================================================
+
+if ( defined( 'WP_CLI' ) && WP_CLI ) {
+	WP_CLI::add_command( 'dekart cache-flush', function () {
+		my_cache_bump_version();
+		WP_CLI::success( 'Cache version bumped. All versioned cache keys are invalidated.' );
+	} );
 }