wikimedia/equivset

Visually Equivalent Set of UTF-8 Characters

1.7.0 2024-07-26 20:06 UTC

This package is auto-updated.

Last update: 2024-11-30 04:02:56 UTC


README

A mapping of "equivalent" or similar-looking characters (homoglyphs) to prevent spoofing. This is similar to the Unicode Consortium's confusables.txt with some significant differences. Confusables.txt lists character pairs that are visually identical or nearly identical, for example, Latin "A" and Greek "Α" (alpha). This list is much broader, including pairs that merely look similar, for example, "S" and "$". Another difference is that this list only includes letters and punctuation. It does not include symbols, emoji, or graphical elements.

Installation

Using composer: Add the following to the composer.json file for your project:

{
  "require": {
     "wikimedia/equivset": "^1.0.0"
  }
}

And then run composer update.

Usage

use Wikimedia\Equivset\Equivset;

$equivset = new Equivset();

// Normalize a string
echo $equivset->normalize( 'sp00f' ); // SPOOF

// Get a single character.
if ( $equivset->has( 'ɑ' ) ) {
	$char = $equivset->get( 'ɑ' );
}
echo $char; // A

// Loop over entire set.
foreach ( $equivset as $char => $equiv ) {
	// Do something.
}

// Get the entire set.
$all = $equivset->all();

Contributing

All changes should be made to ./data/equivset.in. Then run bin/console generate-equivset to generate the JSON, PHP, and plain text versions of the equivset in ./dist.

When releasing, update HISTORY.md with git log --format='* %s (%aN)' --topo-order to consistently list commits.