feat: add IncomingRequest::is() method

Author: kenjis

system/HTTP/IncomingRequest.php

@@ -375,6 +375,30 @@ public function negotiate(string $type, array $supported, bool $strictMatch = fa
         throw HTTPException::forInvalidNegotiationType($type);
     }
 
+    /**
+     * Checks if this request is.
+     *
+     * @param string $value HTTP verb or 'json'
+     * @phpstan-param 'get'|'post'|'put'|'delete'|'head'|'patch'|'options'|'json' $value
+     */
+    public function is(string $value): bool
+    {
+        $value = strtolower($value);
+
+        $httpMethods = ['get', 'post', 'put', 'delete', 'head', 'patch', 'options'];
+
+        if (in_array($value, $httpMethods, true)) {
+            return strtolower($this->getMethod()) === $value;
+        }
+
+        if ($value === 'json') {
+            return strpos($this->getHeaderLine('Content-Type'), 'application/json') !== false;
+        }
+
+        // @phpstan-ignore-next-line
+        throw new InvalidArgumentException('Unknown value: ' . $value);
+    }
+
     /**
      * Determines if this request was made from the command line (CLI).
      */

tests/system/HTTP/IncomingRequestTest.php

@@ -16,6 +16,7 @@
 use CodeIgniter\HTTP\Files\UploadedFile;
 use CodeIgniter\Test\CIUnitTestCase;
 use Config\App;
+use Generator;
 use TypeError;
 
 /**
@@ -615,6 +616,46 @@ public function testCanGrabGetRawInputVar($rawstring, $var, $expected, $filter,
         $this->assertSame($expected, $request->getRawInputVar($var, $filter, $flag));
     }
 
+    /**
+     * @dataProvider provideIsHTTPMethods
+     */
+    public function testIsHTTPMethodLowerCase(string $value)
+    {
+        $request = $this->request->withMethod($value);
+
+        $this->assertTrue($request->is($value));
+    }
+
+    public function provideIsHTTPMethods(): Generator
+    {
+        yield from [
+            ['get'],
+            ['post'],
+            ['put'],
+            ['delete'],
+            ['head'],
+            ['patch'],
+            ['options'],
+        ];
+    }
+
+    /**
+     * @dataProvider provideIsHTTPMethods
+     */
+    public function testIsHTTPMethodUpperCase(string $value)
+    {
+        $request = $this->request->withMethod(strtoupper($value));
+
+        $this->assertTrue($request->is($value));
+    }
+
+    public function testIsJson()
+    {
+        $request = $this->request->setHeader('Content-Type', 'application/json');
+
+        $this->assertTrue($request->is('json'));
+    }
+
     public function testIsCLI()
     {
         $this->assertFalse($this->request->isCLI());