<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Input validation utilities.

[2] Fix | Delete

*

[3] Fix | Delete

* @package Requests\Utilities

[4] Fix | Delete

*/

[5] Fix | Delete

[6] Fix | Delete

namespace WpOrg\Requests\Utility;

[7] Fix | Delete

[8] Fix | Delete

use ArrayAccess;

[9] Fix | Delete

use CurlHandle;

[10] Fix | Delete

use Traversable;

[11] Fix | Delete

[12] Fix | Delete

/**

[13] Fix | Delete

* Input validation utilities.

[14] Fix | Delete

*

[15] Fix | Delete

* @package Requests\Utilities

[16] Fix | Delete

*/

[17] Fix | Delete

final class InputValidator {

[18] Fix | Delete

[19] Fix | Delete

/**

[20] Fix | Delete

* Verify that a received input parameter is of type string or is "stringable".

[21] Fix | Delete

*

[22] Fix | Delete

* @param mixed $input Input parameter to verify.

[23] Fix | Delete

*

[24] Fix | Delete

* @return bool

[25] Fix | Delete

*/

[26] Fix | Delete

public static function is_string_or_stringable($input) {

[27] Fix | Delete

return is_string($input) || self::is_stringable_object($input);

[28] Fix | Delete

}

[29] Fix | Delete

[30] Fix | Delete

/**

[31] Fix | Delete

* Verify whether a received input parameter is usable as an integer array key.

[32] Fix | Delete

*

[33] Fix | Delete

* @param mixed $input Input parameter to verify.

[34] Fix | Delete

*

[35] Fix | Delete

* @return bool

[36] Fix | Delete

*/

[37] Fix | Delete

public static function is_numeric_array_key($input) {

[38] Fix | Delete

if (is_int($input)) {

[39] Fix | Delete

return true;

[40] Fix | Delete

}

[41] Fix | Delete

[42] Fix | Delete

if (!is_string($input)) {

[43] Fix | Delete

return false;

[44] Fix | Delete

}

[45] Fix | Delete

[46] Fix | Delete

return (bool) preg_match('`^-?[0-9]+$`', $input);

[47] Fix | Delete

}

[48] Fix | Delete

[49] Fix | Delete

/**

[50] Fix | Delete

* Verify whether a received input parameter is "stringable".

[51] Fix | Delete

*

[52] Fix | Delete

* @param mixed $input Input parameter to verify.

[53] Fix | Delete

*

[54] Fix | Delete

* @return bool

[55] Fix | Delete

*/

[56] Fix | Delete

public static function is_stringable_object($input) {

[57] Fix | Delete

return is_object($input) && method_exists($input, '__toString');

[58] Fix | Delete

}

[59] Fix | Delete

[60] Fix | Delete

/**

[61] Fix | Delete

* Verify whether a received input parameter is _accessible as if it were an array_.

[62] Fix | Delete

*

[63] Fix | Delete

* @param mixed $input Input parameter to verify.

[64] Fix | Delete

*

[65] Fix | Delete

* @return bool

[66] Fix | Delete

*/

[67] Fix | Delete

public static function has_array_access($input) {

[68] Fix | Delete

return is_array($input) || $input instanceof ArrayAccess;

[69] Fix | Delete

}

[70] Fix | Delete

[71] Fix | Delete

/**

[72] Fix | Delete

* Verify whether a received input parameter is "iterable".

[73] Fix | Delete

*

[74] Fix | Delete

* @internal The PHP native `is_iterable()` function was only introduced in PHP 7.1

[75] Fix | Delete

* and this library still supports PHP 5.6.

[76] Fix | Delete

*

[77] Fix | Delete

* @param mixed $input Input parameter to verify.

[78] Fix | Delete

*

[79] Fix | Delete

* @return bool

[80] Fix | Delete

*/

[81] Fix | Delete

public static function is_iterable($input) {

[82] Fix | Delete

return is_array($input) || $input instanceof Traversable;

[83] Fix | Delete

}

[84] Fix | Delete

[85] Fix | Delete

/**

[86] Fix | Delete

* Verify whether a received input parameter is a Curl handle.

[87] Fix | Delete

*

[88] Fix | Delete

* The PHP Curl extension worked with resources prior to PHP 8.0 and with

[89] Fix | Delete

* an instance of the `CurlHandle` class since PHP 8.0.

[90] Fix | Delete

* {@link https://www.php.net/manual/en/migration80.incompatible.php#migration80.incompatible.resource2object}

[91] Fix | Delete

*

[92] Fix | Delete

* @param mixed $input Input parameter to verify.

[93] Fix | Delete

*

[94] Fix | Delete

* @return bool

[95] Fix | Delete

*/

[96] Fix | Delete

public static function is_curl_handle($input) {

[97] Fix | Delete

if (is_resource($input)) {

[98] Fix | Delete

return get_resource_type($input) === 'curl';

[99] Fix | Delete

}

[100] Fix | Delete

[101] Fix | Delete

if (is_object($input)) {

[102] Fix | Delete

return $input instanceof CurlHandle;

[103] Fix | Delete

}

[104] Fix | Delete

[105] Fix | Delete

return false;

[106] Fix | Delete

}

[107] Fix | Delete

}

[108] Fix | Delete

[109] Fix | Delete