name = $name; $this->value = $value; } /** * Acquire a token-owned recoverable option mutex. * * @param string $name Name. * @param int $ttl Ttl. * @return mixed */ public static function acquire( string $name, int $ttl = 120 ) { $value = array( 'token' => wp_generate_uuid4(), 'expires' => Clock::now() + $ttl, ); if ( add_option( $name, $value, '', false ) ) { return new self( $name, $value ); } $old = get_option( $name ); if ( is_array( $old ) && (int) ( $old['expires'] ?? 0 ) < Clock::now() ) { self::compare_delete( $name, $old ); if ( add_option( $name, $value, '', false ) ) { return new self( $name, $value ); } } return null; } /** * Atomically delete only the expected mutex value. * * @param string $name Name. * @param array $value Value. * @return mixed */ private static function compare_delete( string $name, array $value ) { global $wpdb; // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- Atomic compare-and-delete prevents deleting another worker's mutex; caches are invalidated below. $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name=%s AND option_value=%s", $name, maybe_serialize( $value ) ) ); wp_cache_delete( $name, 'options' ); wp_cache_delete( 'notoptions', 'options' ); } /** * Release only the mutex owned by this token. * * @return mixed */ public function release() { self::compare_delete( $this->name, $this->value ); } }