wordpress-develop/tests/phpunit/tests/option/updateOption.php

<?php

/**
 * @group option
 */
class Tests_Option_UpdateOption extends WP_UnitTestCase {
	/**
	 * @ticket 31047
	 */
	public function test_should_respect_default_option_filter_when_option_does_not_yet_exist_in_database() {
		add_filter( 'default_option_doesnotexist', array( $this, '__return_foo' ) );
		$added = update_option( 'doesnotexist', 'bar' );
		remove_filter( 'default_option_doesnotexist', array( $this, '__return_foo' ) );

		$this->assertTrue( $added );
		$this->assertSame( 'bar', get_option( 'doesnotexist' ) );
	}

	/**
	 * @ticket 26394
	 */
	public function test_should_set_autoload_yes_for_nonexistent_option_when_autoload_param_is_missing() {
		global $wpdb;
		$this->flush_cache();
		update_option( 'test_update_option_default', 'value' );
		$this->flush_cache();

		// Populate the alloptions cache, which includes autoload=yes options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'test_update_option_default' );
		$after = $wpdb->num_queries;

		$this->assertEquals( $before, $after );
		$this->assertEquals( $value, 'value' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_should_set_autoload_yes_for_nonexistent_option_when_autoload_param_is_yes() {
		global $wpdb;
		$this->flush_cache();
		update_option( 'test_update_option_default', 'value', 'yes' );
		$this->flush_cache();

		// Populate the alloptions cache, which includes autoload=yes options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'test_update_option_default' );
		$after = $wpdb->num_queries;

		$this->assertEquals( $before, $after );
		$this->assertEquals( $value, 'value' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_should_set_autoload_no_for_nonexistent_option_when_autoload_param_is_no() {
		global $wpdb;
		$this->flush_cache();
		update_option( 'test_update_option_default', 'value', 'no' );
		$this->flush_cache();

		// Populate the alloptions cache, which does not include autoload=no options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'test_update_option_default' );
		$after = $wpdb->num_queries;

		// Database has been hit.
		$this->assertEquals( $before + 1, $after );
		$this->assertEquals( $value, 'value' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_should_set_autoload_no_for_nonexistent_option_when_autoload_param_is_false() {
		global $wpdb;
		$this->flush_cache();
		update_option( 'test_update_option_default', 'value', false );
		$this->flush_cache();

		// Populate the alloptions cache, which does not include autoload=no options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'test_update_option_default' );
		$after = $wpdb->num_queries;

		// Database has been hit.
		$this->assertEquals( $before + 1, $after );
		$this->assertEquals( $value, 'value' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_autoload_should_be_updated_for_existing_option_when_value_is_changed() {
		global $wpdb;
		add_option( 'foo', 'bar', '', 'no' );
		$updated = update_option( 'foo', 'bar2', true );
		$this->assertTrue( $updated );

		$this->flush_cache();

		// Populate the alloptions cache, which includes autoload=yes options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'foo' );

		$this->assertEquals( $before, $wpdb->num_queries );
		$this->assertEquals( $value, 'bar2' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_autoload_should_not_be_updated_for_existing_option_when_value_is_unchanged() {
		global $wpdb;
		add_option( 'foo', 'bar', '', 'yes' );
		$updated = update_option( 'foo', 'bar', false );
		$this->assertFalse( $updated );

		$this->flush_cache();

		// Populate the alloptions cache, which includes autoload=yes options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'foo' );

		// 'foo' should still be autoload=yes, so we should see no additional querios.
		$this->assertEquals( $before, $wpdb->num_queries );
		$this->assertEquals( $value, 'bar' );
	}

	/**
	 * @ticket 26394
	 */
	public function test_autoload_should_not_be_updated_for_existing_option_when_value_is_changed_but_no_value_of_autoload_is_provided() {
		global $wpdb;
		add_option( 'foo', 'bar', '', 'yes' );

		// Don't pass a value for `$autoload`.
		$updated = update_option( 'foo', 'bar2' );
		$this->assertTrue( $updated );

		$this->flush_cache();

		// Populate the alloptions cache, which includes autoload=yes options.
		wp_load_alloptions();

		$before = $wpdb->num_queries;
		$value = get_option( 'foo' );

		// 'foo' should still be autoload=yes, so we should see no additional querios.
		$this->assertEquals( $before, $wpdb->num_queries );
		$this->assertEquals( $value, 'bar2' );
	}

	/**
	 * `add_filter()` callback for test_should_respect_default_option_filter_when_option_does_not_yet_exist_in_database().
	 */
	public function __return_foo() {
		return 'foo';
	}
}