From 80d3db1dcf8fe9ca66d4e3f2e2116d3bc39ae2b4 Mon Sep 17 00:00:00 2001 From: Andrew Dolgov Date: Tue, 12 Jul 2022 22:26:21 +0300 Subject: upgrade idiorm to php8.1-patched version (aaronpk/idiorm) --- vendor/thecodingmachine/safe/generated/url.php | 90 +++++++++++++++++++++----- 1 file changed, 75 insertions(+), 15 deletions(-) (limited to 'vendor/thecodingmachine/safe/generated/url.php') diff --git a/vendor/thecodingmachine/safe/generated/url.php b/vendor/thecodingmachine/safe/generated/url.php index 56c08b551..5871e6dc6 100644 --- a/vendor/thecodingmachine/safe/generated/url.php +++ b/vendor/thecodingmachine/safe/generated/url.php @@ -5,9 +5,9 @@ namespace Safe; use Safe\Exceptions\UrlException; /** - * Decodes a base64 encoded data. + * Decodes a base64 encoded string. * - * @param string $data The encoded data. + * @param string $string The encoded data. * @param bool $strict If the strict parameter is set to TRUE * then the base64_decode function will return * FALSE if the input contains character from outside the base64 @@ -17,10 +17,10 @@ use Safe\Exceptions\UrlException; * @throws UrlException * */ -function base64_decode(string $data, bool $strict = false): string +function base64_decode(string $string, bool $strict = false): string { error_clear_last(); - $result = \base64_decode($data, $strict); + $result = \base64_decode($string, $strict); if ($result === false) { throw UrlException::createFromPhpError(); } @@ -33,22 +33,23 @@ function base64_decode(string $data, bool $strict = false): string * by the server in response to a HTTP request. * * @param string $url The target URL. - * @param int $format If the optional format parameter is set to non-zero, + * @param bool $associative If the optional associative parameter is set to true, * get_headers parses the response and sets the * array's keys. * @param resource $context A valid context resource created with - * stream_context_create. + * stream_context_create, or NULL to use the + * default context. * @return array Returns an indexed or associative array with the headers. * @throws UrlException * */ -function get_headers(string $url, int $format = 0, $context = null): array +function get_headers(string $url, bool $associative = false, $context = null): array { error_clear_last(); if ($context !== null) { - $result = \get_headers($url, $format, $context); + $result = \get_headers($url, $associative, $context); } else { - $result = \get_headers($url, $format); + $result = \get_headers($url, $associative); } if ($result === false) { throw UrlException::createFromPhpError(); @@ -57,18 +58,64 @@ function get_headers(string $url, int $format = 0, $context = null): array } +/** + * Opens filename and parses it line by line for + * <meta> tags in the file. The parsing stops at + * </head>. + * + * @param string $filename The path to the HTML file, as a string. This can be a local file or an + * URL. + * + * + * What get_meta_tags parses + * + * + * + * + * + * + * ]]> + * + * + * @param bool $use_include_path Setting use_include_path to TRUE will result + * in PHP trying to open the file along the standard include path as per + * the include_path directive. + * This is used for local files, not URLs. + * @return array Returns an array with all the parsed meta tags. + * + * The value of the name property becomes the key, the value of the content + * property becomes the value of the returned array, so you can easily use + * standard array functions to traverse it or access single values. + * Special characters in the value of the name property are substituted with + * '_', the rest is converted to lower case. If two meta tags have the same + * name, only the last one is returned. + * + * Returns FALSE on failure. + * @throws UrlException + * + */ +function get_meta_tags(string $filename, bool $use_include_path = false): array +{ + error_clear_last(); + $result = \get_meta_tags($filename, $use_include_path); + if ($result === false) { + throw UrlException::createFromPhpError(); + } + return $result; +} + + /** * This function parses a URL and returns an associative array containing any * of the various components of the URL that are present. * The values of the array elements are not URL decoded. * * This function is not meant to validate - * the given URL, it only breaks it up into the above listed parts. Partial + * the given URL, it only breaks it up into the parts listed below. Partial and invalid * URLs are also accepted, parse_url tries its best to * parse them correctly. * - * @param string $url The URL to parse. Invalid characters are replaced by - * _. + * @param string $url The URL to parse. * @param int $component Specify one of PHP_URL_SCHEME, * PHP_URL_HOST, PHP_URL_PORT, * PHP_URL_USER, PHP_URL_PASS, @@ -76,8 +123,8 @@ function get_headers(string $url, int $format = 0, $context = null): array * or PHP_URL_FRAGMENT to retrieve just a specific * URL component as a string (except when * PHP_URL_PORT is given, in which case the return - * value will be an integer). - * @return mixed On seriously malformed URLs, parse_url. + * value will be an int). + * @return array|int|string|null On seriously malformed URLs, parse_url. * * If the component parameter is omitted, an * associative array is returned. At least one element will be @@ -127,9 +174,22 @@ function get_headers(string $url, int $format = 0, $context = null): array * * If the component parameter is specified, * parse_url returns a string (or an - * integer, in the case of PHP_URL_PORT) + * int, in the case of PHP_URL_PORT) * instead of an array. If the requested component doesn't exist * within the given URL, NULL will be returned. + * As of PHP 8.0.0, parse_url distinguishes absent and empty + * queries and fragments: + * + * + * + * + * + * + * + * Previously all cases resulted in query and fragment being NULL. + * + * Note that control characters (cf. ctype_cntrl) in the + * components are replaced with underscores (_). * @throws UrlException * */ -- cgit v1.2.3