Function introduction
update_option() is used to update the option values that exist in the data table. This function can replace add_option, but is not as flexible as add_option. update_option will check and determine whether the option already exists. If it does not exist, add the option using add_option ('option_name', 'option_value'). Unless the user needs to specify the option parameters of add_option, update_option() is a dual-purpose function that can add and update options at the same time.
Note: update_option() cannot update when wp_load_alloptions is about to load (or not load) an option. In this case, delete_option should be used after using the update_option() function.
Function usage
<?php update_option( $option_name, $newvalue ); ?>
Function parameters
$option_name
(String) (Required) The name of the option that needs to be updated. Valid default options that can be upgraded are listed in the Option Reference.
Default value: None
$newvalue
(Mixed) (Required) The new value for the current option name. The new value can be a string, array, object, or serialized value.
Default value: None
Function instance
Updated the value of option name myhack_extraction_length to 255. If this option does not exist, use the add_option function and set the value of autoload to no.
<?php $option_name = 'myhack_extraction_length' ; $newvalue = '255' ; if ( get_option($option_name) ) { update_option($option_name, $newvalue); } else { $deprecated=' '; $autoload='no'; add_option($option_name, $newvalue, $deprecated, $autoload); } ?>
Source file
update_option() is located in wp-includes/option.php.