wpbridge/includes/Core/DefaultsManager.php

<?php
/**
 * 默认规则管理
 *
 * 方案 B：项目优先架构 - 默认规则层
 *
 * @package WPBridge
 * @since 0.6.0
 */

namespace WPBridge\Core;

// 防止直接访问
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * 默认规则管理类
 *
 * 管理全局和类型级别的默认更新源配置
 */
class DefaultsManager {

	/**
	 * 选项名称
	 */
	const OPTION_NAME = 'wpbridge_defaults';

	/**
	 * 作用范围
	 */
	const SCOPE_GLOBAL = 'global';
	const SCOPE_PLUGIN = 'plugin';
	const SCOPE_THEME  = 'theme';
	const SCOPE_CORE   = 'core';

	/**
	 * 缓存的默认规则
	 *
	 * @var array|null
	 */
	private ?array $cached_defaults = null;

	/**
	 * 获取所有默认规则
	 *
	 * @return array
	 */
	public function get_all(): array {
		if ( null === $this->cached_defaults ) {
			$this->cached_defaults = get_option( self::OPTION_NAME, [] );
			$this->ensure_defaults();
		}
		return $this->cached_defaults;
	}

	/**
	 * 获取指定范围的默认规则
	 *
	 * @param string $scope 作用范围
	 * @return array
	 */
	public function get( string $scope ): array {
		$defaults = $this->get_all();
		return $defaults[ $scope ] ?? $this->get_scope_defaults( $scope );
	}

	/**
	 * 设置指定范围的默认规则
	 *
	 * @param string $scope 作用范围
	 * @param array  $rules 规则数据
	 * @return bool
	 */
	public function set( string $scope, array $rules ): bool {
		$defaults                         = $this->get_all();
		$defaults[ $scope ]               = array_merge(
			$this->get_scope_defaults( $scope ),
			$rules
		);
		$defaults[ $scope ]['updated_at'] = current_time( 'mysql' );

		$this->cached_defaults = $defaults;
		return update_option( self::OPTION_NAME, $defaults, false );
	}

	/**
	 * 获取默认源顺序
	 *
	 * @param string $scope 作用范围
	 * @return array 源键列表（按优先级排序）
	 */
	public function get_source_order( string $scope ): array {
		$rules = $this->get( $scope );
		return $rules['source_order'] ?? [ 'wenpai-mirror', 'wporg' ];
	}

	/**
	 * 设置默认源顺序
	 *
	 * @param string $scope        作用范围
	 * @param array  $source_order 源键列表
	 * @return bool
	 */
	public function set_source_order( string $scope, array $source_order ): bool {
		return $this->set( $scope, [ 'source_order' => $source_order ] );
	}

	/**
	 * 获取默认更新源列表
	 *
	 * @param string         $scope           作用范围
	 * @param SourceRegistry $source_registry 源注册表
	 * @return array 源列表（按优先级排序）
	 */
	public function get_default_sources( string $scope, SourceRegistry $source_registry ): array {
		$source_order = $this->get_source_order( $scope );
		$sources      = [];
		$priority     = 100;

		foreach ( $source_order as $source_key ) {
			$source = $source_registry->get( $source_key );
			if ( $source && ! empty( $source['enabled'] ) ) {
				$source['priority'] = $priority;
				$sources[]          = $source;
				$priority          -= 10;
			}
		}

		// 如果没有配置的源可用，回退到 WordPress.org
		if ( empty( $sources ) ) {
			$rules = $this->get( $scope );
			if ( ! empty( $rules['fallback_to_wporg'] ) ) {
				$wporg = $source_registry->get( 'wporg' );
				if ( $wporg && ! empty( $wporg['enabled'] ) ) {
					$wporg['priority'] = 1;
					$sources[]         = $wporg;
				}
			}
		}

		return $sources;
	}

	/**
	 * 是否需要签名验证
	 *
	 * @param string $scope 作用范围
	 * @return bool
	 */
	public function is_signature_required( string $scope ): bool {
		$rules = $this->get( $scope );
		return ! empty( $rules['signature_required'] );
	}

	/**
	 * 是否允许无签名包
	 *
	 * @param string $scope 作用范围
	 * @return bool
	 */
	public function is_unsigned_allowed( string $scope ): bool {
		$rules = $this->get( $scope );
		return ! empty( $rules['allow_unsigned'] );
	}

	/**
	 * 是否允许预发布版本
	 *
	 * @param string $scope 作用范围
	 * @return bool
	 */
	public function is_prerelease_allowed( string $scope ): bool {
		$rules = $this->get( $scope );
		return ! empty( $rules['allow_prerelease'] );
	}

	/**
	 * 获取最低信任阈值
	 *
	 * @param string $scope 作用范围
	 * @return int
	 */
	public function get_trust_floor( string $scope ): int {
		$rules = $this->get( $scope );
		return (int) ( $rules['trust_floor'] ?? 0 );
	}

	/**
	 * 确保默认规则存在
	 */
	private function ensure_defaults(): void {
		$needs_update = false;
		$scopes       = [ self::SCOPE_GLOBAL, self::SCOPE_PLUGIN, self::SCOPE_THEME, self::SCOPE_CORE ];

		foreach ( $scopes as $scope ) {
			if ( ! isset( $this->cached_defaults[ $scope ] ) ) {
				$this->cached_defaults[ $scope ] = $this->get_scope_defaults( $scope );
				$needs_update                    = true;
			}
		}

		if ( $needs_update ) {
			update_option( self::OPTION_NAME, $this->cached_defaults, false );
		}
	}

	/**
	 * 获取范围的默认值
	 *
	 * @param string $scope 作用范围
	 * @return array
	 */
	private function get_scope_defaults( string $scope ): array {
		$base = [
			'source_order'       => [ 'wenpai-mirror', 'wporg' ],
			'signature_required' => false,
			'allow_unsigned'     => true,
			'allow_prerelease'   => false,
			'trust_floor'        => 0,
			'fallback_to_wporg'  => true,
			'policy'             => [],
			'updated_at'         => current_time( 'mysql' ),
		];

		// 根据范围调整默认值
		switch ( $scope ) {
			case self::SCOPE_CORE:
				$base['source_order'] = [ 'wporg' ];
				$base['trust_floor']  = 90;
				break;

			case self::SCOPE_PLUGIN:
			case self::SCOPE_THEME:
				$base['source_order'] = [ 'wenpai-mirror', 'wporg' ];
				break;

			case self::SCOPE_GLOBAL:
			default:
				break;
		}

		return $base;
	}

	/**
	 * 重置为默认值
	 *
	 * @param string|null $scope 作用范围，null 表示全部重置
	 * @return bool
	 */
	public function reset( ?string $scope = null ): bool {
		if ( null === $scope ) {
			$this->cached_defaults = null;
			return delete_option( self::OPTION_NAME );
		}

		$defaults              = $this->get_all();
		$defaults[ $scope ]    = $this->get_scope_defaults( $scope );
		$this->cached_defaults = $defaults;
		return update_option( self::OPTION_NAME, $defaults, false );
	}

	/**
	 * 清除缓存
	 */
	public function clear_cache(): void {
		$this->cached_defaults = null;
	}
}