README

Modernized drop-in replacement for voku/portable-ascii — requires PHP 8.1+.

Why?

The original voku/portable-ascii package (471M+ installs) still requires PHP 7.0 and has unresolved PHP 8.4 deprecation warnings. This fork modernizes the codebase, fixes transliteration bugs, and is 36-50% faster while keeping full API compatibility.

Zero breaking changes. Same namespace, same methods, same behavior.

What changed

• PHP 8.1 minimum (was 7.0)
• Typed properties and return types throughout
• Fixed implicit nullable parameter deprecation (to_transliterate())
• Replaced O(n*m) character replacement loop with strtr() — single C-level pass
• Adaptive sparse/dense detection for optimal replacement strategy
• mb_str_split() replacing preg_match_all for character splitting (when ext-mbstring available)
• Cascading transliteration: ext-intl -> ext-iconv -> manual byte decoding
• Inlined is_ascii() regex for faster hot-path checks
• Fixed Bulgarian, Ukrainian, Austrian (Eszett), and Hindi transliteration mappings
• Test suite ported to Pest 4 (247 tests, 1602 assertions)

Performance

Benchmarked on PHP 8.5 with real-world inputs (German/French/Russian blog titles, product names, URL slugs, long text). Each profile was run in an isolated process with 20s CPU cooldown between runs, 5000 iterations, median of 5 runs.

The to_ascii() and to_slugify() improvements are pure PHP — no extensions needed. ext-mbstring accelerates to_transliterate() by 24% via mb_str_split() replacing preg_match_all for character splitting.

Run the benchmark yourself:

php benchmark/run.php 5000           # fork vs original (side by side)
php benchmark/run-profiles.php 5000  # extension profile comparison

Installation

composer require webpatser/portable-ascii

This automatically replaces voku/portable-ascii via Composer's replace directive. No code changes needed — \voku\helper\ASCII continues to work.

For best transliteration performance, install ext-mbstring:

sudo apt install php-mbstring

Usage

use voku\helper\ASCII;

// Transliterate to ASCII
ASCII::to_ascii('Düsseldorf', 'de');  // 'Duesseldorf'

// Check if string is ASCII
ASCII::is_ascii('hello');  // true

// Transliterate with fallback character
ASCII::to_transliterate('こんにちは', '?');  // 'konnichiha'

// Generate URL slug
ASCII::to_slugify('Hello Wörld!');  // 'hello-woerld'

Compatibility

Works with Laravel 11, 12, and 13. All extensions are optional — the library auto-detects what's available and uses the fastest path.

Credits

This package is a modernized fork of voku/portable-ascii by Lars Moelleken. The original work, including all 193 Unicode-to-ASCII data tables and the transliteration engine, is his. Licensed under MIT.

License

MIT