WP_Upgrader::create_lock() WordPress Method

The WP_Upgrader::create_lock() method is used to create a lock for the upgrader process. This is done to prevent multiple processes from running at the same time and causing errors.

WP_Upgrader::create_lock( string $lock_name, int $release_timeout = null ) #

Creates a lock using WordPress options.


Parameters

$lock_name

(string)(Required)The name of this unique lock.

$release_timeout

(int)(Optional) The duration in seconds to respect an existing lock. Default: 1 hour.

Default value: null


Top ↑

Return

(bool) False if a lock couldn't be created or if the lock is still valid. True otherwise.


Top ↑

Source

File: wp-admin/includes/class-wp-upgrader.php

	public static function create_lock( $lock_name, $release_timeout = null ) {
		global $wpdb;
		if ( ! $release_timeout ) {
			$release_timeout = HOUR_IN_SECONDS;
		}
		$lock_option = $lock_name . '.lock';

		// Try to lock.
		$lock_result = $wpdb->query( $wpdb->prepare( "INSERT IGNORE INTO `$wpdb->options` ( `option_name`, `option_value`, `autoload` ) VALUES (%s, %s, 'no') /* LOCK */", $lock_option, time() ) );

		if ( ! $lock_result ) {
			$lock_result = get_option( $lock_option );

			// If a lock couldn't be created, and there isn't a lock, bail.
			if ( ! $lock_result ) {
				return false;
			}

			// Check to see if the lock is still valid. If it is, bail.
			if ( $lock_result > ( time() - $release_timeout ) ) {
				return false;
			}

			// There must exist an expired lock, clear it and re-gain it.
			WP_Upgrader::release_lock( $lock_name );

			return WP_Upgrader::create_lock( $lock_name, $release_timeout );
		}

		// Update the lock, as by this point we've definitely got a lock, just need to fire the actions.
		update_option( $lock_option, time() );

		return true;
	}


Top ↑

Changelog

Changelog
VersionDescription
4.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.