give / src / DonationForms / Routes / DonateRouteSignature.php

DonateRouteSignature.php in GiveWP – Donation Plugin and Fundraising Platform 4.18.0, at src/DonationForms/Routes/DonateRouteSignature.php

86 lines 1.6 KB

Raw Download Zip

1	<?php
2
3	namespace Give\DonationForms\Routes;
4
5	/**
6	* @since 3.0.0
7	*/
8	class DonateRouteSignature
9	{
10	/**
11	* @var string
12	*/
13	private $signature;
14	/**
15	* @var string
16	*/
17	public $expiration;
18
19	/**
20	* @since 4.17.0 Declare the nullable parameter explicitly.
21	* @since 3.0.0
22	*/
23	public function __construct(string $name, ?string $expiration = null)
24	{
25	$this->expiration = $expiration ?: $this->createExpirationTimestamp();
26	$this->signature = $this->generateSignatureString($name, $this->expiration);
27	}
28
29
30	/**
31	* @since 3.0.0
32	*/
33	private function generateSignatureString(string $name, string $expiration): string
34	{
35	return "$name\|$expiration";
36	}
37
38	/**
39	* @since 3.0.0
40	*
41	* @return string
42	*/
43	public function toString(): string
44	{
45	return $this->signature;
46	}
47
48	/**
49	* @since 3.0.0
50	*
51	* @return string
52	*/
53	public function toHash(): string
54	{
55	return wp_hash($this->signature);
56	}
57
58	/**
59	* Create expiration timestamp
60	*
61	* @since 3.0.0
62	*
63	* @return string
64	*/
65	public function createExpirationTimestamp(): string
66	{
67	return (string)current_datetime()->modify('+1 day')->getTimestamp();
68	}
69
70
71	/**
72	* @since 3.0.0
73	*/
74	public function isValid(string $suppliedSignature): bool
75	{
76	$isSignatureValid = hash_equals(
77	$suppliedSignature,
78	$this->toHash()
79	);
80
81	$isNotExpired = ((int)$this->expiration) >= current_datetime()->getTimestamp();
82
83	return $isSignatureValid && $isNotExpired;
84	}
85	}
86