*/ public static function packages() { global $wp_version, $wp_local_package; if ( ! function_exists( 'get_plugins' ) ) { require_once ABSPATH . 'wp-admin/includes/plugin.php'; } $packages = array( array( 'type' => 'core', 'slug' => 'wordpress', 'name' => 'WordPress', 'version' => (string) $wp_version, 'locale' => is_string( $wp_local_package ) && '' !== $wp_local_package ? $wp_local_package : 'en_US', 'reason' => '', ), ); $seen = array(); foreach ( get_plugins() as $file => $data ) { $dir = dirname( $file ); if ( '.' === $dir ) { // Einzeldatei direkt im Plugin-Ordner: kein eigener Ordner, den man // gegen eine Dateiliste halten koennte. $packages[] = array( 'type' => 'plugin', 'slug' => basename( $file, '.php' ), 'name' => (string) $data['Name'], 'version' => (string) $data['Version'], 'reason' => 'single_file', ); continue; } if ( isset( $seen[ $dir ] ) ) { continue; } $seen[ $dir ] = true; // Ein Plugin mit eigenem Update-Server kann denselben Ordnernamen wie // ein Plugin im Verzeichnis tragen. Dessen Pruefsummen gelten dann // nicht, jede Datei saehe „geaendert“ aus. $update_uri = isset( $data['UpdateURI'] ) ? (string) $data['UpdateURI'] : ''; $foreign = '' !== $update_uri && false === strpos( $update_uri, 'w.org/' ) && false === strpos( $update_uri, 'wordpress.org/' ); $packages[] = array( 'type' => 'plugin', 'slug' => $dir, 'name' => (string) $data['Name'], 'version' => (string) $data['Version'], 'reason' => $foreign ? 'update_uri' : ( '' === (string) $data['Version'] ? 'no_checksums' : '' ), ); } /** * Pakete der Datei-Pruefung. Jedes Paket braucht `type` (`core`, `plugin` * oder `theme`), `slug`, `name`, `version` und `reason`. * * @param array $packages Kern und Plugins. */ $filtered = apply_filters( 'wp360_sd_integrity_packages', $packages ); return is_array( $filtered ) ? array_values( $filtered ) : $packages; } /** * Startet eine Pruefung. Ein laufender oder angehaltener Lauf wird ersetzt. * * @param string $only Optional: nur dieses Paket (`wordpress` oder Ordnername eines Plugins). * @return array|WP_Error Fortschritt wie {@see self::progress()}. */ public static function start( $only = '' ) { if ( ! self::enabled() ) { return new WP_Error( 'wp360_sd_integrity_off', __( 'The file check is switched off.', '360-orbit-security-digest' ) ); } $packages = self::packages(); if ( '' !== $only ) { $packages = array_values( array_filter( $packages, function ( $package ) use ( $only ) { return $package['slug'] === $only; } ) ); if ( ! $packages ) { return new WP_Error( 'wp360_sd_integrity_unknown', __( 'Unknown package.', '360-orbit-security-digest' ) ); } } self::save_run( array( 'status' => 'running', 'started' => time(), 'partial' => '' !== $only, 'packages' => $packages, 'index' => 0, 'current' => null, 'results' => array(), ) ); self::schedule_next(); return self::progress(); } /** Haelt den Lauf an; `resume()` setzt an derselben Stelle fort. */ public static function pause() { $run = self::run(); if ( $run && 'running' === $run['status'] ) { $run['status'] = 'paused'; self::save_run( $run ); } wp_clear_scheduled_hook( self::CRON_HOOK ); return self::progress(); } public static function resume() { $run = self::run(); if ( $run && 'paused' === $run['status'] ) { $run['status'] = 'running'; self::save_run( $run ); self::schedule_next(); } return self::progress(); } /** Verwirft den Lauf. Das letzte vollstaendige Ergebnis bleibt erhalten. */ public static function cancel() { delete_option( self::RUN_OPTION ); delete_transient( self::LOCK ); wp_clear_scheduled_hook( self::CRON_HOOK ); return self::progress(); } public static function cron_step() { self::step(); } /** * Arbeitet einen Schritt ab. * * @return array Fortschritt wie {@see self::progress()}. */ public static function step() { $run = self::run(); if ( ! $run || 'running' !== $run['status'] ) { return self::progress(); } // Cron und AJAX koennen gleichzeitig kommen. Die Sperre laeuft von // selbst ab, falls ein Schritt abbricht. if ( get_transient( self::LOCK ) ) { return self::progress(); } set_transient( self::LOCK, 1, self::STEP_SECONDS + 20 ); $deadline = microtime( true ) + self::STEP_SECONDS; $budget = self::STEP_FILES; $total = count( $run['packages'] ); while ( $run['index'] < $total ) { $package = $run['packages'][ $run['index'] ]; if ( '' !== $package['reason'] ) { $run['results'][] = self::unverifiable( $package, $package['reason'] ); ++$run['index']; continue; } $expected = self::expected( $package ); if ( ! is_array( $expected ) ) { $run['results'][] = self::unverifiable( $package, is_wp_error( $expected ) ? 'source_error' : 'no_checksums' ); $run['current'] = null; ++$run['index']; continue; } if ( ! is_array( $run['current'] ) ) { $run['current'] = array( 'offset' => 0, 'modified' => array(), 'unknown' => array(), 'unreadable' => array(), 'counts' => array( 'modified' => 0, 'unknown' => 0, 'unreadable' => 0, ), ); } $base = self::base_dir( $package ); $files = self::list_files( $package ); $count = count( $files ); $algo = 'core' === $package['type'] ? 'md5' : 'sha256'; while ( $run['current']['offset'] < $count ) { if ( $budget <= 0 || microtime( true ) >= $deadline ) { self::save_run( $run ); delete_transient( self::LOCK ); self::schedule_next(); return self::progress(); } $path = $files[ $run['current']['offset'] ]; ++$run['current']['offset']; if ( ! isset( $expected[ $path ] ) ) { if ( 'core' !== $package['type'] || Wp360_Security_Digest_Checksum_Compare::is_core_unknown_candidate( $path ) ) { self::note( $run['current'], 'unknown', $path ); } continue; } --$budget; $hash = @hash_file( $algo, $base . $path ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged -- Unlesbare Datei wird als Befund gemeldet. $state = Wp360_Security_Digest_Checksum_Compare::file_state( $expected, $path, false === $hash ? null : $hash ); if ( 'modified' === $state || 'unreadable' === $state ) { self::note( $run['current'], $state, $path ); } } $missing = Wp360_Security_Digest_Checksum_Compare::missing( $expected, $files ); $run['results'][] = self::package_result( $package, $run['current'], $missing, $count ); $run['current'] = null; ++$run['index']; } self::finish( $run ); delete_transient( self::LOCK ); return self::progress(); } /** * Fortschritt und, falls vorhanden, das letzte Ergebnis. * * @return array{status:string,done:int,total:int,current:string,result:array|null} */ public static function progress() { $run = self::run(); if ( ! $run ) { return array( 'status' => 'idle', 'done' => 0, 'total' => 0, 'current' => '', 'result' => self::result(), ); } $total = count( $run['packages'] ); $current = $run['index'] < $total ? $run['packages'][ $run['index'] ]['name'] : ''; return array( 'status' => $run['status'], 'done' => (int) $run['index'], 'total' => $total, 'current' => $current, 'result' => self::result(), ); } /** * Letztes vollstaendiges Ergebnis. * * @return array{checked_at:int,packages:array}|null */ public static function result() { $result = self::raw_result(); if ( null === $result ) { return null; } /** * Letztes Ergebnis der Datei-Pruefung vor der Anzeige. * * @param array $result Ergebnis mit `checked_at` und `packages`. */ $filtered = apply_filters( 'wp360_sd_integrity_result', $result ); return is_array( $filtered ) && isset( $filtered['packages'] ) && is_array( $filtered['packages'] ) ? $filtered : $result; } /** Gespeichertes Ergebnis, wie die Pruefung es geschrieben hat. */ private static function raw_result() { $result = get_option( self::RESULT_OPTION ); return is_array( $result ) && isset( $result['packages'] ) && is_array( $result['packages'] ) ? $result : null; } /** * Kurzfassung fuer Digest, Orbit-Uebersicht und WP-CLI. * * @return array{enabled:bool,checked_at:int,modified:int,missing:int,unknown:int,unverifiable:int,packages:int} */ public static function summary() { $summary = array( 'enabled' => self::enabled(), 'checked_at' => 0, 'modified' => 0, 'missing' => 0, 'unknown' => 0, 'unverifiable' => 0, 'packages' => 0, ); $result = self::result(); if ( ! $result ) { return $summary; } $summary['checked_at'] = (int) $result['checked_at']; $summary['packages'] = count( $result['packages'] ); foreach ( $result['packages'] as $package ) { if ( 'unverifiable' === $package['state'] ) { ++$summary['unverifiable']; continue; } foreach ( array( 'modified', 'missing', 'unknown' ) as $kind ) { $summary[ $kind ] += (int) ( $package['counts'][ $kind ] ?? 0 ); } } return $summary; } /** Raeumt beim Deaktivieren den geplanten Schritt ab; Ergebnis und Zustand bleiben. */ public static function on_deactivate() { wp_clear_scheduled_hook( self::CRON_HOOK ); wp_clear_scheduled_hook( self::WEEKLY_HOOK ); } private static function run() { $run = get_option( self::RUN_OPTION ); return is_array( $run ) && isset( $run['packages'], $run['index'], $run['status'] ) && is_array( $run['packages'] ) ? $run : null; } private static function save_run( array $run ) { update_option( self::RUN_OPTION, $run, false ); } private static function schedule_next() { if ( ! wp_next_scheduled( self::CRON_HOOK ) ) { wp_schedule_single_event( time() + 5, self::CRON_HOOK ); } } private static function finish( array $run ) { $previous = self::raw_result(); $packages = $run['results']; // Ein Lauf ueber ein einzelnes Paket ersetzt nur dessen Eintrag. if ( ! empty( $run['partial'] ) && $previous ) { $by_slug = array(); foreach ( $previous['packages'] as $package ) { $by_slug[ $package['type'] . '|' . $package['slug'] ] = $package; } foreach ( $run['results'] as $package ) { $by_slug[ $package['type'] . '|' . $package['slug'] ] = $package; } $packages = array_values( $by_slug ); } $result = array( 'checked_at' => time(), 'packages' => $packages, ); update_option( self::RESULT_OPTION, $result, false ); delete_option( self::RUN_OPTION ); wp_clear_scheduled_hook( self::CRON_HOOK ); /** * Eine Datei-Pruefung ist abgeschlossen. * * @param array $result Neues Ergebnis. * @param array|null $previous Vorheriges Ergebnis. */ do_action( 'wp360_sd_integrity_done', $result, $previous ); } /** * Soll-Liste, vorhandene Dateien und Ordner eines Pakets fuer Erweiterungen. * * @param array $package Paket aus {@see self::packages()}. * @return array|null|WP_Error */ public static function expected_for( array $package ) { return self::expected( $package ); } /** * @param array $package Paket aus {@see self::packages()}. * @return string[] Vorhandene Dateien, relativ zum Paketordner. */ public static function files_of( array $package ) { return self::list_files( $package ); } /** * @param array $package Paket aus {@see self::packages()}. * @return string Paketordner mit Schraegstrich am Ende. */ public static function dir_of( array $package ) { return self::base_dir( $package ); } /** * @return array|null|WP_Error */ private static function expected( array $package ) { if ( 'core' === $package['type'] ) { return Wp360_Security_Digest_Checksum_Source::core( $package['version'], $package['locale'] ?? 'en_US' ); } $expected = 'plugin' === $package['type'] ? Wp360_Security_Digest_Checksum_Source::plugin( $package['slug'], $package['version'] ) : null; /** * Soll-Liste eines Pakets (Pfad => Hash oder Liste gueltiger SHA-256-Werte). * null heisst: fuer dieses Paket gibt es keine Pruefsummen. * * @param array|null|WP_Error $expected Soll-Liste aus der Pruefsummen-Datei. * @param array $package Paket. */ return apply_filters( 'wp360_sd_integrity_expected', $expected, $package ); } private static function base_dir( array $package ) { if ( 'core' === $package['type'] ) { return ABSPATH; } if ( 'theme' === $package['type'] ) { return trailingslashit( get_theme_root( $package['slug'] ) ) . $package['slug'] . '/'; } return trailingslashit( WP_PLUGIN_DIR ) . $package['slug'] . '/'; } /** * Vorhandene Dateien eines Pakets, relativ zu dessen Ordner, sortiert. * Beim Kern: die Dateien direkt im Wurzelverzeichnis sowie alles unter * `wp-admin/` und `wp-includes/`. Andere Ordner im Wurzelverzeichnis * (auch `wp-content/`) werden nicht betreten. * * @return string[] */ private static function list_files( array $package ) { $base = self::base_dir( $package ); $files = array(); if ( 'core' === $package['type'] ) { $entries = @scandir( $base ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged foreach ( is_array( $entries ) ? $entries : array() as $entry ) { if ( '.' !== $entry && '..' !== $entry && is_file( $base . $entry ) ) { $files[] = $entry; } } foreach ( array( 'wp-admin', 'wp-includes' ) as $dir ) { self::walk( $base, $dir . '/', $files ); } } else { self::walk( $base, '', $files ); } sort( $files, SORT_STRING ); return $files; } private static function walk( $base, $relative, array &$files ) { $entries = @scandir( $base . $relative ); // phpcs:ignore WordPress.PHP.NoSilencedErrors.Discouraged if ( ! is_array( $entries ) ) { return; } foreach ( $entries as $entry ) { if ( '.' === $entry || '..' === $entry ) { continue; } $path = $relative . $entry; if ( is_link( $base . $path ) ) { continue; } if ( is_dir( $base . $path ) ) { self::walk( $base, $path . '/', $files ); } else { $files[] = $path; } } } private static function note( array &$current, $kind, $path ) { ++$current['counts'][ $kind ]; if ( count( $current[ $kind ] ) < self::MAX_LISTED ) { $current[ $kind ][] = $path; } } private static function package_result( array $package, array $current, array $missing, $files ) { $counts = $current['counts']; $counts['missing'] = count( $missing ); $changed = $counts['modified'] + $counts['missing'] + $counts['unknown'] + $counts['unreadable']; return array( 'type' => $package['type'], 'slug' => $package['slug'], 'name' => $package['name'], 'version' => $package['version'], 'state' => $changed > 0 ? 'changed' : 'ok', 'reason' => '', 'files' => (int) $files, 'counts' => $counts, 'modified' => $current['modified'], 'missing' => array_slice( $missing, 0, self::MAX_LISTED ), 'unknown' => $current['unknown'], 'unreadable' => $current['unreadable'], ); } private static function unverifiable( array $package, $reason ) { return array( 'type' => $package['type'], 'slug' => $package['slug'], 'name' => $package['name'], 'version' => $package['version'], 'state' => 'unverifiable', 'reason' => $reason, 'files' => 0, 'counts' => array( 'modified' => 0, 'missing' => 0, 'unknown' => 0, 'unreadable' => 0, ), 'modified' => array(), 'missing' => array(), 'unknown' => array(), 'unreadable' => array(), ); } }