inc/compatibility.php

   1 <?php
   2
   3 /**
   4  * compatibility functions
   5  *
   6  * This file contains a few functions that might be missing from the PHP build
   7  */
   8
   9 if (!function_exists('ctype_space')) {
  10     /**
  11      * Check for whitespace character(s)
  12      *
  13      * @param string $text
  14      * @return bool
  15      * @see ctype_space
  16      */
  17     function ctype_space($text)
  18     {
  19         if (!is_string($text)) return false; #FIXME original treats between -128 and 255 inclusive as ASCII chars
  20         if (trim($text) === '') return true;
  21         return false;
  22     }
  23 }
  24
  25 if (!function_exists('ctype_digit')) {
  26     /**
  27      * Check for numeric character(s)
  28      *
  29      * @param string $text
  30      * @return bool
  31      * @see ctype_digit
  32      */
  33     function ctype_digit($text)
  34     {
  35         if (!is_string($text)) return false; #FIXME original treats between -128 and 255 inclusive as ASCII chars
  36         if (preg_match('/^\d+$/', $text)) return true;
  37         return false;
  38     }
  39 }
  40
  41 if (!function_exists('gzopen') && function_exists('gzopen64')) {
  42     /**
  43      * work around for PHP compiled against certain zlib versions #865
  44      *
  45      * @link http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
  46      *
  47      * @param string $filename
  48      * @param string $mode
  49      * @param int $use_include_path
  50      * @return mixed
  51      */
  52     function gzopen($filename, $mode, $use_include_path = 0)
  53     {
  54         return gzopen64($filename, $mode, $use_include_path);
  55     }
  56 }
  57
  58 if (!function_exists('gzseek') && function_exists('gzseek64')) {
  59     /**
  60      * work around for PHP compiled against certain zlib versions #865
  61      *
  62      * @link http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
  63      *
  64      * @param resource $zp
  65      * @param int $offset
  66      * @param int $whence
  67      * @return int
  68      */
  69     function gzseek($zp, $offset, $whence = SEEK_SET)
  70     {
  71         return gzseek64($zp, $offset, $whence);
  72     }
  73 }
  74
  75 if (!function_exists('gztell') && function_exists('gztell64')) {
  76     /**
  77      * work around for PHP compiled against certain zlib versions #865
  78      *
  79      * @link   http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
  80      *
  81      * @param resource $zp
  82      * @return int
  83      */
  84     function gztell($zp)
  85     {
  86         return gztell64($zp);
  87     }
  88 }
  89
  90 /**
  91  * polyfill for PHP < 8
  92  * @see https://www.php.net/manual/en/function.str-starts-with
  93  */
  94 if (!function_exists('str_starts_with')) {
  95     function str_starts_with(?string $haystack, ?string $needle)
  96     {
  97         return 0 === strncmp($haystack, $needle, \strlen($needle));
  98     }
  99 }
 100
 101 /**
 102  * polyfill for PHP < 8
 103  * @see https://www.php.net/manual/en/function.str-contains
 104  */
 105 if (!function_exists('str_contains')) {
 106     function str_contains(?string $haystack, ?string $needle)
 107     {
 108         return '' === $needle || false !== strpos($haystack, $needle);
 109     }
 110 }
 111
 112 /**
 113  * polyfill for PHP < 8
 114  * @see https://www.php.net/manual/en/function.str-ends-with
 115  */
 116 if (!function_exists('str_ends_with')) {
 117     function str_ends_with(?string $haystack, ?string $needle)
 118     {
 119         if ('' === $needle || $needle === $haystack) {
 120             return true;
 121         }
 122
 123         if ('' === $haystack) {
 124             return false;
 125         }
 126
 127         $needleLength = \strlen($needle);
 128
 129         return $needleLength <= \strlen($haystack) && 0 === substr_compare($haystack, $needle, -$needleLength);
 130     }
 131 }
 132
 133 /**
 134  * polyfill for PHP < 8.1
 135  * @see https://www.php.net/manual/en/function.array-is-list
 136  */
 137 if (!function_exists('array_is_list')) {
 138     function array_is_list(array $arr)
 139     {
 140         if ($arr === []) {
 141             return true;
 142         }
 143         return array_keys($arr) === range(0, count($arr) - 1);
 144     }
 145 }