Automattic\WooCommerce\StoreApi\Utilities

CartTokenUtils{} │ WC 1.0

Cart token utility functions.

Использование

$CartTokenUtils = new CartTokenUtils();
// use class methods

Методы

1. public static get_cart_token( string $customer_id )
2. public static get_cart_token_expiration()
3. public static get_cart_token_payload( string $cart_token )
4. public static get_request_cart_token()
5. public static validate_cart_token( string $cart_token )
6. private static get_cart_token_secret()

Код CartTokenUtils{} CartTokenUtils{} ^{WC 11.0.1}

class CartTokenUtils {
	/**
	 * Generate a cart token.
	 *
	 * @param string $customer_id The customer ID.
	 * @return string
	 */
	public static function get_cart_token( string $customer_id ): string {
		return JsonWebToken::create(
			array(
				'user_id' => $customer_id,
				'exp'     => self::get_cart_token_expiration(),
				'iss'     => 'store-api',
			),
			self::get_cart_token_secret()
		);
	}

	/**
	 * Get the cart token sent with the current HTTP request.
	 *
	 * @since 11.1.0
	 * @return string
	 */
	public static function get_request_cart_token(): string {
		$cart_token = wc_clean( wp_unslash( $_SERVER['HTTP_CART_TOKEN'] ?? '' ) );

		return is_string( $cart_token ) ? $cart_token : '';
	}

	/**
	 * Validate the cart token.
	 *
	 * @param string $cart_token The cart token.
	 * @return bool
	 */
	public static function validate_cart_token( string $cart_token ): bool {
		return JsonWebToken::validate( $cart_token, self::get_cart_token_secret() );
	}

	/**
	 * Get the cart token payload.
	 *
	 * Returns an empty payload unless the signature validates.
	 *
	 * @since 11.1.0 Returns an empty payload for tokens that fail signature validation.
	 * @param string $cart_token The cart token.
	 * @return array
	 */
	public static function get_cart_token_payload( string $cart_token ): array {
		if ( ! self::validate_cart_token( $cart_token ) ) {
			return array(
				'user_id' => '',
				'exp'     => 0,
				'iss'     => '',
			);
		}

		$parts = JsonWebToken::get_parts( $cart_token )->payload;

		return array(
			'user_id' => $parts->user_id ?? '',
			'exp'     => $parts->exp ?? 0,
			'iss'     => $parts->iss ?? '',
		);
	}

	/**
	 * Get the cart token secret.
	 *
	 * @return string
	 */
	private static function get_cart_token_secret(): string {
		return '@' . wp_salt();
	}

	/**
	 * Gets the expiration of the cart token. Defaults to 48h.
	 *
	 * @since 11.1.0 Made public.
	 * @return int
	 */
	public static function get_cart_token_expiration(): int {
		/**
		 * Filters the session expiration.
		 *
		 * @since 5.0.0
		 * @param int $expiration Expiration in seconds.
		 */
		return time() + intval( apply_filters( 'wc_session_expiration', DAY_IN_SECONDS * 2 ) );
	}
}