Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A PHP Emoji conversion library
branch: master

This branch is 7 commits behind iamcal:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

php-emoji - Process Emoji in PHP and display them as HTML

This is a PHP library for dealing with mobile device Emoji.

You can read more about it and see a demo here:

It is based on a Ruby library here:

And data from Unicode here:

Important note: As of iOS 6, the iPhone uses unified codepoints. You no longer need to do any conversion at input/output time, unless you want to convert it to HTML for viewing on PCs, Android phones, older Macs, etc.



    # when you recieve text from a mobile device, convert it
    # to the unified format.

    $data = emoji_docomo_to_unified($data);   # DoCoMo devices
    $data = emoji_kddi_to_unified($data);     # KDDI & Au devices
    $data = emoji_softbank_to_unified($data); # Softbank & pre-iOS6 Apple devices
    $data = emoji_google_to_unified($data);   # Google Android devices

    # when sending data back to mobile devices, you can
    # convert back to their native format.

    $data = emoji_unified_docomo($data);   # DoCoMo devices
    $data = emoji_unified_kddi($data);     # KDDI & Au devices
    $data = emoji_unified_softbank($data); # Softbank & pre-iOS6 Apple devices
    $data = emoji_unified_google($data);   # Google Android devices

    # when displaying data to anyone else, you can use HTML
    # to format the emoji.

    $data = emoji_unified_to_html($data);

    # if you want to use an editor(i.e:wysiwyg) to create the content, 
    # you can use html_to_unified to store the unified value.

    $data = emoji_html_to_unified(emoji_unified_to_html($data));

When using the HTML format, you'll also need to include the emoji.css file, which points to the emoji.png image. These images come from the gemoji project and cover all current codepoints, except U+1F320, Shooting Star.

IMPORTANT NOTE: This library currently only deals with UTF-8. If your source data is JIS or Shift-JIS, you're out of luck for the moment.


By Cal Henderson

Parser rewrite based on a fork by 杜志刚

This work is licensed under the GPL v3

Image copyrights:

Version 1 released on 2009-10-20

Something went wrong with that request. Please try again.