Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add param for atomic updating of options and distinct wrapper function #6057

Open
wants to merge 1 commit into
base: trunk
Choose a base branch
from

Conversation

Copy link

github-actions bot commented Feb 7, 2024

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Core Committers: Use this line as a base for the props when committing in SVN:

Props kkmuffme, swissspidy, mukesh27.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

Copy link

github-actions bot commented Feb 7, 2024

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • The Plugin and Theme Directories cannot be accessed within Playground.
  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

* @param string|bool $autoload Optional. @see update_option(). Default null.
* @return bool True if the value was updated, false otherwise.
*/
function update_option_atomic( $option, $value, $old_value, $autoload = null ) {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm -1 for adding such a new wrapper function, it's not consistent with other APIs like the metadata API for example.

I'd suggest focusing on the new param on update_option for now

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fine for me 👍

The long term goal was to eventually deprecated update_option by replacing it with the new atomic one, since this was an architectural oversight (or non-issue when WP was mostly serving small sites).

@@ -88,4 +88,40 @@ public function test_get_options_with_nonexistent_options() {

$this->assertFalse( $options['nonexistent_option'], 'nonexistent_option is present in option.' );
}

/**
* @covers update_option_atomic
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* @covers update_option_atomic
* @covers ::update_option
* @ticket 59246
$this->assertTrue( update_option_atomic( $option, 'fourth', $old_value ) );
}

public function data_options_atomic() {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tip: add array keys to describe the scenario

That said, is the autoload value really relevant for this test?

Seems like we don't really need the data provider.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That said, is the autoload value really relevant for this test?

Yes, since options & autoload options behave differently in the way they're cached in WP current request ($alloptions)
(as well as in how it works with caches).

This issue came up when we found and fixed https://core.trac.wordpress.org/ticket/31245 (and related), so it should be kept just to be sure.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
3 participants