PHP RFC: Grapheme cluster for str_split function: grapheme_str_split

• Version: 0.1
• Date: 2024-03-04
• Author: Yuya Hamada, youkidearitai@gmail.com
• Status: Draft
• First Published at: http://wiki.php.net/rfc/grapheme_str_split

I noticed PHP does not have a grapheme cluster based str_split function. So I think need str_split for grapheme cluster, grapheme_str_split function using ICU. Creating this function in the Intl extension would provide stronger support for grapheme clusters.

This feature will allow to correctly handle emoji and Variation Selectors.

grapheme_str_split function is correctly support for grapheme cluster.

$ sapi/cli/php -r 'var_dump(grapheme_str_split("🙇‍♂️"));'
array(1) {
  [0]=>
  string(13) "🙇‍♂️"
}

For example, compare to mb_str_split function, mb_str_split function is str_split for Unicode codepoint. (Of course, sometimes this is more convenient.)

$ sapi/cli/php -r 'var_dump(mb_str_split("🙇‍♂️"));'
array(4) {
  [0]=>
  string(4) "🙇"
  [1]=>
  string(3) "‍" // U+200D
  [2]=>
  string(3) "♂"
  [3]=>
  string(3) "️" // U+FE0F
}

Until now, PCRE functions were required to support grapheme clusters.

$ sapi/cli/php -r  'preg_match_all("/(\X)/u", "🙇‍♂️", $matches, PREG_OFFSET_CAPTURE); var_dump($matches[1]);'
array(1) {
  [0]=>
  array(2) {
    [0]=>
    string(13) "🙇‍♂️"
    [1]=>
    int(0)
  }
}

Add grapheme_str_split function.

function grapheme_str_split(string $string, int $length = 1): array {}

$string is only support UTF-8. $length is the length of the grapheme cluster per element of the array.

This could break a function existing in userland with the same name.

next PHP 8.x

To SAPIs Will add the aforementioned functions to all PHP environments.

Add grapheme_str_split() to the intl extension.

No effect.

No new constants.

No changed php.ini settings.

No issues

This section details areas where the feature might be improved in future, but that are not currently proposed in this RFC.

Include these so readers know where you are heading and can discuss the proposed voting options.

https://github.com/php/php-src/pull/13580

Keep this updated with features that were discussed on the mail lists.