diff --git a/src/wp-includes/class-wp-network-query.php b/src/wp-includes/class-wp-network-query.php index bf6323d747..85d8b53590 100644 --- a/src/wp-includes/class-wp-network-query.php +++ b/src/wp-includes/class-wp-network-query.php @@ -89,49 +89,52 @@ class WP_Network_Query { * @param string|array $query { * Optional. Array or query string of network query parameters. Default empty. * - * @type int[] $network__in Array of network IDs to include. Default empty. - * @type int[] $network__not_in Array of network IDs to exclude. Default empty. - * @type bool $count Whether to return a network count (true) or array of network objects. - * Default false. - * @type string $fields Network fields to return. Accepts 'ids' (returns an array of network IDs) - * or empty (returns an array of complete network objects). Default empty. - * @type int $number Maximum number of networks to retrieve. Default empty (no limit). - * @type int $offset Number of networks to offset the query. Used to build LIMIT clause. - * Default 0. - * @type bool $no_found_rows Whether to disable the `SQL_CALC_FOUND_ROWS` query. Default true. - * @type string|array $orderby Network status or array of statuses. Accepts 'id', 'domain', 'path', - * 'domain_length', 'path_length' and 'network__in'. Also accepts false, - * an empty array, or 'none' to disable `ORDER BY` clause. Default 'id'. - * @type string $order How to order retrieved networks. Accepts 'ASC', 'DESC'. Default 'ASC'. - * @type string $domain Limit results to those affiliated with a given domain. Default empty. - * @type string[] $domain__in Array of domains to include affiliated networks for. Default empty. - * @type string[] $domain__not_in Array of domains to exclude affiliated networks for. Default empty. - * @type string $path Limit results to those affiliated with a given path. Default empty. - * @type string[] $path__in Array of paths to include affiliated networks for. Default empty. - * @type string[] $path__not_in Array of paths to exclude affiliated networks for. Default empty. - * @type string $search Search term(s) to retrieve matching networks for. Default empty. - * @type bool $update_network_cache Whether to prime the cache for found networks. Default true. + * @type int[] $network__in Array of network IDs to include. Default empty. + * @type int[] $network__not_in Array of network IDs to exclude. Default empty. + * @type bool $count Whether to return a network count (true) or array of network objects. + * Default false. + * @type string $fields Network fields to return. Accepts 'ids' (returns an array of network IDs) + * or empty (returns an array of complete network objects). Default empty. + * @type int $number Maximum number of networks to retrieve. Default empty (no limit). + * @type int $offset Number of networks to offset the query. Used to build LIMIT clause. + * Default 0. + * @type bool $no_found_rows Whether to disable the `SQL_CALC_FOUND_ROWS` query. Default true. + * @type string|array $orderby Network status or array of statuses. Accepts 'id', 'domain', 'path', + * 'domain_length', 'path_length' and 'network__in'. Also accepts false, + * an empty array, or 'none' to disable `ORDER BY` clause. Default 'id'. + * @type string $order How to order retrieved networks. Accepts 'ASC', 'DESC'. Default 'ASC'. + * @type string $domain Limit results to those affiliated with a given domain. Default empty. + * @type string[] $domain__in Array of domains to include affiliated networks for. Default empty. + * @type string[] $domain__not_in Array of domains to exclude affiliated networks for. Default empty. + * @type string $path Limit results to those affiliated with a given path. Default empty. + * @type string[] $path__in Array of paths to include affiliated networks for. Default empty. + * @type string[] $path__not_in Array of paths to exclude affiliated networks for. Default empty. + * @type string $search Search term(s) to retrieve matching networks for. Default empty. + * @type bool $update_network_cache Whether to prime the cache for found networks. Default true. + * @type bool $update_network_meta_cache Whether to prime the metadata (option) cache for found networks. + * Default true. * } */ public function __construct( $query = '' ) { $this->query_var_defaults = array( - 'network__in' => '', - 'network__not_in' => '', - 'count' => false, - 'fields' => '', - 'number' => '', - 'offset' => '', - 'no_found_rows' => true, - 'orderby' => 'id', - 'order' => 'ASC', - 'domain' => '', - 'domain__in' => '', - 'domain__not_in' => '', - 'path' => '', - 'path__in' => '', - 'path__not_in' => '', - 'search' => '', - 'update_network_cache' => true, + 'network__in' => '', + 'network__not_in' => '', + 'count' => false, + 'fields' => '', + 'number' => '', + 'offset' => '', + 'no_found_rows' => true, + 'orderby' => 'id', + 'order' => 'ASC', + 'domain' => '', + 'domain__in' => '', + 'domain__not_in' => '', + 'path' => '', + 'path__in' => '', + 'path__not_in' => '', + 'search' => '', + 'update_network_cache' => true, + 'update_network_meta_cache' => true, ); if ( ! empty( $query ) ) { @@ -242,8 +245,8 @@ class WP_Network_Query { // $args can include anything. Only use the args defined in the query_var_defaults to compute the key. $_args = wp_array_slice_assoc( $this->query_vars, array_keys( $this->query_var_defaults ) ); - // Ignore the $fields, $update_network_cache arguments as the queried result will be the same regardless. - unset( $_args['fields'], $_args['update_network_cache'] ); + // Ignore the $fields, $update_network_cache, and $update_network_meta_cache arguments as the queried result will be the same regardless. + unset( $_args['fields'], $_args['update_network_cache'], $_args['update_network_meta_cache'] ); $key = md5( serialize( $_args ) ); $last_changed = wp_cache_get_last_changed( 'networks' ); @@ -285,7 +288,7 @@ class WP_Network_Query { } if ( $this->query_vars['update_network_cache'] ) { - _prime_network_caches( $network_ids ); + _prime_network_caches( $network_ids, $this->query_vars['update_network_meta_cache'] ); } // Fetch full network objects from the primed cache. diff --git a/src/wp-includes/load.php b/src/wp-includes/load.php index 3b0b89af8b..d4bc58b9c2 100644 --- a/src/wp-includes/load.php +++ b/src/wp-includes/load.php @@ -743,6 +743,7 @@ function wp_start_object_cache() { 'site-details', 'site-options', 'site-transient', + 'site_meta', 'rss', 'users', 'useremail', diff --git a/src/wp-includes/ms-blogs.php b/src/wp-includes/ms-blogs.php index ed30cc5fe8..f8f926a4d7 100644 --- a/src/wp-includes/ms-blogs.php +++ b/src/wp-includes/ms-blogs.php @@ -564,6 +564,7 @@ function switch_to_blog( $new_blog_id, $deprecated = null ) { 'site-details', 'site-options', 'site-transient', + 'site_meta', 'rss', 'users', 'useremail', @@ -655,6 +656,7 @@ function restore_current_blog() { 'site-details', 'site-options', 'site-transient', + 'site_meta', 'rss', 'users', 'useremail', diff --git a/src/wp-includes/ms-functions.php b/src/wp-includes/ms-functions.php index 364b7a4cc5..2bb9c276dd 100644 --- a/src/wp-includes/ms-functions.php +++ b/src/wp-includes/ms-functions.php @@ -113,7 +113,7 @@ function get_active_blog_for_user( $user_id ) { * @return int Number of active sites on the network. */ function get_blog_count( $network_id = null ) { - return get_network_option( $network_id, 'blog_count' ); + return (int) get_network_option( $network_id, 'blog_count' ); } /** @@ -2654,7 +2654,7 @@ function get_space_allowed() { * * @param int $space_allowed Upload quota in megabytes for the current blog. */ - return apply_filters( 'get_space_allowed', $space_allowed ); + return (int) apply_filters( 'get_space_allowed', $space_allowed ); } /** diff --git a/src/wp-includes/ms-network.php b/src/wp-includes/ms-network.php index 5d14d69ec7..941d767afe 100644 --- a/src/wp-includes/ms-network.php +++ b/src/wp-includes/ms-network.php @@ -84,6 +84,7 @@ function clean_network_cache( $ids ) { $network_ids = (array) $ids; wp_cache_delete_multiple( $network_ids, 'networks' ); + wp_cache_delete_multiple( $network_ids, 'site_meta' ); foreach ( $network_ids as $id ) { /** @@ -107,35 +108,44 @@ function clean_network_cache( $ids ) { * cache using the network group with the key using the ID of the networks. * * @since 4.6.0 + * @since 6.1.0 Introduced the `$update_meta_cache` parameter. * - * @param array $networks Array of network row objects. + * @param array $networks Array of network row objects. + * @param bool $update_meta_cache Whether to update site meta cache. Default true. */ -function update_network_cache( $networks ) { +function update_network_cache( $networks, $update_meta_cache = true ) { $data = array(); foreach ( (array) $networks as $network ) { $data[ $network->id ] = $network; } + wp_cache_add_multiple( $data, 'networks' ); + if ( $update_meta_cache ) { + $network_ids = array_keys( $data ); + update_meta_cache( 'site', $network_ids ); + } } /** * Adds any networks from the given IDs to the cache that do not already exist in cache. * * @since 4.6.0 + * @since 6.1.0 Introduced the `$update_meta_cache` parameter. * @since 6.1.0 This function is no longer marked as "private". * * @see update_network_cache() * @global wpdb $wpdb WordPress database abstraction object. * - * @param array $network_ids Array of network IDs. + * @param array $network_ids Array of network IDs. + * @param bool $update_meta_cache Whether to update site meta cache. Default true. */ -function _prime_network_caches( $network_ids ) { +function _prime_network_caches( $network_ids, $update_meta_cache = true ) { global $wpdb; $non_cached_ids = _get_non_cached_ids( $network_ids, 'networks' ); if ( ! empty( $non_cached_ids ) ) { $fresh_networks = $wpdb->get_results( sprintf( "SELECT $wpdb->site.* FROM $wpdb->site WHERE id IN (%s)", implode( ',', array_map( 'intval', $non_cached_ids ) ) ) ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared - update_network_cache( $fresh_networks ); + update_network_cache( $fresh_networks, $update_meta_cache ); } } diff --git a/src/wp-includes/option.php b/src/wp-includes/option.php index 2cef038267..c6ecb3bfde 100644 --- a/src/wp-includes/option.php +++ b/src/wp-includes/option.php @@ -324,15 +324,12 @@ function wp_load_alloptions( $force_cache = false ) { * Loads and caches certain often requested site options if is_multisite() and a persistent cache is not being used. * * @since 3.0.0 - * - * @global wpdb $wpdb WordPress database abstraction object. + * @since 6.1.0 Uses update_meta_cache * * @param int $network_id Optional site ID for which to query the options. Defaults to the current site. */ function wp_load_core_site_options( $network_id = null ) { - global $wpdb; - - if ( ! is_multisite() || wp_using_ext_object_cache() || wp_installing() ) { + if ( ! is_multisite() || wp_installing() ) { return; } @@ -340,20 +337,7 @@ function wp_load_core_site_options( $network_id = null ) { $network_id = get_current_network_id(); } - $core_options = array( 'site_name', 'siteurl', 'active_sitewide_plugins', '_site_transient_timeout_theme_roots', '_site_transient_theme_roots', 'site_admins', 'can_compress_scripts', 'global_terms_enabled', 'ms_files_rewriting' ); - - $core_options_in = "'" . implode( "', '", $core_options ) . "'"; - $options = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM $wpdb->sitemeta WHERE meta_key IN ($core_options_in) AND site_id = %d", $network_id ) ); - - $data = array(); - foreach ( $options as $option ) { - $key = $option->meta_key; - $cache_key = "{$network_id}:$key"; - $option->meta_value = maybe_unserialize( $option->meta_value ); - - $data[ $cache_key ] = $option->meta_value; - } - wp_cache_set_multiple( $data, 'site-options' ); + update_meta_cache( 'site', $network_id ); } /** @@ -1362,10 +1346,10 @@ function update_site_option( $option, $value ) { * Retrieves a network's option value based on the option name. * * @since 4.4.0 + * @since 6.1.0 Now uses get_metadata(). * * @see get_option() - * - * @global wpdb $wpdb WordPress database abstraction object. + * @see get_metadata() * * @param int $network_id ID of the network. Can be null to default to the current network ID. * @param string $option Name of the option to retrieve. Expected to not be SQL-escaped. @@ -1373,8 +1357,6 @@ function update_site_option( $option, $value ) { * @return mixed Value set for the option. */ function get_network_option( $network_id, $option, $default = false ) { - global $wpdb; - if ( $network_id && ! is_numeric( $network_id ) ) { return false; } @@ -1415,12 +1397,7 @@ function get_network_option( $network_id, $option, $default = false ) { return $pre; } - // Prevent non-existent options from triggering multiple queries. - $notoptions_key = "$network_id:notoptions"; - $notoptions = wp_cache_get( $notoptions_key, 'site-options' ); - - if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) { - + if ( ! is_multisite() ) { /** * Filters the value of a specific default network option. * @@ -1435,44 +1412,21 @@ function get_network_option( $network_id, $option, $default = false ) { * @param string $option Option name. * @param int $network_id ID of the network. */ - return apply_filters( "default_site_option_{$option}", $default, $option, $network_id ); - } - - if ( ! is_multisite() ) { - /** This filter is documented in wp-includes/option.php */ - $default = apply_filters( 'default_site_option_' . $option, $default, $option, $network_id ); + $default = apply_filters( "default_site_option_{$option}", $default, $option, $network_id ); $value = get_option( $option, $default ); } else { - $cache_key = "$network_id:$option"; - $value = wp_cache_get( $cache_key, 'site-options' ); + $meta = get_metadata_raw( 'site', $network_id, $option ); + if ( is_array( $meta ) && ! empty( $meta ) ) { + $value = array_shift( $meta ); + } else { + /** This filter is documented in wp-includes/option.php */ + $value = apply_filters( "default_site_option_{$option}", $default, $option, $network_id ); - if ( ! isset( $value ) || false === $value ) { - $row = $wpdb->get_row( $wpdb->prepare( "SELECT meta_value FROM $wpdb->sitemeta WHERE meta_key = %s AND site_id = %d", $option, $network_id ) ); - - // Has to be get_row() instead of get_var() because of funkiness with 0, false, null values. - if ( is_object( $row ) ) { - $value = $row->meta_value; - $value = maybe_unserialize( $value ); - wp_cache_set( $cache_key, $value, 'site-options' ); - } else { - if ( ! is_array( $notoptions ) ) { - $notoptions = array(); - } - - $notoptions[ $option ] = true; - wp_cache_set( $notoptions_key, $notoptions, 'site-options' ); - - /** This filter is documented in wp-includes/option.php */ - $value = apply_filters( 'default_site_option_' . $option, $default, $option, $network_id ); - } + /** This action is documented in wp-includes/meta.php */ + $value = apply_filters( 'default_site_metadata', $value, $network_id, $option, true, 'site' ); } } - if ( ! is_array( $notoptions ) ) { - $notoptions = array(); - wp_cache_set( $notoptions_key, $notoptions, 'site-options' ); - } - /** * Filters the value of an existing network option. * @@ -1496,10 +1450,10 @@ function get_network_option( $network_id, $option, $default = false ) { * Existing options will not be updated. * * @since 4.4.0 + * @since 6.1.0 Now uses add_metadata(). * * @see add_option() - * - * @global wpdb $wpdb WordPress database abstraction object. + * @see add_metadata() * * @param int $network_id ID of the network. Can be null to default to the current network ID. * @param string $option Name of the option to add. Expected to not be SQL-escaped. @@ -1507,8 +1461,6 @@ function get_network_option( $network_id, $option, $default = false ) { * @return bool True if the option was added, false otherwise. */ function add_network_option( $network_id, $option, $value ) { - global $wpdb; - if ( $network_id && ! is_numeric( $network_id ) ) { return false; } @@ -1538,48 +1490,11 @@ function add_network_option( $network_id, $option, $value ) { */ $value = apply_filters( "pre_add_site_option_{$option}", $value, $option, $network_id ); - $notoptions_key = "$network_id:notoptions"; - if ( ! is_multisite() ) { $result = add_option( $option, $value, '', 'no' ); } else { - $cache_key = "$network_id:$option"; - - // Make sure the option doesn't already exist. - // We can check the 'notoptions' cache before we ask for a DB query. - $notoptions = wp_cache_get( $notoptions_key, 'site-options' ); - - if ( ! is_array( $notoptions ) || ! isset( $notoptions[ $option ] ) ) { - if ( false !== get_network_option( $network_id, $option, false ) ) { - return false; - } - } - - $value = sanitize_option( $option, $value ); - - $serialized_value = maybe_serialize( $value ); - $result = $wpdb->insert( - $wpdb->sitemeta, - array( - 'site_id' => $network_id, - 'meta_key' => $option, - 'meta_value' => $serialized_value, - ) - ); - - if ( ! $result ) { - return false; - } - - wp_cache_set( $cache_key, $value, 'site-options' ); - - // This option exists now. - $notoptions = wp_cache_get( $notoptions_key, 'site-options' ); // Yes, again... we need it to be fresh. - - if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) { - unset( $notoptions[ $option ] ); - wp_cache_set( $notoptions_key, $notoptions, 'site-options' ); - } + $value = sanitize_option( $option, $value ); + $result = add_metadata( 'site', $network_id, wp_slash( $option ), wp_slash( $value ), true ); } if ( $result ) { @@ -1621,8 +1536,10 @@ function add_network_option( $network_id, $option, $value ) { * Removes a network option by name. * * @since 4.4.0 + * @since 6.1.0 Now uses delete_metadata(). * * @see delete_option() + * @see delete_metadata() * * @global wpdb $wpdb WordPress database abstraction object. * @@ -1631,8 +1548,6 @@ function add_network_option( $network_id, $option, $value ) { * @return bool True if the option was deleted, false otherwise. */ function delete_network_option( $network_id, $option ) { - global $wpdb; - if ( $network_id && ! is_numeric( $network_id ) ) { return false; } @@ -1661,20 +1576,7 @@ function delete_network_option( $network_id, $option ) { if ( ! is_multisite() ) { $result = delete_option( $option ); } else { - $row = $wpdb->get_row( $wpdb->prepare( "SELECT meta_id FROM {$wpdb->sitemeta} WHERE meta_key = %s AND site_id = %d", $option, $network_id ) ); - if ( is_null( $row ) || ! $row->meta_id ) { - return false; - } - $cache_key = "$network_id:$option"; - wp_cache_delete( $cache_key, 'site-options' ); - - $result = $wpdb->delete( - $wpdb->sitemeta, - array( - 'meta_key' => $option, - 'site_id' => $network_id, - ) - ); + $result = delete_metadata( 'site', $network_id, wp_slash( $option ), '' ); } if ( $result ) { @@ -1714,10 +1616,10 @@ function delete_network_option( $network_id, $option ) { * Updates the value of a network option that was already added. * * @since 4.4.0 + * @since 6.1.0 Now uses update_metadata(). * * @see update_option() - * - * @global wpdb $wpdb WordPress database abstraction object. + * @see update_metadata() * * @param int $network_id ID of the network. Can be null to default to the current network ID. * @param string $option Name of the option. Expected to not be SQL-escaped. @@ -1725,8 +1627,6 @@ function delete_network_option( $network_id, $option ) { * @return bool True if the value was updated, false otherwise. */ function update_network_option( $network_id, $option, $value ) { - global $wpdb; - if ( $network_id && ! is_numeric( $network_id ) ) { return false; } @@ -1776,33 +1676,11 @@ function update_network_option( $network_id, $option, $value ) { return add_network_option( $network_id, $option, $value ); } - $notoptions_key = "$network_id:notoptions"; - $notoptions = wp_cache_get( $notoptions_key, 'site-options' ); - - if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) { - unset( $notoptions[ $option ] ); - wp_cache_set( $notoptions_key, $notoptions, 'site-options' ); - } - if ( ! is_multisite() ) { $result = update_option( $option, $value, 'no' ); } else { - $value = sanitize_option( $option, $value ); - - $serialized_value = maybe_serialize( $value ); - $result = $wpdb->update( - $wpdb->sitemeta, - array( 'meta_value' => $serialized_value ), - array( - 'site_id' => $network_id, - 'meta_key' => $option, - ) - ); - - if ( $result ) { - $cache_key = "$network_id:$option"; - wp_cache_set( $cache_key, $value, 'site-options' ); - } + $value = sanitize_option( $option, $value ); + $result = update_metadata( 'site', $network_id, wp_slash( $option ), wp_slash( $value ) ); } if ( $result ) { diff --git a/tests/phpunit/tests/ajax/Compression.php b/tests/phpunit/tests/ajax/Compression.php index 4de6c2d154..9c4b369ebb 100644 --- a/tests/phpunit/tests/ajax/Compression.php +++ b/tests/phpunit/tests/ajax/Compression.php @@ -154,7 +154,7 @@ class Tests_Ajax_CompressionTest extends WP_Ajax_UnitTestCase { } // Check the site option is not changed due to lack of nonce. - $this->assertSame( 0, get_site_option( 'can_compress_scripts' ) ); + $this->assertSame( 0, (int) get_site_option( 'can_compress_scripts' ) ); // Add a nonce. $_GET['_ajax_nonce'] = wp_create_nonce( 'update_can_compress_scripts' ); @@ -167,7 +167,7 @@ class Tests_Ajax_CompressionTest extends WP_Ajax_UnitTestCase { } // Check the site option is changed. - $this->assertSame( 1, get_site_option( 'can_compress_scripts' ) ); + $this->assertSame( 1, (int) get_site_option( 'can_compress_scripts' ) ); } /** @@ -194,7 +194,7 @@ class Tests_Ajax_CompressionTest extends WP_Ajax_UnitTestCase { } // Check the site option is not changed due to lack of nonce. - $this->assertSame( 1, get_site_option( 'can_compress_scripts' ) ); + $this->assertSame( 1, (int) get_site_option( 'can_compress_scripts' ) ); // Add a nonce. $_GET['_ajax_nonce'] = wp_create_nonce( 'update_can_compress_scripts' ); @@ -207,7 +207,7 @@ class Tests_Ajax_CompressionTest extends WP_Ajax_UnitTestCase { } // Check the site option is changed. - $this->assertSame( 0, get_site_option( 'can_compress_scripts' ) ); + $this->assertSame( 0, (int) get_site_option( 'can_compress_scripts' ) ); } /** diff --git a/tests/phpunit/tests/option/multisite.php b/tests/phpunit/tests/option/multisite.php index 98c28fbf50..05ee5f9555 100644 --- a/tests/phpunit/tests/option/multisite.php +++ b/tests/phpunit/tests/option/multisite.php @@ -152,28 +152,6 @@ if ( is_multisite() ) : // $this->assertFalse( get_option( $key2 ) ); // Check get_option(). } - /** - * @group multisite - * - * @covers ::get_site_option - */ - public function test_site_notoptions() { - $network_id = get_current_network_id(); - $notoptions_key = "{$network_id}:notoptions"; - - $_notoptions = wp_cache_get( 'notoptions', 'site-options' ); - $this->assertEmpty( $_notoptions ); - $_notoptions1 = wp_cache_get( $notoptions_key, 'site-options' ); - $this->assertEmpty( $_notoptions1 ); - - get_site_option( 'burrito' ); - - $notoptions = wp_cache_get( 'notoptions', 'site-options' ); - $this->assertEmpty( $notoptions ); - $notoptions1 = wp_cache_get( $notoptions_key, 'site-options' ); - $this->assertNotEmpty( $notoptions1 ); - } - /** * @covers ::users_can_register_signup_filter * @covers ::get_site_option diff --git a/tests/phpunit/tests/option/networkOption.php b/tests/phpunit/tests/option/networkOption.php index bfce484a8d..2231ecf0fa 100644 --- a/tests/phpunit/tests/option/networkOption.php +++ b/tests/phpunit/tests/option/networkOption.php @@ -137,58 +137,124 @@ class Tests_Option_NetworkOption extends WP_UnitTestCase { } /** - * @ticket 43506 + * @ticket 37181 + * * @group ms-required * * @covers ::get_network_option * @covers ::wp_cache_get * @covers ::wp_cache_delete */ - public function test_get_network_option_sets_notoptions_if_option_found() { - $network_id = get_current_network_id(); - $notoptions_key = "$network_id:notoptions"; + public function test_meta_api_use_values_in_network_option() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + $value = __FUNCTION__; - $original_cache = wp_cache_get( $notoptions_key, 'site-options' ); - if ( false !== $original_cache ) { - wp_cache_delete( $notoptions_key, 'site-options' ); - } - - // Retrieve any existing option. - get_network_option( $network_id, 'site_name' ); - - $cache = wp_cache_get( $notoptions_key, 'site-options' ); - if ( false !== $original_cache ) { - wp_cache_set( $notoptions_key, $original_cache, 'site-options' ); - } - - $this->assertSame( array(), $cache ); + add_metadata( 'site', $network_id, $option, $value, true ); + $this->assertEqualSets( get_metadata( 'site', $network_id, $option ), array( get_network_option( $network_id, $option, true ) ) ); } /** - * @ticket 43506 + * @ticket 37181 + * + * @group ms-required + */ + function test_funky_network_meta() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + $classy = new StdClass(); + $classy->ID = 1; + $classy->stringy = 'I love slashes\\\\'; + $funky_meta[] = $classy; + + $classy = new StdClass(); + $classy->ID = 2; + $classy->stringy = 'I love slashes\\\\ more'; + $funky_meta[] = $classy; + + // Add a network meta item. + $this->assertIsInt( add_metadata( 'site', $network_id, $option, $funky_meta, true ) ); + + // Check they exists. + $this->assertEquals( $funky_meta, get_network_option( $network_id, $option ) ); + } + + /** + * @ticket 37181 + * + * @group ms-required + */ + public function test_meta_api_multiple_values_in_network_option() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + add_metadata( 'site', $network_id, $option, 'monday', true ); + add_metadata( 'site', $network_id, $option, 'tuesday', true ); + add_metadata( 'site', $network_id, $option, 'wednesday', true ); + $this->assertEquals( 'monday', get_network_option( $network_id, $option, true ) ); + } + + /** + * @ticket 37181 + * * @group ms-required * * @covers ::get_network_option * @covers ::wp_cache_get */ - public function test_get_network_option_sets_notoptions_if_option_not_found() { - $network_id = get_current_network_id(); - $notoptions_key = "$network_id:notoptions"; + public function test_network_option_count_queries_on_non_existing() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + add_network_option( $network_id, $option, 'monday' ); + get_network_option( $network_id, $option ); + $num_queries_pre_get = get_num_queries(); + get_network_option( $network_id, 'do_not_exist' ); + $num_queries_after_get = get_num_queries(); - $original_cache = wp_cache_get( $notoptions_key, 'site-options' ); - if ( false !== $original_cache ) { - wp_cache_delete( $notoptions_key, 'site-options' ); - } + $this->assertSame( $num_queries_pre_get, $num_queries_after_get ); + } - // Retrieve any non-existing option. - get_network_option( $network_id, 'this_does_not_exist' ); + /** + * @ticket 37181 + * + * @group ms-required + */ + public function test_register_meta_network_option_single_false() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + $value = __FUNCTION__; + register_meta( + 'site', + $option, + array( + 'type' => 'string', + 'default' => $value, + 'single' => false, + ) + ); - $cache = wp_cache_get( $notoptions_key, 'site-options' ); - if ( false !== $original_cache ) { - wp_cache_set( $notoptions_key, $original_cache, 'site-options' ); - } + $this->assertSame( $value, get_network_option( $network_id, $option ) ); + } - $this->assertSame( array( 'this_does_not_exist' => true ), $cache ); + /** + * @ticket 37181 + * + * @group ms-required + */ + public function test_register_meta_network_option_single_true() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; + $value = __FUNCTION__; + register_meta( + 'site', + $option, + array( + 'type' => 'string', + 'default' => $value, + 'single' => true, + ) + ); + + $this->assertSame( $value, get_network_option( $network_id, $option ) ); } /** @@ -196,9 +262,13 @@ class Tests_Option_NetworkOption extends WP_UnitTestCase { * * @ticket 44956 * + * @group ms-required + * * @covers ::update_network_option */ public function test_update_network_option_array_with_object() { + $network_id = self::factory()->network->create(); + $option = __FUNCTION__; $array_w_object = array( 'url' => 'http://src.wordpress-develop.dev/wp-content/uploads/2016/10/cropped-Blurry-Lights.jpg', 'meta_data' => (object) array( @@ -208,24 +278,140 @@ class Tests_Option_NetworkOption extends WP_UnitTestCase { ), ); - $array_w_object_2 = array( - 'url' => 'http://src.wordpress-develop.dev/wp-content/uploads/2016/10/cropped-Blurry-Lights.jpg', - 'meta_data' => (object) array( - 'attachment_id' => 292, - 'height' => 708, - 'width' => 1260, + add_metadata( 'site', $network_id, $option, $array_w_object, true ); + $this->assertEquals( $array_w_object, get_network_option( $network_id, $option ) ); + } + + /** + * @ticket 37181 + * + * @group ms-required + * + * @covers ::add_network_option + * + * @dataProvider data_types_options + */ + public function test_type_add_network_option( $name, $value, $expected ) { + $result = add_network_option( null, $name, $value ); + $this->assertTrue( $result, 'Network option was not added' ); + + $test_value = get_network_option( null, $name ); + $this->assertSame( $expected, $test_value, 'Values do not match' ); + } + + /** + * @ticket 37181 + * + * @covers ::add_network_option + * + * @dataProvider data_slashed_options + */ + public function test_slash_add_network_option( $name, $value ) { + $result = add_network_option( null, $name, $value ); + $this->assertTrue( $result, 'Network option was not added' ); + $this->assertSame( $value, get_network_option( null, $name ), 'Values do not match' ); + } + + /** + * @ticket 37181 + * + * @covers ::update_network_option + * + * @dataProvider data_slashed_options + */ + public function test_slash_update_network_option( $name, $value ) { + $result = update_network_option( null, $name, $value ); + $this->assertTrue( $result, 'Network option was not updated' ); + $this->assertSame( $value, get_network_option( null, $name ), 'Values do not match' ); + } + + /** + * @ticket 37181 + * + * @covers ::delete_network_option() + * + * @dataProvider data_slashed_options + */ + public function test_slash_delete_network_option( $name, $value ) { + $result = add_network_option( null, $name, $value ); + $this->assertTrue( $result, 'Network option was not added' ); + $this->assertSame( $value, get_network_option( null, $name ) ); + $result = delete_network_option( null, $name ); + $this->assertTrue( $result, 'Network option was not deleted' ); + $this->assertFalse( get_network_option( null, $name ), 'Network option was not deleted' ); + } + + public function data_slashed_options() { + return array( + 'slashed option name' => array( + 'option' => 'String with 1 slash \\', + 'value' => 'foo', + ), + 'slashed in middle option name' => array( + 'option' => 'String\\thing', + 'value' => 'foo', + ), + 'slashed option value' => array( + 'option' => 'bar', + 'value' => 'String with 1 slash \\', + ), + 'slashed option name and value' => array( + 'option' => 'String with 1 slash \\', + 'value' => 'String with 1 slash \\', + ), + 'slashed 4 times option name and value' => array( + 'option' => 'String with 4 slashes \\\\\\\\', + 'value' => 'String with 4 slashes \\\\\\\\', + ), + 'slashed 7 times option name and value' => array( + 'option' => 'String with 7 slashes \\\\\\\\\\\\\\', + 'value' => 'String with 7 slashes \\\\\\\\\\\\\\', ), ); + } - // Add the option, it did not exist before this. - add_network_option( null, 'array_w_object', $array_w_object ); - - $num_queries_pre_update = get_num_queries(); - - // Update the option using the same array with an object for the value. - $this->assertFalse( update_network_option( null, 'array_w_object', $array_w_object_2 ) ); - - // Check that no new database queries were performed. - $this->assertSame( $num_queries_pre_update, get_num_queries() ); + public function data_types_options() { + return array( + 'array' => array( + 'option' => 'array', + 'value' => array(), + 'expected' => array(), + ), + 'array_keys' => array( + 'option' => 'array', + 'value' => array( 'key' => 'value' ), + 'expected' => array( 'key' => 'value' ), + ), + 'int' => array( + 'option' => 'int', + 'value' => 33, + 'expected' => '33', + ), + 'string' => array( + 'option' => 'string', + 'value' => 'foo', + 'expected' => 'foo', + ), + 'string_bool' => array( + 'option' => 'string', + 'value' => 'true', + 'expected' => 'true', + ), + 'float' => array( + 'option' => 'float', + 'value' => 33.5555, + 'expected' => '33.5555', + ), + 'bool' => array( + 'option' => 'bool', + 'value' => true, + 'expected' => '1', + ), + 'null' => array( + 'option' => 'null', + 'value' => null, + 'expected' => null, + ), + ); } }