wpbridge/includes/Core/SiteHealth.php

<?php
/**
 * WordPress Site Health 集成
 *
 * @package WPBridge
 */

namespace WPBridge\Core;

use WPBridge\Cache\HealthChecker;

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

/**
 * Site Health 集成类
 */
class SiteHealth {

	/**
	 * 设置实例
	 *
	 * @var Settings
	 */
	private Settings $settings;

	/**
	 * 构造函数
	 *
	 * @param Settings $settings 设置实例
	 */
	public function __construct( Settings $settings ) {
		$this->settings = $settings;
		$this->init_hooks();
	}

	/**
	 * 初始化钩子
	 */
	private function init_hooks(): void {
		// 添加健康检查测试
		add_filter( 'site_status_tests', [ $this, 'add_tests' ] );

		// 添加调试信息
		add_filter( 'debug_information', [ $this, 'add_debug_info' ] );
	}

	/**
	 * 添加健康检查测试
	 *
	 * @param array $tests 测试列表
	 * @return array
	 */
	public function add_tests( array $tests ): array {
		$tests['direct']['wpbridge_sources'] = [
			'label' => __( 'WPBridge 更新源状态', 'wpbridge' ),
			'test'  => [ $this, 'test_sources' ],
		];

		$tests['direct']['wpbridge_config'] = [
			'label' => __( 'WPBridge 配置检查', 'wpbridge' ),
			'test'  => [ $this, 'test_config' ],
		];

		return $tests;
	}

	/**
	 * 测试更新源状态
	 *
	 * @return array
	 */
	public function test_sources(): array {
		$sources        = $this->settings->get_enabled_sources();
		$health_checker = new HealthChecker();

		$healthy        = 0;
		$degraded       = 0;
		$failed         = 0;
		$failed_sources = [];

		foreach ( $sources as $source ) {
			$status = $health_checker->check( $source );

			if ( $status->status === 'healthy' ) {
				++$healthy;
			} elseif ( $status->status === 'degraded' ) {
				++$degraded;
			} else {
				++$failed;
				$failed_sources[] = $source->name;
			}
		}

		$total = count( $sources );

		if ( $total === 0 ) {
			return [
				'label'       => __( 'WPBridge: 未配置更新源', 'wpbridge' ),
				'status'      => 'recommended',
				'badge'       => [
					'label' => __( '推荐', 'wpbridge' ),
					'color' => 'orange',
				],
				'description' => sprintf(
					'<p>%s</p>',
					__( '您尚未配置任何自定义更新源。如果您需要使用自定义更新源，请在 WPBridge 设置中添加。', 'wpbridge' )
				),
				'actions'     => sprintf(
					'<a href="%s">%s</a>',
					admin_url( 'admin.php?page=wpbridge' ),
					__( '配置更新源', 'wpbridge' )
				),
				'test'        => 'wpbridge_sources',
			];
		}

		if ( $failed > 0 ) {
			return [
				'label'       => sprintf(
					__( 'WPBridge: %d 个更新源不可用', 'wpbridge' ),
					$failed
				),
				'status'      => 'critical',
				'badge'       => [
					'label' => __( '错误', 'wpbridge' ),
					'color' => 'red',
				],
				'description' => sprintf(
					'<p>%s</p><p>%s: %s</p>',
					__( '部分更新源无法连接，这可能导致插件/主题无法正常更新。', 'wpbridge' ),
					__( '不可用的更新源', 'wpbridge' ),
					implode( ', ', $failed_sources )
				),
				'actions'     => sprintf(
					'<a href="%s">%s</a>',
					admin_url( 'admin.php?page=wpbridge&tab=diagnostics' ),
					__( '查看诊断', 'wpbridge' )
				),
				'test'        => 'wpbridge_sources',
			];
		}

		if ( $degraded > 0 ) {
			return [
				'label'       => sprintf(
					__( 'WPBridge: %d 个更新源响应较慢', 'wpbridge' ),
					$degraded
				),
				'status'      => 'recommended',
				'badge'       => [
					'label' => __( '警告', 'wpbridge' ),
					'color' => 'orange',
				],
				'description' => sprintf(
					'<p>%s</p>',
					__( '部分更新源响应时间较长，可能影响更新检查速度。', 'wpbridge' )
				),
				'actions'     => sprintf(
					'<a href="%s">%s</a>',
					admin_url( 'admin.php?page=wpbridge&tab=diagnostics' ),
					__( '查看诊断', 'wpbridge' )
				),
				'test'        => 'wpbridge_sources',
			];
		}

		return [
			'label'       => sprintf(
				__( 'WPBridge: 所有 %d 个更新源正常', 'wpbridge' ),
				$healthy
			),
			'status'      => 'good',
			'badge'       => [
				'label' => __( '正常', 'wpbridge' ),
				'color' => 'green',
			],
			'description' => sprintf(
				'<p>%s</p>',
				__( '所有配置的更新源都可以正常连接。', 'wpbridge' )
			),
			'test'        => 'wpbridge_sources',
		];
	}

	/**
	 * 测试配置
	 *
	 * @return array
	 */
	public function test_config(): array {
		$issues = [];

		// 检查调试模式
		if ( $this->settings->is_debug() ) {
			$issues[] = __( '调试模式已启用，建议在生产环境中关闭', 'wpbridge' );
		}

		// 检查缓存时间
		$cache_ttl = $this->settings->get_cache_ttl();
		if ( $cache_ttl < 3600 ) {
			$issues[] = __( '缓存时间设置过短，可能导致频繁请求', 'wpbridge' );
		}

		// 检查备份功能
		if ( ! $this->settings->get( 'backup_enabled', true ) ) {
			$issues[] = __( '更新前备份已禁用，建议启用以便回滚', 'wpbridge' );
		}

		// 检查 ZipArchive
		if ( ! class_exists( 'ZipArchive' ) ) {
			$issues[] = __( 'PHP ZipArchive 扩展未安装，备份功能将不可用', 'wpbridge' );
		}

		if ( ! empty( $issues ) ) {
			return [
				'label'       => __( 'WPBridge: 配置需要优化', 'wpbridge' ),
				'status'      => 'recommended',
				'badge'       => [
					'label' => __( '建议', 'wpbridge' ),
					'color' => 'orange',
				],
				'description' => sprintf(
					'<p>%s</p><ul><li>%s</li></ul>',
					__( '发现以下配置问题：', 'wpbridge' ),
					implode( '</li><li>', $issues )
				),
				'actions'     => sprintf(
					'<a href="%s">%s</a>',
					admin_url( 'admin.php?page=wpbridge&tab=settings' ),
					__( '调整设置', 'wpbridge' )
				),
				'test'        => 'wpbridge_config',
			];
		}

		return [
			'label'       => __( 'WPBridge: 配置正常', 'wpbridge' ),
			'status'      => 'good',
			'badge'       => [
				'label' => __( '正常', 'wpbridge' ),
				'color' => 'green',
			],
			'description' => sprintf(
				'<p>%s</p>',
				__( 'WPBridge 配置正确，所有功能正常运行。', 'wpbridge' )
			),
			'test'        => 'wpbridge_config',
		];
	}

	/**
	 * 添加调试信息
	 *
	 * @param array $info 调试信息
	 * @return array
	 */
	public function add_debug_info( array $info ): array {
		$sources         = $this->settings->get_sources();
		$enabled_sources = $this->settings->get_enabled_sources();
		$version_lock    = VersionLock::get_instance();
		$backup_manager  = BackupManager::get_instance();

		$info['wpbridge'] = [
			'label'  => 'WPBridge',
			'fields' => [
				'version'         => [
					'label' => __( '版本', 'wpbridge' ),
					'value' => WPBRIDGE_VERSION,
				],
				'total_sources'   => [
					'label' => __( '总更新源数', 'wpbridge' ),
					'value' => count( $sources ),
				],
				'enabled_sources' => [
					'label' => __( '已启用更新源', 'wpbridge' ),
					'value' => count( $enabled_sources ),
				],
				'locked_items'    => [
					'label' => __( '已锁定项目数', 'wpbridge' ),
					'value' => count( $version_lock->get_all() ),
				],
				'backup_size'     => [
					'label' => __( '备份总大小', 'wpbridge' ),
					'value' => size_format( $backup_manager->get_total_size() ),
				],
				'debug_mode'      => [
					'label' => __( '调试模式', 'wpbridge' ),
					'value' => $this->settings->is_debug() ? __( '已启用', 'wpbridge' ) : __( '已禁用', 'wpbridge' ),
				],
				'cache_ttl'       => [
					'label' => __( '缓存时间', 'wpbridge' ),
					'value' => human_time_diff( 0, $this->settings->get_cache_ttl() ),
				],
				'backup_enabled'  => [
					'label' => __( '更新前备份', 'wpbridge' ),
					'value' => $this->settings->get( 'backup_enabled', true ) ? __( '已启用', 'wpbridge' ) : __( '已禁用', 'wpbridge' ),
				],
			],
		];

		return $info;
	}
}