• Docs
• Source
• Git

<?php namespace PHPFUI; /** * Various useful functions for manipulating text */ class TextHelper { /** * Converts a PHP array to a JavaScript array that can be used * directly as JavaScript (not JSON) * * @param array<string, mixed> $array of php values * - PHP scalars (except strings) will be converted to the corresponding JavaScript type * - strings must contain quoted strings to be represented as a string in JavaScript * - Unquoted strings will resolve to raw JavaScript * @param string $stringQuote optional quotes to use for string. * Include actual quotes in your string if you * need specify different quotes in different * places. * @param string $newLine Pass \n if you want human readable * output, appends to , in output */ public static function arrayToJS(array $array, string $stringQuote = '', string $newLine = '') : string {	$normalArray = \is_numeric(\key($array));	$js = $normalArray ? '[' : '{';	$comma = ''; foreach ($array as $key => $value)	{	$js .= $comma; if (! $normalArray)	{ // use object notation if (! \ctype_alpha($key[0]))	{	$key = "{$stringQuote}{$key}{$stringQuote}";	}	$js .= $key . ':';	}	$comma = ',' . $newLine; switch (\gettype($value))	{ /** @noinspection PhpMissingBreakStatementInspection */ case 'object':	$value = \json_decode(\json_encode($value), true, 512); // Intentionally fall through case 'array':	$js .= self::arrayToJS($value, $stringQuote); break; case 'boolean':	$js .= $value ? 'true' : 'false'; break; /** @noinspection PhpMissingBreakStatementInspection */ case 'string':	$value = "{$stringQuote}{$value}{$stringQuote}"; // Intentionally fall through case 'integer': case 'double':	$js .= $value; break; case 'resource': case 'NULL': case 'unknown type':	$js .= 'null';	}	} return $js . ($normalArray ? ']' : '}');	} /** * Split a string into words based on capital letters. Successive capital letters are considered an abbreviation and grouped together. */ public static function capitalSplit(string $key) : string {	$len = \strlen($key);	$space = $output = '';	$lastCapitalized = false;	$consecutiveCaps = 0; for ($i = 0; $i < $len; ++$i)	{	$char = $key[$i]; if (0 == $i)	{	$char = \strtoupper($char);	} if (\ctype_upper($char))	{ if (! $lastCapitalized)	{	$output .= $space;	}	++$consecutiveCaps;	$space = ' ';	$lastCapitalized = true;	} elseif ($lastCapitalized)	{	$length = \strlen($output); if ($length > 1 && $consecutiveCaps > 1)	{	$output = \substr($output, 0, $length - 1) . ' ' . $output[$length - 1];	}	$consecutiveCaps = 0;	$lastCapitalized = false;	}	$output .= $char;	} return $output;	} /** * Shorthand to encode a string in UTF-8 * * @param ?string $string to encode */ public static function htmlentities(?string $string) : string { if (! $string)	{ return '';	} return \htmlentities($string, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8', false);	} /** @param array<string> $match */ public static function replace_unicode_escape_sequence(array $match) : string { return \mb_convert_encoding(\pack('H*', $match[1]), 'UTF-8', 'UCS-2BE');	} /** * Decode hmtl entities * * @param ?string $string to decode */ public static function unhtmlentities(?string $string) : string { if (! $string)	{ return '';	} return \htmlspecialchars_decode($string, ENT_QUOTES | ENT_HTML5);	} public static function unicode_decode(string $str) : string { return \preg_replace_callback('/\\\\u([0-9a-f]{4})/i', '\PHPFUI\TextHelper::replace_unicode_escape_sequence', $str);	}	}