This package is abandoned and no longer maintained. No replacement package was suggested.

Converts country code to emoji flag.

v1.2.1 2020-10-20 18:29 UTC

This package is auto-updated.

Last update: 2021-01-02 17:57:24 UTC


Downloads Download per Month License If this project has business value for you then don't hesitate to support me with a small donation.

Converts a country code to emoji flag. Most flags use a 2-letter code, but some use more (eg England=gbeng, Scotland=gbsct, Wales=gbwls, etc).

Example in action: Screenshot of emoji flags inside phpmyadmin table.


Example in action: Screenshot of a terminal window displaying a plain text log file.


Why Emoji❓

Emoji symbol is a textual replacement for a graphic image file while having the benefits of a graphic image. The image file is already present at your intended destination (a person's device), so why would you transmit the image to them again and again? -- Use emoji!

♻️Green Technology♻️

An image file equivalent to an emoji symbol may be tens, hundreds of kilobytes in size, while an emoji symbol is only several bytes. That's a bandwidth saving of around 10,000 times. If you use emoji instead of image files, you reduce your carbon footprint.

Plain Text Is Now 😎Faux Rich Text

Now you can include emoji in plain text files, even in plain text emails, making them sharp, colourful and rich looking. You can put emoji flags into your database too!

Emoji support: 🖥platform- and 🌍location-dependent‼️

Not every platform supports emoji. Therefore, use with caution! To my knowledge, iOS, macOS, Android are capable of displaying emoji. Additionally, some platforms (or geographical regions) may not be able to display certain flags. If unsure, use this as a reference and easy way to test your platform:

use peterkahl\flagMaster\flagMaster;

echo flagMaster::emojiFlag('uk');    # 🇬🇧
echo flagMaster::emojiFlag('gbwls'); # 🏴󠁧󠁢󠁷󠁬󠁳󠁿
echo flagMaster::emojiFlag('gbsct'); # 🏴󠁧󠁢󠁳󠁣󠁴󠁿
echo flagMaster::emojiFlag('gbeng'); # 🏴󠁧󠁢󠁥󠁮󠁧󠁿