deniskorbakov/emoji-php

Library for Emoji in PHP - replacement, search, transformation by CLDR

v0.2.1 2025-11-27 11:30 UTC

Requires

• php: >=8.4

Requires (Dev)

• milesj/emojibase: ^16.0
• mockery/mockery: ^1.6
• pestphp/pest: ^3.8 || ^4.0
• phpstan/phpstan: ^2.1
• rector/rector: *
• slevomat/coding-standard: ^8.20
• squizlabs/php_codesniffer: ^3.13 || ^4.0

MIT

• Denis Korbakov

• php
• emoji
• cldr

README

✨ Supports CLDR emoticon storage standard

🌏 Multilingual search from 25 languages

🪄 Replacing unicode emoticons in CLDR format and vice versa

@ This library uses a database of emoticons from - link

📝 Getting Started

Install the package via composer:

composer require deniskorbakov/emoji-php

Now you can use the class with emoticons:

use DenisKorbakov\EmojiPhp\Emojis;

new Emojis();

Below we will consider the functionality of this class.

📖 Examples & Usage

This method outputs a grouping of emoticons with a cldr code based on the selected language

use DenisKorbakov\EmojiPhp\Emojis;
use DenisKorbakov\EmojiPhp\Locale;

new Emojis()->list(Locale::EN);
// return ['smileys & emotion' => ['😀' => ':grinning_face:', ...]]

This method converts the unicode of the emoji to the cldr code - we get unicode emoji from the list method

use DenisKorbakov\EmojiPhp\Emojis;

$text = 'Hello, world! 🌍️'

new Emojis()->toCode($text);
// return 'Hello, world! :globe_showing_europe_africa:'

This method converts the one unicode emoji to the cldr code - we get unicode emoji from the list method

use DenisKorbakov\EmojiPhp\Emojis;

$emoji = '🌍'

new Emojis()->codeByEmoji($text);
// return ':globe_showing_europe_africa:'

This method converts from cldr code with text to unicode emojis - we get cldr from the list method

use DenisKorbakov\EmojiPhp\Emojis;

$text = 'Hello :waving_hand:';

new Emojis()->toEmoji($text);
// return 'Hello 👋'

This method converts one cldr code to unicode emoji - we get cldr from the list method

use DenisKorbakov\EmojiPhp\Emojis;

$text = ':waving_hand:';

new Emojis()->emojiByCode($text);
// return '👋'

This method searches for emoticons by the word, and you also explicitly specify which language to search in

use DenisKorbakov\EmojiPhp\Emojis;
use DenisKorbakov\EmojiPhp\Locale;

$searchText = 'shoe'

new Emojis()->search(Locale::EN, $searchText);
// return ['👞' => ':mans_shoe:', ...]

⚒️ Local Development

Clone this repository:

git clone https://github.com/deniskorbakov/emoji-php

Let's go to the cloned repository:

cd emoji-php

To start, initialize the project and use it:

make init

🧪 Testing

You can run the command for testing after the step with local installation

Run Lint and Analyze code(phpstan/rector/phpcs):

make lint

Run Unit tests:

make test

Run test coverage:

make test-coverage

🤝 Feedback

We appreciate your support and look forward to making our product even better with your help!

@Denis Korbakov

📝 Generated from deniskorbakov/skeleton-php-docker