Page MenuHomeWickedGov Phorge
Files F5957207

README.md
No OneTemporary
Actions

Size
1 KB
Referenced Files
None
Subscribers
None

README.md
View Options

# Equivset
A mapping of "equivalent" or similar-looking characters ([homoglyphs](https://en.wikipedia.org/wiki/Homoglyph)) to prevent spoofing. This is similar to the Unicode Consortium's [confusables.txt](https://www.unicode.org/Public/security/15.1.0/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:
```json
{
"require": {
"wikimedia/equivset": "^1.0.0"
}
}
```
And then run `composer update`.
## Usage
```php
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.

File Metadata

Mime Type
text/plain
Expires
Sat, Oct 3, 04:57 (3 w, 3 h ago)
Storage Engine
local-disk
Storage Format
Raw Data
Storage Handle
d8/a8/69fe40539789e8a08ce6349f6784
Default Alt Text
README.md (1 KB)

Event Timeline