| 1 |
<?php |
| 2 |
/** |
| 3 |
* Health — shared diagnostic checks consumed by both Onboarding's |
| 4 |
* environment surface and the Health module's dashboard panel. |
| 5 |
* |
| 6 |
* Each check returns: |
| 7 |
* [ |
| 8 |
* 'id' => 'wp_version', |
| 9 |
* 'tone' => 'ok' | 'warn' | 'fail' | 'info', |
| 10 |
* 'label' => 'WordPress 6.6', |
| 11 |
* 'detail' => 'Meets the 6.0+ minimum.', |
| 12 |
* ] |
| 13 |
* |
| 14 |
* Pure reads — never writes to disk, never makes outbound HTTP calls. |
| 15 |
* Safe to call from any request including the loading dashboard. |
| 16 |
* |
| 17 |
* @package XSpeed |
| 18 |
*/ |
| 19 |
|
| 20 |
declare(strict_types=1); |
| 21 |
|
| 22 |
namespace XSpeed; |
| 23 |
|
| 24 |
defined( 'ABSPATH' ) || exit; |
| 25 |
|
| 26 |
final class Health { |
| 27 |
|
| 28 |
public const OK = 'ok'; |
| 29 |
public const WARN = 'warn'; |
| 30 |
public const FAIL = 'fail'; |
| 31 |
public const INFO = 'info'; |
| 32 |
|
| 33 |
private const SERVER_LABELS = array( |
| 34 |
'apache' => 'Apache', |
| 35 |
'litespeed' => 'LiteSpeed', |
| 36 |
'nginx' => 'nginx', |
| 37 |
'iis' => 'IIS', |
| 38 |
'unknown' => 'Unknown', |
| 39 |
); |
| 40 |
|
| 41 |
/** |
| 42 |
* Full check list used by the Health module's dashboard panel. |
| 43 |
* |
| 44 |
* @return array<int,array{id:string,tone:string,label:string,detail:string}> |
| 45 |
*/ |
| 46 |
public static function checks(): array { |
| 47 |
global $wp_version; |
| 48 |
|
| 49 |
$server_type = Server::type(); |
| 50 |
$gzip_mode = Server::gzip_mode(); |
| 51 |
$conflicts = Server::conflicts(); |
| 52 |
$cache_dir = defined( 'XSPEED_CACHE_DIR' ) ? XSPEED_CACHE_DIR : ( WP_CONTENT_DIR . '/cache/xspeed' ); |
| 53 |
|
| 54 |
$out = array(); |
| 55 |
|
| 56 |
// WordPress version |
| 57 |
$wp_ok = version_compare( (string) $wp_version, '6.0', '>=' ); |
| 58 |
$out[] = array( |
| 59 |
'id' => 'wp_version', |
| 60 |
'tone' => $wp_ok ? self::OK : self::FAIL, |
| 61 |
'label' => sprintf( 'WordPress %s', (string) $wp_version ), |
| 62 |
'detail' => $wp_ok ? 'Meets the 6.0+ minimum.' : 'Upgrade to WordPress 6.0 or higher.', |
| 63 |
); |
| 64 |
|
| 65 |
// PHP version |
| 66 |
$php_ok = version_compare( PHP_VERSION, '7.4', '>=' ); |
| 67 |
$php_modern = version_compare( PHP_VERSION, '8.1', '>=' ); |
| 68 |
$out[] = array( |
| 69 |
'id' => 'php_version', |
| 70 |
'tone' => $php_modern ? self::OK : ( $php_ok ? self::WARN : self::FAIL ), |
| 71 |
'label' => sprintf( 'PHP %s', PHP_VERSION ), |
| 72 |
'detail' => $php_modern |
| 73 |
? 'Modern PHP — full speed.' |
| 74 |
: ( $php_ok |
| 75 |
? 'Works, but 8.1+ is recommended for best performance.' |
| 76 |
: 'Upgrade to PHP 7.4 or higher.' ), |
| 77 |
); |
| 78 |
|
| 79 |
// Server |
| 80 |
$out[] = array( |
| 81 |
'id' => 'server', |
| 82 |
'tone' => self::INFO, |
| 83 |
'label' => sprintf( 'Server: %s', self::SERVER_LABELS[ $server_type ] ?? 'Unknown' ), |
| 84 |
'detail' => 'auto' === $gzip_mode |
| 85 |
? 'GZIP can be auto-configured via .htaccess.' |
| 86 |
: 'GZIP requires a manual server-config snippet (shown in the GZIP module).', |
| 87 |
); |
| 88 |
|
| 89 |
// Cache directory writable |
| 90 |
$dir_writable = wp_mkdir_p( $cache_dir ) && wp_is_writable( $cache_dir ); |
| 91 |
$out[] = array( |
| 92 |
'id' => 'cache_dir', |
| 93 |
'tone' => $dir_writable ? self::OK : self::FAIL, |
| 94 |
'label' => 'Cache directory writable', |
| 95 |
'detail' => $dir_writable |
| 96 |
? $cache_dir |
| 97 |
: sprintf( 'Cannot write to %s. Adjust file permissions before enabling cache.', $cache_dir ), |
| 98 |
); |
| 99 |
|
| 100 |
// Drop-in installed (only when cache is enabled — otherwise N/A) |
| 101 |
$cache_enabled = (bool) Settings::get()['cache_enabled']; |
| 102 |
if ( $cache_enabled ) { |
| 103 |
$dropin_path = WP_CONTENT_DIR . '/advanced-cache.php'; |
| 104 |
$dropin_match = file_exists( $dropin_path ) && false !== strpos( (string) file_get_contents( $dropin_path ), 'xspeed' ); |
| 105 |
$out[] = array( |
| 106 |
'id' => 'dropin', |
| 107 |
'tone' => $dropin_match ? self::OK : self::FAIL, |
| 108 |
'label' => 'advanced-cache.php drop-in', |
| 109 |
'detail' => $dropin_match |
| 110 |
? 'Installed and owned by xSpeed.' |
| 111 |
: 'Drop-in missing or owned by another plugin. Toggle Enable Cache off and on to reinstall.', |
| 112 |
); |
| 113 |
} |
| 114 |
|
| 115 |
// WP_CACHE constant |
| 116 |
$wp_cache_const = defined( 'WP_CACHE' ) && WP_CACHE; |
| 117 |
if ( $cache_enabled ) { |
| 118 |
$out[] = array( |
| 119 |
'id' => 'wp_cache_constant', |
| 120 |
'tone' => $wp_cache_const ? self::OK : self::WARN, |
| 121 |
'label' => 'WP_CACHE constant', |
| 122 |
'detail' => $wp_cache_const |
| 123 |
? 'Defined and truthy in wp-config.php.' |
| 124 |
: 'Not set. Cache is configured but WordPress will not load the drop-in until WP_CACHE = true is added to wp-config.php.', |
| 125 |
); |
| 126 |
} |
| 127 |
|
| 128 |
// Static-rewrite probe. Active end-to-end check: writes a probe |
| 129 |
// file under the static-cache dir, fetches it over HTTP, and |
| 130 |
// confirms the web server (nginx OR Apache/LiteSpeed) served |
| 131 |
// the raw file. Result is throttled to a 5-minute transient |
| 132 |
// inside Cache::probe_static_rewrite so we never hit the |
| 133 |
// network per-paint. |
| 134 |
if ( $cache_enabled ) { |
| 135 |
$server_type = Server::type(); |
| 136 |
// The live loopback probe only matters where a server-level static |
| 137 |
// rewrite is actually used (nginx snippet / Apache .htaccess). |
| 138 |
// LiteSpeed serves hits via the drop-in (see below), so skip the |
| 139 |
// probe there entirely — no needless self-request. Health is the |
| 140 |
// right place to pay for the probe when we DO run it (the admin |
| 141 |
// bootstrap reads cache-only so it never blocks); the 5-minute |
| 142 |
// transient still throttles repeat runs. (FBS-82142) |
| 143 |
$probe = ( Server::LITESPEED === $server_type ) |
| 144 |
? array( 'active' => false ) |
| 145 |
: Cache::probe_static_rewrite( true ); |
| 146 |
$is_active = (bool) ( $probe['active'] ?? false ); |
| 147 |
|
| 148 |
if ( Server::NGINX === $server_type ) { |
| 149 |
$out[] = array( |
| 150 |
'id' => 'static_rewrite_nginx', |
| 151 |
'tone' => $is_active ? self::OK : self::WARN, |
| 152 |
'label' => 'Static-file rewrite (nginx server config)', |
| 153 |
'detail' => $is_active |
| 154 |
? 'nginx is serving cache hits directly — PHP bypassed (~5-15ms TTFB).' |
| 155 |
: 'nginx detected but not yet routing to the cache. Paste the snippet below into your site\'s server { } block, then reload nginx.', |
| 156 |
// Always ship the snippet — even when active, so the |
| 157 |
// admin has it handy for re-pasting after a server |
| 158 |
// rebuild without having to find it elsewhere. Mirror |
| 159 |
// the SAME unified block the "Server config" panel |
| 160 |
// renders (cache + gzip + browser-cache directives), |
| 161 |
// not the cache-only snippet — otherwise Health and |
| 162 |
// the Cache panel disagree on what to paste. |
| 163 |
'snippet' => Cache::full_nginx_server_block(), |
| 164 |
); |
| 165 |
} elseif ( Server::LITESPEED === $server_type ) { |
| 166 |
// LiteSpeed intentionally does NOT use the .htaccess static |
| 167 |
// rewrite: OpenLiteSpeed's .htaccess engine ignores |
| 168 |
// mod_headers (so we can't stamp X-XSpeed-Cache: HIT) and has |
| 169 |
// no per-rule access_log (so a static hit can't be counted). |
| 170 |
// We route LiteSpeed hits through the PHP drop-in instead, so |
| 171 |
// every hit is both visible (X-XSpeed-Cache: HIT) and counted |
| 172 |
// in the hit-ratio — see Cache::static_rewrite_allowed(). This |
| 173 |
// is the healthy, expected state on LiteSpeed, not a fallback. |
| 174 |
$out[] = array( |
| 175 |
'id' => 'static_rewrite_litespeed', |
| 176 |
'tone' => self::OK, |
| 177 |
'label' => 'Cache serving (LiteSpeed)', |
| 178 |
'detail' => 'Cache hits are served by xSpeed\'s drop-in and tagged X-XSpeed-Cache: HIT — so every hit is visible and counted in your hit-ratio. (LiteSpeed\'s .htaccess can\'t add that header or log static hits, so xSpeed serves them itself for accurate reporting.)', |
| 179 |
); |
| 180 |
} elseif ( Server::APACHE === $server_type ) { |
| 181 |
$installed = Cache::rewrite_installed(); |
| 182 |
if ( $is_active ) { |
| 183 |
$tone = self::OK; |
| 184 |
$detail = 'Block installed and serving cache hits directly — PHP bypassed.'; |
| 185 |
} elseif ( ! $installed ) { |
| 186 |
$tone = self::WARN; |
| 187 |
$detail = 'Block missing from .htaccess. Toggle Enable Cache off and on to reinstall it.'; |
| 188 |
} else { |
| 189 |
$tone = self::WARN; |
| 190 |
$detail = sprintf( 'Block installed but probe failed (%s). Confirm the .htaccess block is at the TOP of the file, and that AllowOverride is enabled for your site so mod_rewrite reads it.', (string) ( $probe['reason'] ?? 'unknown' ) ); |
| 191 |
} |
| 192 |
$out[] = array( |
| 193 |
'id' => 'static_rewrite', |
| 194 |
'tone' => $tone, |
| 195 |
'label' => 'Static-file rewrite (.htaccess)', |
| 196 |
'detail' => $detail, |
| 197 |
); |
| 198 |
} |
| 199 |
} |
| 200 |
|
| 201 |
// Permalinks |
| 202 |
$permalinks_ok = (bool) get_option( 'permalink_structure' ); |
| 203 |
$out[] = array( |
| 204 |
'id' => 'permalinks', |
| 205 |
'tone' => $permalinks_ok ? self::OK : self::WARN, |
| 206 |
'label' => 'Permalinks', |
| 207 |
'detail' => $permalinks_ok |
| 208 |
? 'Pretty permalinks active.' |
| 209 |
: 'Set permalinks to anything other than "Plain" — page caching needs URL paths to key on.', |
| 210 |
); |
| 211 |
|
| 212 |
// Conflicting plugins |
| 213 |
$out[] = array( |
| 214 |
'id' => 'conflicts', |
| 215 |
'tone' => empty( $conflicts ) ? self::OK : self::WARN, |
| 216 |
'label' => 'Caching plugin conflicts', |
| 217 |
'detail' => empty( $conflicts ) |
| 218 |
? 'No other caching plugins detected.' |
| 219 |
: sprintf( 'Active: %s. Deactivate before enabling xSpeed cache to avoid double-caching.', implode( ', ', $conflicts ) ), |
| 220 |
); |
| 221 |
|
| 222 |
return $out; |
| 223 |
} |
| 224 |
|
| 225 |
/** |
| 226 |
* Lightweight environment payload for the onboarding wizard. Keeps |
| 227 |
* the legacy shape Onboarding::env_payload returned so the Welcome |
| 228 |
* step's HealthRow rendering doesn't change. |
| 229 |
*/ |
| 230 |
public static function env_payload(): array { |
| 231 |
global $wp_version; |
| 232 |
$cache_dir = defined( 'XSPEED_CACHE_DIR' ) ? XSPEED_CACHE_DIR : ( WP_CONTENT_DIR . '/cache/xspeed' ); |
| 233 |
return array( |
| 234 |
'wp' => array( |
| 235 |
'version' => (string) $wp_version, |
| 236 |
'ok' => version_compare( (string) $wp_version, '6.0', '>=' ), |
| 237 |
), |
| 238 |
'php' => array( |
| 239 |
'version' => PHP_VERSION, |
| 240 |
'ok' => version_compare( PHP_VERSION, '7.4', '>=' ), |
| 241 |
'modern' => version_compare( PHP_VERSION, '8.1', '>=' ), |
| 242 |
), |
| 243 |
'server' => array( |
| 244 |
'type' => Server::type(), |
| 245 |
'gzip_mode' => Server::gzip_mode(), |
| 246 |
), |
| 247 |
'cache_dir' => array( |
| 248 |
'path' => $cache_dir, |
| 249 |
'writable' => wp_mkdir_p( $cache_dir ) && wp_is_writable( $cache_dir ), |
| 250 |
), |
| 251 |
'wp_config' => array( |
| 252 |
'writable' => self::wp_config_writable(), |
| 253 |
), |
| 254 |
'permalinks_ok' => (bool) get_option( 'permalink_structure' ), |
| 255 |
'conflicts' => Server::conflicts(), |
| 256 |
); |
| 257 |
} |
| 258 |
|
| 259 |
private static function wp_config_writable(): bool { |
| 260 |
$path = ABSPATH . 'wp-config.php'; |
| 261 |
if ( ! file_exists( $path ) ) { |
| 262 |
$path = dirname( ABSPATH ) . '/wp-config.php'; |
| 263 |
} |
| 264 |
return file_exists( $path ) && wp_is_writable( $path ); |
| 265 |
} |
| 266 |
} |
| 267 |
|
