update_option() │ WP 1.0.0

$ updated = update_option ($ option_name, $ newvalue, $ autoload);

<?php update_option( 'my_option', 'нове значення' ); ?>

$newvalue = '255';

update_option( 'extract_length', $newvalue, 'no');

$option_name = 'extract_length';
$newvalue = '255';

if ( get_option( $option_name ) != $newvalue ) {
	update_option($option_name, $newvalue);
}
else {
	$deprecated = '';
	$autoload = 'no';
	add_option( $option_name, $newvalue, $deprecated, $autoload );
}

нотатки

• Global. wpdb. $wpdb WordPress database abstraction object.

список змін

Код update_option() update option ^{WP 6.0.2}

function update_option( $option, $value, $autoload = null ) {
	Global $wpdb;

	if (is_scalar($option)) {
		$ option = trim ($ option);
	}

	if (empty($option)) {
		return false;
	}

	/*
	 * Until a proper _deprecated_option() function can be introduced,
	 * redirect requests to deprecated keys to the new, correct ones.
	 */
	$deprecated_keys = array(
		'blacklist_keys' => 'disallowed_keys',
		'comment_whitelist' => 'comment_previously_approved',
	);

	if ( ! wp_installing() && isset( $deprecated_keys[ $option ] ) ) {
		_deprecated_argument(
			__FUNCTION__,
			'5.5.0',
			sprintf(
				/* translators: 1: Deprecated option key, 2: New option key. */
				__( 'The "%1$s" option key has been renamed to "%2$s".' ),
				$option,
				$deprecated_keys[ $option ]
			)
		);
		return update_option( $deprecated_keys[ $option ], $value, $autoload );
	}

	wp_protect_special_option($option);

	if ( is_object( $value ) ) {
		$value = clone $value;
	}

	$ value = sanitize_option ($ option, $ value);
	$ old_value = get_option ($ option);

	/**
	 * Filters a specific option before its value is (maybe) serialized and updated.
	 *
	 * The dynamic portion of hook name, `$option`, refers to the option name.
	 *
	 * @ Since 2.6.0
	 * @since 4.4.0 The `$option` parameter was added.
	 *
	 * @param mixed $value The new, unserialized option value.
	 * @param mixed $old_value The old option value.
	 * @param string $option Option name.
	 */
	$value = apply_filters( "pre_update_option_{$option}", $value, $old_value, $option );

	/**
	 * Filters an option before its value is (maybe) serialized and updated.
	 *
	 * @ Since 3.9.0
	 *
	 * @param mixed $value The new, unserialized option value.
	 * @param string $option Name of the option.
	 * @param mixed $old_value The old option value.
	 */
	$value = apply_filters( 'pre_update_option', $value, $option, $old_value );

	/*
	 * Якщо нові й starі значення є самі, не потрібні для оновлення.
	 *
	 * Несеріалізовані значення будуть встановлені в більшості випадків. If the unserialized
	 * data differs, the (maybe) послідовний data is checked to avoid
	 * unnecessary database calls для іншихwise identical object instances.
	 *
	 * See https://core.trac.wordpress.org/ticket/38903
	 */
	if ( $value === $old_value || maybe_serialize( $value ) === maybe_serialize( $old_value ) ) {
		return false;
	}

	/** Цей filter is documented в wp-includes/option.php */
	if ( apply_filters( "default_option_{$option}", false, $option, false ) === $old_value ) {
		// Default setting for new options is 'yes'.
		if ( null === $autoload ) {
			$autoload = 'yes';
		}

		return add_option( $option, $value, '', $autoload );
	}

	$serialized_value = maybe_serialize( $value );

	/**
	 * Fires immediately before an option value is updated.
	 *
	 * @ Since 2.9.0
	 *
	 * @param string $option Name of the option to update.
	 * @param mixed $old_value The old option value.
	 * @param mixed $value The new option value.
	 */
	do_action( 'update_option', $option, $old_value, $value);

	$update_args = array(
		'option_value' => $serialized_value,
	);

	if ( null !== $autoload ) {
		$update_args['autoload'] = ('no' === $autoload || false === $autoload ) ? 'no': 'yes';
	}

	$result = $wpdb->update( $wpdb->options, $update_args, array( 'option_name' => $option ) );
	if ( ! $result ) {
		return false;
	}

	$notoptions = wp_cache_get( 'notoptions', 'options' );

	if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
		unset($notoptions[$option]);
		wp_cache_set( 'notoptions', $notoptions, 'options' );
	}

	if ( ! wp_installing() ) {
		$ Alloptions = wp_load_alloptions (true);
		if ( isset( $alloptions[ $option ] ) ) {
			$alloptions[ $option ] = $serialized_value;
			wp_cache_set( 'alloptions', $alloptions, 'options' );
		} else {
			wp_cache_set($option, $serialized_value, 'options');
		}
	}

	/**
	 * Fires after the value of a specific option has been successfully updated.
	 *
	 * The dynamic portion of hook name, `$option`, refers to the option name.
	 *
	 * @ Since 2.0.1
	 * @since 4.4.0 The `$option` parameter was added.
	 *
	 * @param mixed $old_value The old option value.
	 * @param mixed $value The new option value.
	 * @param string $option Option name.
	 */
	do_action( "update_option_{$option}", $old_value, $value, $option);

	/**
	 * Fires after the value of an option has been successfully updated.
	 *
	 * @ Since 2.9.0
	 *
	 * @param string $option Name of the updated option.
	 * @param mixed $old_value The old option value.
	 * @param mixed $value The new option value.
	 */
	do_action( 'updated_option', $option, $old_value, $value );

	return true;
}

Зв’язані функції

API опцій (settings опції параметри)

Опції сайту (налаштування)