%s
', + __( "WordPress performs at its best when a persistent object cache is used. A persistent object cache helps to reduce load on your SQL server significantly and allows WordPress to retrieve your site's content and settings much faster.", 'performance-lab' ) + ), + 'actions' => sprintf( + '', + esc_url( $action_url ), + __( 'Learn more about persistent object caching.', 'performance-lab' ), + /* translators: Accessibility text. */ + __( '(opens in a new tab)', 'performance-lab' ) + ), + ); + + if ( wp_using_ext_object_cache() ) { + return $result; + } + + if ( ! perflab_oc_health_should_persistent_object_cache() ) { + $result['label'] = __( 'A persistent object cache is not required', 'performance-lab' ); + + return $result; + } + + $available_services = perflab_oc_health_available_object_cache_services(); + + $notes = __( 'Speak to your web host about what persistent object caches are available and how to enable them.', 'performance-lab' ); + + if ( ! empty( $available_services ) ) { + $notes .= ' ' . sprintf( + /* translators: Available object caching services. */ + __( 'Your host appears to support the following object caching services: %s.', 'performance-lab' ), + implode( ', ', $available_services ) + ); + } + + /** + * Filter the second paragraph of the health check's description + * when suggesting the use of a persistent object cache. + * + * Hosts may want to replace the notes to recommend their preferred object caching solution. + * + * Plugin authors may want to append notes (not replace) on why object caching is recommended for their plugin. + * + * @since 1.0.0 + * + * @param string $notes The notes appended to the health check description. + * @param array $available_services The list of available persistent object cache services. + */ + $notes = apply_filters( 'perflab_oc_site_status_persistent_object_cache_notes', $notes, $available_services ); + + $result['status'] = 'recommended'; + $result['label'] = __( 'You should use a persistent object cache', 'performance-lab' ); + $result['badge']['color'] = 'orange'; + $result['description'] .= sprintf( + '%s
', + wp_kses( + $notes, + array( + 'a' => array( 'href' => true ), + 'code' => true, + 'em' => true, + 'strong' => true, + ) + ) + ); + + return $result; +} + +/** + * Determines whether to suggest using a persistent object cache. + * + * @since 1.0.0 + * + * @global wpdb $wpdb WordPress database abstraction object. + * + * @return bool Whether to suggest using a persistent object cache. + */ +function perflab_oc_health_should_persistent_object_cache() { + global $wpdb; + + /** + * Filter to force suggestion to use a persistent object cache and bypass threshold checks. + * + * @since 1.0.0 + * + * @param bool $suggest Whether to suggest using a persistent object cache. + */ + if ( apply_filters( 'perflab_oc_site_status_suggest_persistent_object_cache', false ) ) { + return true; + } + + /** + * Filter the thresholds used to determine whether to suggest the use of a persistent object cache. + * + * @since 1.0.0 + * + * @param array $thresholds The list of threshold names and numbers. + */ + $thresholds = apply_filters( + 'perflab_oc_site_status_persistent_object_cache_thresholds', + array( + 'alloptions_count' => 500, + 'alloptions_bytes' => 100000, + 'comments_count' => 1000, + 'options_count' => 1000, + 'posts_count' => 1000, + 'terms_count' => 1000, + 'users_count' => 1000, + ) + ); + + $alloptions = wp_load_alloptions(); + + if ( $thresholds['alloptions_count'] < count( $alloptions ) ) { + return true; + } + + if ( $thresholds['alloptions_bytes'] < strlen( serialize( $alloptions ) ) ) { + return true; + } + + $table_names = implode( "','", array( $wpdb->comments, $wpdb->options, $wpdb->posts, $wpdb->terms, $wpdb->users ) ); + + // With InnoDB the `TABLE_ROWS` are estimates, which are accurate enough and faster to retrieve than individual `COUNT()` queries. + $results = $wpdb->get_results( + $wpdb->prepare( + // phpcs:disable WordPress.DB.PreparedSQL.InterpolatedNotPrepared + "SELECT TABLE_NAME AS 'table', TABLE_ROWS AS 'rows', SUM(data_length + index_length) as 'bytes' + FROM information_schema.TABLES + WHERE TABLE_SCHEMA = %s + AND TABLE_NAME IN ('$table_names') + GROUP BY TABLE_NAME;", + // phpcs:enable WordPress.DB.PreparedSQL.InterpolatedNotPrepared + DB_NAME + ), + OBJECT_K + ); + + $threshold_map = array( + 'comments_count' => $wpdb->comments, + 'options_count' => $wpdb->options, + 'posts_count' => $wpdb->posts, + 'terms_count' => $wpdb->terms, + 'users_count' => $wpdb->users, + ); + + foreach ( $threshold_map as $threshold => $table ) { + if ( $thresholds[ $threshold ] <= $results[ $table ]->rows ) { + return true; + } + } + + return false; +} + +/** + * Returns a list of available persistent object cache services. + * + * @since 1.0.0 + * + * @return array The list of available persistent object cache services. + */ +function perflab_oc_health_available_object_cache_services() { + $extensions = array_map( + 'extension_loaded', + array( + 'APCu' => 'apcu', + 'Redis' => 'redis', + 'Relay' => 'relay', + 'Memcached' => 'memcache', // The `memcached` extension seems unmaintained. + ) + ); + + $services = array_keys( array_filter( $extensions ) ); + + /** + * Filter the persistent object cache services available to the user. + * + * This can be useful to hide or add services not included in the defaults. + * + * @since 1.0.0 + * + * @param array $services The list of available persistent object cache services. + */ + return apply_filters( 'perflab_oc_site_status_available_object_cache_services', $services ); +} diff --git a/tests/modules/object-cache/persistent-object-cache-health-check/health-check-test.php b/tests/modules/object-cache/persistent-object-cache-health-check/health-check-test.php new file mode 100644 index 0000000000..013ce42282 --- /dev/null +++ b/tests/modules/object-cache/persistent-object-cache-health-check/health-check-test.php @@ -0,0 +1,52 @@ +assertFalse( + perflab_oc_health_should_persistent_object_cache() + ); + } + + function test_object_cache_thresholds_check_can_be_bypassed() { + add_filter( 'perflab_oc_site_status_suggest_persistent_object_cache', '__return_true' ); + + $this->assertTrue( + perflab_oc_health_should_persistent_object_cache() + ); + } + + /** + * @dataProvider thresholds + */ + function test_object_cache_thresholds( $threshold, $count ) { + add_filter( + 'perflab_oc_site_status_persistent_object_cache_thresholds', + function ( $thresholds ) use ( $threshold, $count ) { + return array_merge( $thresholds, array( $threshold => $count ) ); + } + ); + + $this->assertTrue( + perflab_oc_health_should_persistent_object_cache() + ); + } + + function thresholds() { + return array( + array( 'comments_count', 0 ), + array( 'posts_count', 0 ), + array( 'terms_count', 1 ), + array( 'options_count', 100 ), + array( 'users_count', 0 ), + array( 'alloptions_count', 100 ), + array( 'alloptions_bytes', 1000 ), + ); + } +}