Add parameter to delete_expired_transients() for custom transients

[Guido07111975]

I hereby suggest adding an extra parameter to the ​delete_expired_transients() function, so dev is able to only force delete its own (custom) expired transients. By adding the transient name or its unique prefix to the function, like:

delete_expired_transients( $force_db = false, $name = false ) {

It seems to be something that can be added easily in file wp-includes/option.php.

IMO a plugin/theme should be able to delete its own data, but it should not delete data (expired transients) that are not related to the plugin/theme.

[solankisoftware]

This patch focuses on extending delete_expired_transients() to optionally target expired transients matching a given prefix. I’ll update the patch to remove unrelated docblock changes and keep it fully scoped to this ticket. Feedback welcome on approach and API design.

[Guido07111975]

Thanks! Shouldn't the timeout transient also support the custom name?

$wpdb->esc_like( '_transient_timeout_' ) . '%',
$wpdb->esc_like( '_site_transient_timeout_' ) . '%',

[solankisoftware]

New updated patch

[solankisoftware]

Yes — the updated patch accounts for that.
Timeout transients are deleted via their relationship to the filtered value transients (_transient_{$name} / _site_transient_{$name}), so providing a custom name or prefix implicitly applies to the corresponding timeout entries as well.

I’ve updated the patch accordingly and removed unrelated changes to keep the scope focused.

[soyebsalar01]

Tested this: delete expired_transients currently remove all expired transients. There is no way to scope cleanup to plugin's own transients, which makes targeted cleanup difficult. A scoped parameter would address this well.

[solankisoftware]

Thanks for testing and confirming the issue.

Yes, the current behavior removes all expired transients, which makes it difficult for plugins/themes to safely clean up only their own data.

The proposed scoped parameter allows targeted cleanup by transient name or prefix, keeping the default behavior unchanged while enabling safer, plugin-specific cleanup when needed.

[westonruter]

The $name parameter should be changed to something like $prefix. The docs should also make it clear that this only applies when not using an external object cache or if $force_db is enabled.

Also, please open a pull request instead of attaching patches. This is easier for review and it runs automated tests.

Speaking of which, this will need unit tests.

Adds an optional $prefix parameter to delete_expired_transients() to allow
scoped cleanup of expired transients when not using an external object cache
or when $force_db is enabled.

This enables plugins to safely clean up only their own expired transients.

[solankisoftware]

PR opened: ​https://github.com/WordPress/wordpress-develop/pull/10830

The PR updates delete_expired_transients() to support scoped cleanup
via a $prefix parameter and clarifies behavior with external object cache.

I’ve restored the @global wpdb documentation and pushed an update.

Thanks for the review. I’ve updated the PR to allow deleting expired transients by prefix only, ensured it runs strictly on expired entries, and aligned everything with core standards.
All feedback is addressed and it’s ready for review. 👍