*/ private $capability_source; /** * @param callable():array|null $capability_source Testable local capability adapter. */ public function __construct( FindingFactory $findings, ?callable $capability_source = null ) { $this->findings = $findings; $this->capability_source = $capability_source ?? array( $this, 'wordpress_capabilities' ); } public function id(): string { return 'environment.time_cron_mail'; } /** * @return array */ public function execute( string $timestamp ): array { try { $capabilities = call_user_func( $this->capability_source ); } catch ( Throwable $exception ) { return $this->error_finding( $timestamp ); } if ( ! is_array( $capabilities ) ) { return $this->error_finding( $timestamp ); } $observations = array(); $failures = 0; $informational = false; $cron_unknown = false; $cron_partial = false; if ( isset( $capabilities['timezone_source'], $capabilities['timezone_valid'] ) && is_string( $capabilities['timezone_source'] ) && is_bool( $capabilities['timezone_valid'] ) && in_array( $capabilities['timezone_source'], array( 'named', 'utc_offset', 'default_utc' ), true ) ) { $observations[] = array( 'capability' => 'timezone', 'source' => $capabilities['timezone_source'], 'valid' => $capabilities['timezone_valid'], ); if ( ! $capabilities['timezone_valid'] ) { ++$failures; } } if ( isset( $capabilities['cron_disabled'], $capabilities['cron_event_count'], $capabilities['overdue_event_count'], $capabilities['cron_truncated'] ) && is_bool( $capabilities['cron_disabled'] ) && is_int( $capabilities['cron_event_count'] ) && is_int( $capabilities['overdue_event_count'] ) && is_bool( $capabilities['cron_truncated'] ) && $capabilities['cron_event_count'] >= 0 && $capabilities['overdue_event_count'] >= 0 && $capabilities['overdue_event_count'] <= $capabilities['cron_event_count'] ) { $observations[] = array( 'capability' => 'cron_queue', 'wp_cron_disabled' => $capabilities['cron_disabled'], 'observed_events' => $capabilities['cron_event_count'], 'overdue_count' => $capabilities['overdue_event_count'], 'truncated' => $capabilities['cron_truncated'], ); $cron_partial = $capabilities['cron_truncated']; if ( $capabilities['overdue_event_count'] > 0 ) { // The dedicated jobs.wordpress_cron finding owns the actionable // diagnosis. Keep this combined capability row as context so one // overdue queue does not create two indistinguishable actions. $informational = true; } elseif ( $capabilities['cron_disabled'] ) { $cron_unknown = true; } } if ( isset( $capabilities['mail_api_available'] ) && is_bool( $capabilities['mail_api_available'] ) ) { $observations[] = array( 'capability' => 'wordpress_mail_api', 'available' => $capabilities['mail_api_available'], ); if ( ! $capabilities['mail_api_available'] ) { ++$failures; } } $observed = count( $observations ); $total = 3; if ( 0 === $observed ) { $status = 'not_tested'; $coverage = 'none'; } elseif ( $failures > 0 ) { $status = 'fail'; $coverage = $observed === $total ? 'complete' : 'partial'; } elseif ( $observed < $total || $cron_unknown || $cron_partial ) { $status = 'not_tested'; $coverage = 'partial'; } elseif ( $informational ) { $status = 'info'; $coverage = 'complete'; } else { $status = 'pass'; $coverage = 'complete'; } return $this->findings->build( $this->id(), $status, array( 'observations' => $observations, 'method' => 'wordpress_time_cron_mail_metadata', 'limitations' => array( 'No cron event name, email address, SMTP setting or message was collected. External cron execution and email delivery were not tested.' ), ), $observed, $total, $coverage, $timestamp ); } /** * @return array{timezone_source:string,timezone_valid:bool,cron_disabled:bool,cron_event_count:int,overdue_event_count:int,cron_truncated:bool,mail_api_available:bool} */ private function wordpress_capabilities(): array { $timezone_name = get_option( 'timezone_string', '' ); $gmt_offset = get_option( 'gmt_offset', 0 ); $timezone_type = 'default_utc'; $timezone_valid = true; if ( is_string( $timezone_name ) && '' !== $timezone_name ) { $timezone_type = 'named'; try { new DateTimeZone( $timezone_name ); } catch ( Throwable $exception ) { $timezone_valid = false; } } elseif ( is_numeric( $gmt_offset ) && (float) $gmt_offset >= -14 && (float) $gmt_offset <= 14 ) { $timezone_type = 0.0 === (float) $gmt_offset ? 'default_utc' : 'utc_offset'; } else { $timezone_valid = false; } $cron = _get_cron_array(); $event_count = 0; $overdue_count = 0; $overdue_before = time() - 300; $cron_truncated = false; $timestamp_count = 0; if ( is_array( $cron ) ) { foreach ( $cron as $scheduled_at => $hooks ) { ++$timestamp_count; if ( $timestamp_count > self::MAX_CRON_TIMESTAMPS ) { $cron_truncated = true; break; } if ( ! is_array( $hooks ) ) { continue; } foreach ( $hooks as $events ) { if ( ! is_array( $events ) ) { continue; } $remaining = self::MAX_CRON_EVENTS - $event_count; if ( $remaining <= 0 ) { $cron_truncated = true; break 2; } $observed_events = min( count( $events ), $remaining ); $event_count += $observed_events; if ( is_numeric( $scheduled_at ) && (int) $scheduled_at < $overdue_before ) { $overdue_count += $observed_events; } if ( $observed_events < count( $events ) ) { $cron_truncated = true; break 2; } } } } return array( 'timezone_source' => $timezone_type, 'timezone_valid' => $timezone_valid, 'cron_disabled' => defined( 'DISABLE_WP_CRON' ) && (bool) DISABLE_WP_CRON, 'cron_event_count' => $event_count, 'overdue_event_count' => $overdue_count, 'cron_truncated' => $cron_truncated, 'mail_api_available' => function_exists( 'wp_mail' ), ); } /** * @return array */ private function error_finding( string $timestamp ): array { return $this->findings->build( $this->id(), 'error', array( 'observations' => array(), 'method' => 'wordpress_time_cron_mail_metadata', 'limitations' => array( 'The local capability adapter failed; no exception, event, email or configuration value was stored.' ), ), 0, 3, 'error', $timestamp ); } }