Requests_Cookie::path_matches() WordPress Method

The Requests_Cookie::path_matches() method is used to check if a given path matches the path of a cookie. This can be used to check if a given cookie should be sent to a particular path.

Requests_Cookie::path_matches( string $request_path ) #

Check if a cookie is valid for a given path


Description

From the path-match check in RFC 6265 section 5.1.4


Top ↑

Parameters

$request_path

(string)(Required)Path to check


Top ↑

Return

(boolean) Whether the cookie is valid for the given path


Top ↑

Source

File: wp-includes/Requests/Cookie.php

	public function path_matches($request_path) {
		if (empty($request_path)) {
			// Normalize empty path to root
			$request_path = '/';
		}

		if (!isset($this->attributes['path'])) {
			// Cookies created manually; cookies created by Requests will set
			// the path to the requested path
			return true;
		}

		$cookie_path = $this->attributes['path'];

		if ($cookie_path === $request_path) {
			// The cookie-path and the request-path are identical.
			return true;
		}

		if (strlen($request_path) > strlen($cookie_path) && substr($request_path, 0, strlen($cookie_path)) === $cookie_path) {
			if (substr($cookie_path, -1) === '/') {
				// The cookie-path is a prefix of the request-path, and the last
				// character of the cookie-path is %x2F ("/").
				return true;
			}

			if (substr($request_path, strlen($cookie_path), 1) === '/') {
				// The cookie-path is a prefix of the request-path, and the
				// first character of the request-path that is not included in
				// the cookie-path is a %x2F ("/") character.
				return true;
			}
		}

		return false;
	}

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.