README

A purely static UTF-8 Helper based on mb_string and ext-intl

For sure this is not new, and there is better out there, but this is small and does the job without a lot of noise

Installation

Utf8 can be installed using composer:

composer require "fab2s/utf8"

Utf8 is also included in OpinHelper which packages several bellow "Swiss Army Knife" level Helpers covering some of the most annoying aspects of php programing, such as UTF8 string manipulation, high precision Mathematics or properly locking a file

Should you need to work with php bellow 7.1, you can still use OpinHelper 0.x

Prerequisites

Utf8 requires mb_string, ext-intl is auto detected and used when available for UTF-8 Normalization

In practice

Utf8 offers replacement for most native string functions with support for UTF-8:

Utf8::strrpos(string string $str, string $needle, int $offset = null):int|false

UTF-8 aware strrpos() replacement
Utf8::strpos(string $str, string $needle, int $offset = 0):int|false

UTF-8 aware strpos() replacement
Utf8::strtolower(string $str):string

UTF-8 aware strtolower() replacement
Utf8::strtoupper(string $str):string

UTF-8 aware strtoupper() replacement
Utf8::substr(string $str, int $offset, int $length = null):string

UTF-8 aware substr() replacement
Utf8::strlen(string $str):int

UTF-8 aware strlen() replacement
Utf8::ucfirst(string $str):string

UTF-8 aware ucfirst() replacement
Utf8::ucwords(string $str):string

UTF-8 aware ucwords() replacement
Utf8::ord(string $chr):int|false

UTF-8 aware ord() replacement
Utf8::chr(int $num):string|false

UTF-8 aware chr() replacement

And some simple utility methods:

Utf8::normalize(string $string, int $canonicalForm = self::NORMALIZE_NFC):string

UTF-8 ext-intl Normalizer

WARNING: This method will do nothing in case ext-intl is not installed on the host This means it is up to you to make sure about it using Utf8::normalizerSupport or by adding ext-intl as a requirement to your project's composer.json file
Utf8::hasUtf8(string $string):bool

Tells if the input string contains some UTF-8
Utf8::isUtf8(string $string):bool

Tells if the input string is valid UTF-8
Utf8::replaceMb4(string $string, string $replace = ''):string

Replaces all Utf8Mb4 characters (aka mostly emoji)
Utf8::normalizerSupport(bool $disable = false):bool

Tells if Normalizer is available or disable Normalizer support

Requirements

Utf8 is tested against php 7.2, 7.3, 7.4, 8.0 and 8.1

Contributing

Contributions are welcome, do not hesitate to open issues and submit pull requests.

License

Utf8 is open-sourced software licensed under the MIT license

fab2s / utf8

Maintainers

Details