Adding phpstan support

Author: phpfui

composer.json

@@ -15,7 +15,8 @@
     "require-dev": {
         "phpunit/phpunit": "^11",
         "friendsofphp/php-cs-fixer": "^3.14",
-        "php-coveralls/php-coveralls": "^2.5"
+        "php-coveralls/php-coveralls": "^2.5",
+        "phpstan/phpstan": "^2.1"
     },
     "autoload": {
         "psr-4": {"ReCaptcha\\": "src/ReCaptcha"}
@@ -33,6 +34,7 @@
             "vendor/bin/php-cs-fixer -vvv fix --using-cache=no ."
         ],
         "test": [
+            "vendor/bin/phpstan",
             "vendor/bin/phpunit --display-phpunit-deprecations"
         ],
         "serve-examples": "@php -S localhost:8080 -t examples"

phpstan.neon

@@ -0,0 +1,7 @@
+parameters:
+	level: 5
+	errorFormat: raw
+	editorUrl: '%%file%% %%line%% %%column%%: %%error%%'
+	paths:
+		- src
+

src/ReCaptcha/ReCaptcha.php

@@ -112,18 +112,6 @@ class ReCaptcha
      */
     public const E_CHALLENGE_TIMEOUT = 'challenge-timeout';
 
-    /**
-     * Shared secret for the site.
-     * @var string
-     */
-    private string $secret;
-
-    /**
-     * Method used to communicate with service. Defaults to POST request.
-     * @var RequestMethod
-     */
-    private ?RequestMethod $requestMethod;
-
     private string $hostname;
     private string $apkPackageName;
     private string $action;
@@ -137,18 +125,15 @@ class ReCaptcha
      * @param ?RequestMethod $requestMethod method used to send the request. Defaults to POST.
      * @throws \RuntimeException if $secret is invalid
      */
-    public function __construct(string $secret, ?RequestMethod $requestMethod = null)
+    public function __construct(private string $secret, private ?RequestMethod $requestMethod = null)
     {
         if (empty($secret)) {
             throw new \RuntimeException('No secret provided');
         }
 
-        if (!is_string($secret)) {
-            throw new \RuntimeException('The provided secret must be a string');
+        if (is_null($requestMethod)) {
+            $this->requestMethod = new RequestMethod\Post();
         }
-
-        $this->secret = $secret;
-        $this->requestMethod = (is_null($requestMethod)) ? new RequestMethod\Post() : $requestMethod;
     }
 
     /**

src/ReCaptcha/RequestMethod/Curl.php

@@ -43,7 +43,7 @@ class Curl
     /**
      * @see http://php.net/curl_init
      *
-     * @return resource cURL handle  *
+     * @return \CurlHandle|false cURL handle  *
      */
     public function init(?string $url = null)
     {
@@ -52,7 +52,7 @@ public function init(?string $url = null)
 
     /**
      * @see http://php.net/curl_setopt_array
-     * @param resource $ch
+     * @param \CurlHandle|false $ch
      */
     public function setoptArray($ch, array $options): bool
     {
@@ -61,7 +61,7 @@ public function setoptArray($ch, array $options): bool
 
     /**
      * @see http://php.net/curl_exec
-     * @param resource $ch
+     * @param \CurlHandle|false $ch
      */
     public function exec($ch): mixed
     {
@@ -70,7 +70,7 @@ public function exec($ch): mixed
 
     /**
      * @see http://php.net/curl_close
-     * @param resource $ch
+     * @param \CurlHandle|false $ch
      */
     public function close($ch): void
     {

src/ReCaptcha/RequestMethod/Socket.php

@@ -41,6 +41,9 @@
  */
 class Socket
 {
+    /**
+     * @var resource|false
+     */
     private $handle = null;
 
     /**