Specify types for all function parameters

Removes PHP 8.4 depreciation warnings and just good style

Author: phpfui

src/ReCaptcha/ReCaptcha.php

@@ -136,7 +136,7 @@ class ReCaptcha
      * @param RequestMethod $requestMethod method used to send the request. Defaults to POST.
      * @throws \RuntimeException if $secret is invalid
      */
-    public function __construct($secret, RequestMethod $requestMethod = null)
+    public function __construct($secret, ?RequestMethod $requestMethod = null)
     {
         if (empty($secret)) {
             throw new \RuntimeException('No secret provided');
@@ -158,7 +158,7 @@ public function __construct($secret, RequestMethod $requestMethod = null)
      * @param string $remoteIp The end user's IP address.
      * @return Response Response from the service.
      */
-    public function verify($response, $remoteIp = null)
+    public function verify(string $response, ?string $remoteIp = null)
     {
         // Discard empty solution submissions
         if (empty($response)) {
@@ -217,7 +217,7 @@ public function verify($response, $remoteIp = null)
      * @param string $hostname Expected hostname
      * @return ReCaptcha Current instance for fluent interface
      */
-    public function setExpectedHostname($hostname)
+    public function setExpectedHostname(string $hostname)
     {
         $this->hostname = $hostname;
         return $this;
@@ -229,7 +229,7 @@ public function setExpectedHostname($hostname)
      * @param string $apkPackageName Expected APK package name
      * @return ReCaptcha Current instance for fluent interface
      */
-    public function setExpectedApkPackageName($apkPackageName)
+    public function setExpectedApkPackageName(string $apkPackageName)
     {
         $this->apkPackageName = $apkPackageName;
         return $this;
@@ -242,7 +242,7 @@ public function setExpectedApkPackageName($apkPackageName)
      * @param string $action Expected action
      * @return ReCaptcha Current instance for fluent interface
      */
-    public function setExpectedAction($action)
+    public function setExpectedAction(string $action)
     {
         $this->action = $action;
         return $this;
@@ -255,7 +255,7 @@ public function setExpectedAction($action)
      * @param float $threshold Expected threshold
      * @return ReCaptcha Current instance for fluent interface
      */
-    public function setScoreThreshold($threshold)
+    public function setScoreThreshold(float $threshold)
     {
         $this->threshold = floatval($threshold);
         return $this;
@@ -267,7 +267,7 @@ public function setScoreThreshold($threshold)
      * @param int $timeoutSeconds Expected hostname
      * @return ReCaptcha Current instance for fluent interface
      */
-    public function setChallengeTimeout($timeoutSeconds)
+    public function setChallengeTimeout(int $timeoutSeconds)
     {
         $this->timeoutSeconds = $timeoutSeconds;
         return $this;

src/ReCaptcha/RequestMethod/Curl.php

@@ -44,7 +44,7 @@ class Curl
      * @param string $url
      * @return resource cURL handle
      */
-    public function init($url = null)
+    public function init(?string $url = null)
     {
         return curl_init($url);
     }

src/ReCaptcha/RequestMethod/CurlPost.php

@@ -63,7 +63,7 @@ class CurlPost implements RequestMethod
      * @param Curl $curl Curl resource
      * @param string $siteVerifyUrl URL for reCAPTCHA siteverify API
      */
-    public function __construct(Curl $curl = null, $siteVerifyUrl = null)
+    public function __construct(?Curl $curl = null, ?string $siteVerifyUrl = null)
     {
         $this->curl = (is_null($curl)) ? new Curl() : $curl;
         $this->siteVerifyUrl = (is_null($siteVerifyUrl)) ? ReCaptcha::SITE_VERIFY_URL : $siteVerifyUrl;

src/ReCaptcha/RequestMethod/Post.php

@@ -54,7 +54,7 @@ class Post implements RequestMethod
      *
      * @param string $siteVerifyUrl URL for reCAPTCHA siteverify API
      */
-    public function __construct($siteVerifyUrl = null)
+    public function __construct(?string $siteVerifyUrl = null)
     {
         $this->siteVerifyUrl = (is_null($siteVerifyUrl)) ? ReCaptcha::SITE_VERIFY_URL : $siteVerifyUrl;
     }

src/ReCaptcha/RequestMethod/Socket.php

@@ -53,7 +53,7 @@ class Socket
      * @param float $timeout
      * @return resource
      */
-    public function fsockopen($hostname, $port = -1, &$errno = 0, &$errstr = '', $timeout = null)
+    public function fsockopen(string $hostname, int $port = -1, int &$errno = 0, string &$errstr = '', ?float $timeout = null)
     {
         $this->handle = fsockopen($hostname, $port, $errno, $errstr, (is_null($timeout) ? ini_get("default_socket_timeout") : $timeout));
 
@@ -71,7 +71,7 @@ public function fsockopen($hostname, $port = -1, &$errno = 0, &$errstr = '', $ti
      * @param int $length
      * @return int | bool
      */
-    public function fwrite($string, $length = null)
+    public function fwrite(string $string, ?int $length = null)
     {
         return fwrite($this->handle, $string, (is_null($length) ? strlen($string) : $length));
     }
@@ -83,7 +83,7 @@ public function fwrite($string, $length = null)
      * @param int $length
      * @return string
      */
-    public function fgets($length = null)
+    public function fgets(?int $length = null)
     {
         return fgets($this->handle, $length);
     }

src/ReCaptcha/RequestMethod/SocketPost.php

@@ -59,7 +59,7 @@ class SocketPost implements RequestMethod
      * @param \ReCaptcha\RequestMethod\Socket $socket optional socket, injectable for testing
      * @param string $siteVerifyUrl URL for reCAPTCHA siteverify API
      */
-    public function __construct(Socket $socket = null, $siteVerifyUrl = null)
+    public function __construct(?Socket $socket = null, ?string $siteVerifyUrl = null)
     {
         $this->socket = (is_null($socket)) ? new Socket() : $socket;
         $this->siteVerifyUrl = (is_null($siteVerifyUrl)) ? ReCaptcha::SITE_VERIFY_URL : $siteVerifyUrl;

src/ReCaptcha/RequestParameters.php

@@ -71,7 +71,7 @@ class RequestParameters
      * @param string $remoteIp User's IP address.
      * @param string $version Version of this client library.
      */
-    public function __construct($secret, $response, $remoteIp = null, $version = null)
+    public function __construct(string $secret, string $response, ?string $remoteIp = null, ?string $version = null)
     {
         $this->secret = $secret;
         $this->response = $response;

src/ReCaptcha/Response.php

@@ -87,7 +87,7 @@ class Response
      * @param string $json
      * @return \ReCaptcha\Response
      */
-    public static function fromJson($json)
+    public static function fromJson(string $json)
     {
         $responseData = json_decode($json, true);
 
@@ -123,7 +123,7 @@ public static function fromJson($json)
      * @param string $action
      * @param array $errorCodes
      */
-    public function __construct($success, array $errorCodes = array(), $hostname = '', $challengeTs = '', $apkPackageName = '', $score = null, $action = '')
+    public function __construct(bool $success, array $errorCodes = [], string $hostname = '', string $challengeTs = '', string $apkPackageName = '', ?float $score = null, string $action = '')
     {
         $this->success = $success;
         $this->hostname = $hostname;