+
+ /**
+ * Check if the first string starts with the second
+ *
+ * @see http://maettig.com/code/php/php-performance-benchmarks.php#startswith
+ * @param string $string
+ * @param string $start
+ * @return bool
+ */
+ public static function startsWith(string $string, string $start): bool
+ {
+ $return = substr_compare($string, $start, 0, strlen($start)) === 0;
+
+ return $return;
+ }
+
+ /**
+ * Checks if the first string ends with the second
+ *
+ * @see http://maettig.com/code/php/php-performance-benchmarks.php#endswith
+ * @param string $string
+ * @param string $end
+ *
+ * @return bool
+ */
+ public static function endsWith(string $string, string $end): bool
+ {
+ return (substr_compare($string, $end, -strlen($end)) === 0);
+ }
+
+ /**
+ * Returns the regular expression string to match URLs in a given text
+ *
+ * @return string
+ */
+ public static function autoLinkRegEx(): string
+ {
+ return '@
+(?<![=\'\]"/]) # Not preceded by [, =, \', ], ", /
+\b
+( # Capture 1: entire matched URL
+ ' . self::linkRegEx() . '
+)@xiu';
+ }
+
+ /**
+ * Returns the regular expression string to match only an HTTP URL
+ *
+ * @return string
+ */
+ public static function onlyLinkRegEx(): string
+ {
+ return '@^' . self::linkRegEx() . '$@xiu';
+ }
+
+ /**
+ * @return string
+ * @see https://daringfireball.net/2010/07/improved_regex_for_matching_urls
+ */
+ private static function linkRegEx(): string
+ {
+ return 'https?:// # http or https protocol
+ (?:
+ [^/\s\xA0`!()\[\]{};:\'",<>?«»“”‘’.] # Domain can\'t start with a .
+ [^/\s\xA0`!()\[\]{};:\'",<>?«»“”‘’]+ # Domain can\'t end with a .
+ \.
+ [^/\s\xA0`!()\[\]{};:\'".,<>?«»“”‘’]+/? # Followed by a slash
+ )
+ (?: # One or more:
+ [^\s\xA0()<>]+ # Run of non-space, non-()<>
+ | # or
+ \(([^\s\xA0()<>]+|(\([^\s()<>]+\)))*\) # balanced parens, up to 2 levels
+ | # or
+ [^\s\xA0`!()\[\]{};:\'".,<>?«»“”‘’] # not a space or one of these punct chars
+ )*';
+ }
+
+ /**
+ * Ensures a single path item doesn't contain any path-traversing characters
+ *
+ * @param string $pathItem
+ *
+ * @see https://stackoverflow.com/a/46097713
+ * @return string
+ */
+ public static function sanitizeFilePathItem(string $pathItem): string
+ {
+ $pathItem = str_replace('/', '_', $pathItem);
+ $pathItem = str_replace('\\', '_', $pathItem);
+ $pathItem = str_replace(DIRECTORY_SEPARATOR, '_', $pathItem); // In case it does not equal the standard values
+
+ return $pathItem;
+ }
+
+ /**
+ * Multi-byte safe implementation of substr_replace where $start and $length are character offset and count rather
+ * than byte offset and counts.
+ *
+ * Depends on mbstring, use default encoding.
+ *
+ * @param string $string
+ * @param string $replacement
+ * @param int $start
+ * @param int|null $length
+ *
+ * @return string
+ * @see substr_replace()
+ */
+ public static function substringReplace(string $string, string $replacement, int $start, int $length = null): string
+ {
+ $string_length = mb_strlen($string);
+
+ $length = $length ?? $string_length;
+
+ if ($start < 0) {
+ $start = max(0, $string_length + $start);
+ } else if ($start > $string_length) {
+ $start = $string_length;
+ }
+
+ if ($length < 0) {
+ $length = max(0, $string_length - $start + $length);
+ } else if ($length > $string_length) {
+ $length = $string_length;
+ }
+
+ if (($start + $length) > $string_length) {
+ $length = $string_length - $start;
+ }
+
+ return mb_substr($string, 0, $start) . $replacement . mb_substr($string, $start + $length, $string_length - $start - $length);
+ }
+
+ /**
+ * Perform a custom function on a text after having escaped blocks matched by the provided regular expressions.
+ * Only full matches are used, capturing group are ignored.
+ *
+ * To change the provided text, the callback function needs to return it and this function will return the modified
+ * version as well after having restored the escaped blocks.
+ *
+ * @param string $text
+ * @param string $regex
+ * @param callable $callback
+ *
+ * @return string
+ */
+ public static function performWithEscapedBlocks(string $text, string $regex, callable $callback): string
+ {
+ // Enables nested use
+ $executionId = random_int(PHP_INT_MAX / 10, PHP_INT_MAX);
+
+ $blocks = [];
+
+ $return = preg_replace_callback($regex,
+ function ($matches) use ($executionId, &$blocks) {
+ $return = '«block-' . $executionId . '-' . count($blocks) . '»';
+
+ $blocks[] = $matches[0];
+
+ return $return;
+ },
+ $text
+ );
+
+ if (is_null($return)) {
+ Logger::notice('Received null value from preg_replace_callback', ['text' => $text, 'regex' => $regex, 'blocks' => $blocks, 'executionId' => $executionId, 'callstack' => System::callstack(10)]);
+ }
+
+ $text = $callback($return ?? $text) ?? '';
+
+ // Restore code blocks
+ $text = preg_replace_callback('/«block-' . $executionId . '-([0-9]+)»/iU',
+ function ($matches) use ($blocks) {
+ $return = $matches[0];
+ if (isset($blocks[intval($matches[1])])) {
+ $return = $blocks[$matches[1]];
+ }
+ return $return;
+ },
+ $text
+ );
+
+ return $text;
+ }
+
+ /**
+ * This function converts a PHP's shorhand notation string for file sizes in to an integer number of total bytes.
+ * For example: The string for shorthand notation of '2M' (which is 2,097,152 Bytes) is converted to 2097152
+ * @see https://www.php.net/manual/en/faq.using.php#faq.using.shorthandbytes
+ * @param string $shorthand
+ * @return int
+ */
+ public static function getBytesFromShorthand(string $shorthand): int
+ {
+ $shorthand = trim($shorthand);
+
+ if (is_numeric($shorthand)) {
+ return $shorthand;
+ }
+
+ $last = strtolower($shorthand[strlen($shorthand)-1]);
+ $shorthand = substr($shorthand, 0, -1);
+
+ switch($last) {
+ case 'g':
+ $shorthand *= 1024;
+ case 'm':
+ $shorthand *= 1024;
+ case 'k':
+ $shorthand *= 1024;
+ }
+
+ return $shorthand;
+ }
+