xref: /dokuwiki/inc/compatibility.php (revision d4f83172d9533c4d84f450fe22ef630816b21d75)
16589c60cSAndreas Gohr<?php
2*d4f83172SAndreas Gohr
36589c60cSAndreas Gohr/**
46589c60cSAndreas Gohr * compatibility functions
56589c60cSAndreas Gohr *
66589c60cSAndreas Gohr * This file contains a few functions that might be missing from the PHP build
76589c60cSAndreas Gohr */
86589c60cSAndreas Gohr
96589c60cSAndreas Gohrif (!function_exists('ctype_space')) {
106589c60cSAndreas Gohr    /**
116589c60cSAndreas Gohr     * Check for whitespace character(s)
126589c60cSAndreas Gohr     *
136589c60cSAndreas Gohr     * @param string $text
146589c60cSAndreas Gohr     * @return bool
15a4c648ffSAndreas Gohr     * @see ctype_space
166589c60cSAndreas Gohr     */
17d868eb89SAndreas Gohr    function ctype_space($text)
18d868eb89SAndreas Gohr    {
196589c60cSAndreas Gohr        if (!is_string($text)) return false; #FIXME original treats between -128 and 255 inclusive as ASCII chars
206589c60cSAndreas Gohr        if (trim($text) === '') return true;
216589c60cSAndreas Gohr        return false;
226589c60cSAndreas Gohr    }
236589c60cSAndreas Gohr}
246589c60cSAndreas Gohr
256589c60cSAndreas Gohrif (!function_exists('ctype_digit')) {
266589c60cSAndreas Gohr    /**
276589c60cSAndreas Gohr     * Check for numeric character(s)
286589c60cSAndreas Gohr     *
296589c60cSAndreas Gohr     * @param string $text
306589c60cSAndreas Gohr     * @return bool
31a4c648ffSAndreas Gohr     * @see ctype_digit
326589c60cSAndreas Gohr     */
33d868eb89SAndreas Gohr    function ctype_digit($text)
34d868eb89SAndreas Gohr    {
356589c60cSAndreas Gohr        if (!is_string($text)) return false; #FIXME original treats between -128 and 255 inclusive as ASCII chars
366589c60cSAndreas Gohr        if (preg_match('/^\d+$/', $text)) return true;
376589c60cSAndreas Gohr        return false;
386589c60cSAndreas Gohr    }
396589c60cSAndreas Gohr}
4092b9f196SAndreas Gohr
4192b9f196SAndreas Gohrif (!function_exists('gzopen') && function_exists('gzopen64')) {
4292b9f196SAndreas Gohr    /**
4392b9f196SAndreas Gohr     * work around for PHP compiled against certain zlib versions #865
4492b9f196SAndreas Gohr     *
4592b9f196SAndreas Gohr     * @link http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
4692b9f196SAndreas Gohr     *
4792b9f196SAndreas Gohr     * @param string $filename
4892b9f196SAndreas Gohr     * @param string $mode
4992b9f196SAndreas Gohr     * @param int $use_include_path
5092b9f196SAndreas Gohr     * @return mixed
5192b9f196SAndreas Gohr     */
52d868eb89SAndreas Gohr    function gzopen($filename, $mode, $use_include_path = 0)
53d868eb89SAndreas Gohr    {
5492b9f196SAndreas Gohr        return gzopen64($filename, $mode, $use_include_path);
558457f8ceSAndreas Gohr    }
568457f8ceSAndreas Gohr}
578457f8ceSAndreas Gohr
588457f8ceSAndreas Gohrif (!function_exists('gzseek') && function_exists('gzseek64')) {
598457f8ceSAndreas Gohr    /**
608457f8ceSAndreas Gohr     * work around for PHP compiled against certain zlib versions #865
618457f8ceSAndreas Gohr     *
628457f8ceSAndreas Gohr     * @link http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
638457f8ceSAndreas Gohr     *
648457f8ceSAndreas Gohr     * @param resource $zp
658457f8ceSAndreas Gohr     * @param int $offset
668457f8ceSAndreas Gohr     * @param int $whence
678457f8ceSAndreas Gohr     * @return int
688457f8ceSAndreas Gohr     */
69d868eb89SAndreas Gohr    function gzseek($zp, $offset, $whence = SEEK_SET)
70d868eb89SAndreas Gohr    {
718457f8ceSAndreas Gohr        return gzseek64($zp, $offset, $whence);
728457f8ceSAndreas Gohr    }
738457f8ceSAndreas Gohr}
748457f8ceSAndreas Gohr
758457f8ceSAndreas Gohrif (!function_exists('gztell') && function_exists('gztell64')) {
768457f8ceSAndreas Gohr    /**
778457f8ceSAndreas Gohr     * work around for PHP compiled against certain zlib versions #865
788457f8ceSAndreas Gohr     *
798457f8ceSAndreas Gohr     * @link   http://stackoverflow.com/questions/23417519/php-zlib-gzopen-not-exists
808457f8ceSAndreas Gohr     *
818457f8ceSAndreas Gohr     * @param resource $zp
828457f8ceSAndreas Gohr     * @return int
838457f8ceSAndreas Gohr     */
84d868eb89SAndreas Gohr    function gztell($zp)
85d868eb89SAndreas Gohr    {
868457f8ceSAndreas Gohr        return gztell64($zp);
8792b9f196SAndreas Gohr    }
8892b9f196SAndreas Gohr}
89a4c648ffSAndreas Gohr
90a4c648ffSAndreas Gohr/**
91a4c648ffSAndreas Gohr * polyfill for PHP < 8
92a4c648ffSAndreas Gohr * @see https://www.php.net/manual/en/function.str-starts-with
93a4c648ffSAndreas Gohr */
94a4c648ffSAndreas Gohrif (!function_exists('str_starts_with')) {
95a4c648ffSAndreas Gohr    function str_starts_with(string $haystack, string $needle)
96a4c648ffSAndreas Gohr    {
97a4c648ffSAndreas Gohr        return empty($needle) || strpos($haystack, $needle) === 0;
98a4c648ffSAndreas Gohr    }
99a4c648ffSAndreas Gohr}
100a4c648ffSAndreas Gohr
101a4c648ffSAndreas Gohr/**
102a4c648ffSAndreas Gohr * polyfill for PHP < 8
103a4c648ffSAndreas Gohr * @see https://www.php.net/manual/en/function.str-contains
104a4c648ffSAndreas Gohr */
105a4c648ffSAndreas Gohrif (!function_exists('str_contains')) {
106a4c648ffSAndreas Gohr    function str_contains(string $haystack, string $needle)
107a4c648ffSAndreas Gohr    {
108a4c648ffSAndreas Gohr        return empty($needle) || strpos($haystack, $needle) !== false;
109a4c648ffSAndreas Gohr    }
110a4c648ffSAndreas Gohr}
111a4c648ffSAndreas Gohr
112a4c648ffSAndreas Gohr/**
113a4c648ffSAndreas Gohr * polyfill for PHP < 8
114a4c648ffSAndreas Gohr * @see https://www.php.net/manual/en/function.str-ends-with
115a4c648ffSAndreas Gohr */
116a4c648ffSAndreas Gohrif (!function_exists('str_ends_with')) {
117a4c648ffSAndreas Gohr    function str_ends_with(string $haystack, string $needle)
118a4c648ffSAndreas Gohr    {
119a4c648ffSAndreas Gohr        return empty($needle) || substr($haystack, -strlen($needle)) === $needle;
120a4c648ffSAndreas Gohr    }
121a4c648ffSAndreas Gohr}
122