README

Unicode-aware string encoding, conversion, and analysis for PHP with a fluent API. Features script detection, directionality analysis, character analysis, and intelligent transliteration.

Requirements

Requires PHP 8.2+ with ext-intl, ext-mbstring, and ext-iconv

Installation

composer require cline/babel

Documentation

• Getting Started - Installation and basic usage
• Conversion - Encoding conversion methods
• Script Detection - Detect scripts and character sets
• Directionality - RTL/LTR detection
• Character Analysis - Analyze string contents
• Normalization - Clean and normalize strings

Quick Examples

use Cline\Babel\Babel;

// Convert to ASCII with transliteration
Babel::from('Żółć')->toAscii();           // "Zolc"
Babel::from('北京')->toAscii();            // "bei jing"
Babel::from('Привет')->toAscii();          // "Privet"

// Detect scripts
Babel::from('Hello 世界')->containsChinese();   // true
Babel::from('Привет мир')->containsCyrillic();  // true
Babel::from('مرحبا')->isRtl();                  // true

// Clean strings
Babel::from("Hello\x00World")->removeNonPrintable()->value();  // "HelloWorld"
Babel::from('Hello 👋')->removeEmoji()->value();                // "Hello "

// Create slugs
Babel::from('Héllo Wörld!')->toSlug();  // "hello-world"

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.