) * element or in the shared string element. * * @param string $value Value to escape * * @return string */ public static function controlCharacterPHP2OOXML($value = '') { if (empty(self::$controlCharacters)) { self::buildControlCharacters(); } return str_replace(array_values(self::$controlCharacters), array_keys(self::$controlCharacters), $value); } /** * Return a number formatted for being integrated in xml files. * * @param float $number * @param int $decimals * * @return string */ public static function numberFormat($number, $decimals) { return number_format($number, $decimals, '.', ''); } /** * @param int $dec * * @see http://stackoverflow.com/a/7153133/2235790 * * @author velcrow * * @return string */ public static function chr($dec) { if ($dec <= 0x7F) { return chr($dec); } if ($dec <= 0x7FF) { return chr(($dec >> 6) + 192) . chr(($dec & 63) + 128); } if ($dec <= 0xFFFF) { return chr(($dec >> 12) + 224) . chr((($dec >> 6) & 63) + 128) . chr(($dec & 63) + 128); } if ($dec <= 0x1FFFFF) { return chr(($dec >> 18) + 240) . chr((($dec >> 12) & 63) + 128) . chr((($dec >> 6) & 63) + 128) . chr(($dec & 63) + 128); } return ''; } /** * Convert from OpenXML escaped control character to PHP control character. * * @param string $value Value to unescape * * @return string */ public static function controlCharacterOOXML2PHP($value = '') { if (empty(self::$controlCharacters)) { self::buildControlCharacters(); } return str_replace(array_keys(self::$controlCharacters), array_values(self::$controlCharacters), $value); } /** * Check if a string contains UTF-8 data. * * @param string $value * * @return bool */ public static function isUTF8($value = '') { return is_string($value) && ($value === '' || preg_match('/^./su', $value) == 1); } /** * Return UTF8 encoded value. * * @param null|string $value * * @return ?string */ public static function toUTF8($value = '') { if (null !== $value && !self::isUTF8($value)) { // PHP8.2 : utf8_encode is deprecated, but mb_convert_encoding always usable $value = (function_exists('mb_convert_encoding')) ? mb_convert_encoding($value, 'UTF-8', 'ISO-8859-1') : utf8_encode($value); } return $value; } /** * Returns unicode from UTF8 text. * * The function is splitted to reduce cyclomatic complexity * * @param string $text UTF8 text * * @return string Unicode text * * @since 0.11.0 */ public static function toUnicode($text) { return self::unicodeToEntities(self::utf8ToUnicode($text)); } /** * Returns unicode array from UTF8 text. * * @param string $text UTF8 text * * @return array * * @since 0.11.0 * @see http://www.randomchaos.com/documents/?source=php_and_unicode */ public static function utf8ToUnicode($text) { $unicode = []; $values = []; $lookingFor = 1; // Gets unicode for each character for ($i = 0; $i < strlen($text); ++$i) { $thisValue = ord($text[$i]); if ($thisValue < 128) { $unicode[] = $thisValue; } else { if (count($values) == 0) { $lookingFor = $thisValue < 224 ? 2 : 3; } $values[] = $thisValue; if (count($values) == $lookingFor) { if ($lookingFor == 3) { $number = (($values[0] % 16) * 4096) + (($values[1] % 64) * 64) + ($values[2] % 64); } else { $number = (($values[0] % 32) * 64) + ($values[1] % 64); } $unicode[] = $number; $values = []; $lookingFor = 1; } } } return $unicode; } /** * Returns entites from unicode array. * * @param array $unicode * * @return string * * @since 0.11.0 * @see http://www.randomchaos.com/documents/?source=php_and_unicode */ private static function unicodeToEntities($unicode) { $entities = ''; foreach ($unicode as $value) { if ($value != 65279) { $entities .= $value > 127 ? '\uc0{\u' . $value . '}' : chr($value); } } return $entities; } /** * Return name without underscore for < 0.10.0 variable name compatibility. * * @param string $value * * @return string */ public static function removeUnderscorePrefix($value) { if (null !== $value) { if (substr($value, 0, 1) == '_') { $value = substr($value, 1); } } return $value; } }