PHPackages                             al/emoji-detector - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. al/emoji-detector

ActiveLibrary[Utility & Helpers](/categories/utility)

al/emoji-detector
=================

Detect and return all emoji found in a string

0.2.3(6y ago)06.2k↓15.9%MITPHPPHP >=5.3

Since Feb 18Pushed 6y agoCompare

[ Source](https://github.com/AlmaArmas/emoji-detector-php)[ Packagist](https://packagist.org/packages/al/emoji-detector)[ Docs](https://github.com/aaronpk/emoji-detector-php)[ RSS](/packages/al-emoji-detector/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (1)Versions (6)Used By (0)

Emoji Detection
===============

[](#emoji-detection)

This library will find all emoji in an input string and return information about each emoji character. It supports emoji with skin tone modifiers, as well as the composite emoji that are made up of multiple people.

[![Build Status](https://camo.githubusercontent.com/0d7742e31c7565c54bb432219b6092d6edde1c7c4bbd7dd712c0b31fdb192c24/68747470733a2f2f7472617669732d63692e6f72672f6161726f6e706b2f656d6f6a692d6465746563746f722d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/aaronpk/emoji-detector-php)

Installation
------------

[](#installation)

```
composer require al/emoji-detector

```

Please take a note: this is fork I created for myself to use this library with updated emoji list. I will try to maintain this fork and update lists. However, if you want additional stability, please use original package: `p3k/emoji-detector`. Thanks ^^

Usage
-----

[](#usage)

### Detect Emoji

[](#detect-emoji)

```
$input = "Hello 👍🏼 World 👨‍👩‍👦‍👦";
$emoji = Emoji\detect_emoji($input);

print_r($emoji);
```

The function returns an array with details about each emoji found in the string.

```
Array
(
  [0] => Array
    (
      [emoji] => 👨‍👩‍👦‍👦
      [short_name] => man-woman-boy-boy
      [num_points] => 7
      [points_hex] => Array
        (
          [0] => 1F468
          [1] => 200D
          [2] => 1F469
          [3] => 200D
          [4] => 1F466
          [5] => 200D
          [6] => 1F466
        )
      [hex_str] => 1F468-200D-1F469-200D-1F466-200D-1F466
      [skin_tone] =>
    )
  [1] => Array
    (
      [emoji] => 👍🏼
      [short_name] => +1
      [num_points] => 2
      [points_hex] => Array
        (
          [0] => 1F44D
          [1] => 1F3FC
        )

      [hex_str] => 1F44D-1F3FC
      [skin_tone] => skin-tone-3
    )
)

```

- `emoji` - The emoji sequence found, as the original byte sequence. You can output this to show the original emoji.
- `short_name` - The short name of the emoji, as defined by [Slack's emoji data](https://github.com/iamcal/emoji-data).
- `num_points` - The number of unicode code points that this emoji is composed of.
- `points_hex` - An array of each unicode code point that makes up this emoji. These are returned as hex strings. This will also include "invisible" characters such as the ZWJ character and skin tone modifiers.
- `hex_str` - A list of all unicode code points in their hex form separated by hyphens. This string is present in the [Slack emoji data](https://github.com/iamcal/emoji-data) array.
- `skin_tone` - If a skin tone modifier was used in the emoji, this field indicates which skin tone, since the `short_name` will not include the skin tone.

### Test if a string is a single emoji

[](#test-if-a-string-is-a-single-emoji)

Since simply counting the number of unicode characters in a string does not tell you how many visible emoji are in the string, determining whether a single character is an emoji is more involved. This function will return the emoji data only if the string contains a single emoji character, and false otherwise.

```
$emoji = Emoji\is_single_emoji('👨‍👩‍👦‍👦');
print_r($emoji);
```

```
Array
(
    [emoji] => 👨‍👩‍👦‍👦
    [short_name] => man-woman-boy-boy
    [num_points] => 7
    [points_hex] => Array
        (
            [0] => 1F468
            [1] => 200D
            [2] => 1F469
            [3] => 200D
            [4] => 1F466
            [5] => 200D
            [6] => 1F466
        )

    [hex_str] => 1F468-200D-1F469-200D-1F466-200D-1F466
    [skin_tone] =>
)

```

```
$emoji = Emoji\is_single_emoji('😻🐈');
// false
```

License
-------

[](#license)

Copyright 2017 by Aaron Parecki.

Available under the MIT license.

Emoji data sourced from [iamcal/emoji-data](https://github.com/iamcal/emoji-data) under the MIT license.

Emoji parsing regex sourced from [EmojiOne](https://github.com/Ranks/emojione) under the MIT license.

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~407 days

Total

4

Last Release

2199d ago

PHP version history (2 changes)0.1.0PHP >=5.6

0.2.1PHP >=5.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/d1c48efd06dd63166adb9a6373aeccf8317263943a94670a8fb6e60faa9eafb3?d=identicon)[kfcjew](/maintainers/kfcjew)

---

Top Contributors

[![aaronpk](https://avatars.githubusercontent.com/u/113001?v=4)](https://github.com/aaronpk "aaronpk (28 commits)")[![AlmaArmas](https://avatars.githubusercontent.com/u/67460342?v=4)](https://github.com/AlmaArmas "AlmaArmas (3 commits)")[![sebsel](https://avatars.githubusercontent.com/u/16517999?v=4)](https://github.com/sebsel "sebsel (3 commits)")[![joelknak](https://avatars.githubusercontent.com/u/67378597?v=4)](https://github.com/joelknak "joelknak (1 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")[![Zegnat](https://avatars.githubusercontent.com/u/490579?v=4)](https://github.com/Zegnat "Zegnat (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/al-emoji-detector/health.svg)

```
[![Health](https://phpackages.com/badges/al-emoji-detector/health.svg)](https://phpackages.com/packages/al-emoji-detector)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)