Text handling methods.
_wordWrap( string $text , integer $width 72 , string $break "\n" , boolean $cut false )
Unicode aware version of wordwrap as helper method.
$text $width optional 72 $break optional "\n" $cut optional false stringascii( array $array )
Converts the decimal value of a multibyte character string to a string
$array stringcleanInsert( string $str , array $options )
Cleans up a Text::insert() formatted string with given $options depending on the 'clean' key in $options. The default method used is text but html is also available. The goal of this function is to replace all whitespace and unneeded markup around placeholders that did not get replaced by Text::insert().
$str $options stringCake\Utility\Text::insert()excerpt( string $text , string $phrase , integer $radius 100 , string $ellipsis '...' )
Extracts an excerpt from the text surrounding the phrase with a number of characters on each side determined by radius.
$text $phrase $radius optional 100 $ellipsis optional '...' stringhighlight( string $text , string|array $phrase , array $options [] )
Highlights a given phrase in a text. You can specify any expression in highlighter that may include the \1 expression to include the $phrase found.
format The piece of HTML with that the phrase will be highlightedhtml If true, will ignore any HTML tags, ensuring that only the correct text is highlightedregex a custom regex rule that is used to match words, default is '|$tag|iu'$text $phrase $options optional [] stringinsert( string $str , array $data , array $options [] )
Replaces variable placeholders inside a $str with any given $data. Each key in the $data array corresponds to a variable placeholder name in $str. Example:
Text::insert(':name is :age years old.', ['name' => 'Bob', '65']);
Returns: Bob is 65 years old.
Available $options are:
:)\)/(?<!\)\:%s/ (Overwrites before, after, breaks escape / clean)$str $data $options optional [] stringisMultibyte( string $string )
Check if the string contain multibyte characters
$string booleanparseFileSize( string $size , mixed $default false )
Converts filesize from human readable string to bytes
$size $default optional false mixed$default on failure if not falseInvalidArgumentExceptionstripLinks( string $text )
Strips given text of all links (<a href=....).
$text stringtail( string $text , integer $length 100 , array $options [] )
Truncates text starting from the end.
Cuts a string to the length of $length and replaces the first characters with the ellipsis if the text is longer than length.
ellipsis Will be used as Beginning and prepended to the trimmed stringexact If false, $text will not be cut mid-word$text $length optional 100 $options optional [] stringtoList( array $list , string $and null , string $separator ', ' )
Creates a comma separated list where the last two items are joined with 'and', forming natural language.
$list $and optional null $separator optional ', ' stringtokenize( string $data , string $separator ',' , string $leftBound '(' , string $rightBound ')' ) Tokenizes a string using $separator, ignoring any instance of $separator that appears between $leftBound and $rightBound.
$data $separator optional ',' $leftBound optional '(' $rightBound optional ')' array|stringtruncate( string $text , integer $length 100 , array $options [] )
Truncates text.
Cuts a string to the length of $length and replaces the last characters with the ellipsis if the text is longer than length.
ellipsis Will be used as ending and appended to the trimmed stringexact If false, $text will not be cut mid-wordhtml If true, HTML tags would be handled correctly$text $length optional 100 $options optional [] stringutf8( string $string )
Converts a multibyte character string to the decimal value of the character
$string arrayuuid( )
Generate a random UUID version 4
Warning: This method should not be used as a random seed for any cryptographic operations. Instead you should use the openssl or mcrypt extensions.
stringwordWrap( string $text , integer $width 72 , string $break "\n" , boolean $cut false )
Unicode and newline aware version of wordwrap.
$text $width optional 72 $break optional "\n" $cut optional false stringwrap( string $text , array|integer $options [] )
Wraps text to a specific width, can optionally wrap at word breaks.
width The width to wrap to. Defaults to 72.wordWrap Only wrap on words breaks (spaces) Defaults to true.indent String to indent with. Defaults to null.indentAt 0 based index to start indenting at. Defaults to 0.$text $options optional [] stringwrapBlock( string $text , array|integer $options [] )
Wraps a complete block of text to a specific width, can optionally wrap at word breaks.
width The width to wrap to. Defaults to 72.wordWrap Only wrap on words breaks (spaces) Defaults to true.indent String to indent with. Defaults to null.indentAt 0 based index to start indenting at. Defaults to 0.$text $options optional [] string
© 2005–2016 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
http://api.cakephp.org/3.1/class-Cake.Utility.Text.html