Add deprecation message for expiration verification

Author: lcobucci

src/Token.php

@@ -21,6 +21,8 @@
 use function in_array;
 use function is_array;
 use function sprintf;
+use function trigger_error;
+use const E_USER_DEPRECATED;
 
 /**
  * Basic structure of the JWT
@@ -303,6 +305,10 @@ public function isExpired(DateTimeInterface $now = null)
             return false;
         }
 
+        if ($now === null) {
+            trigger_error('Not providing the current time is deprecated. Please pass an instance of DateTimeInterface.', E_USER_DEPRECATED);
+        }
+
         $now = $now ?: new DateTimeImmutable();
 
         return $now > $this->claims->get(RegisteredClaims::EXPIRATION_TIME);

test/unit/TokenTest.php

@@ -27,6 +27,8 @@
  */
 class TokenTest extends \PHPUnit\Framework\TestCase
 {
+    use CheckForDeprecations;
+
     /**
      * @test
      *
@@ -920,6 +922,8 @@ public function isExpiredShouldReturnFalseWhenTokenDoesNotExpires()
      */
     public function isExpiredShouldReturnFalseWhenTokenIsNotExpired()
     {
+        $this->expectDeprecation('Not providing the current time is deprecated. Please pass an instance of DateTimeInterface.');
+
         $token = new Token(
             ['alg' => 'none'],
             ['exp' => new DateTimeImmutable('+500 seconds')]