Download the PHP package chefkoch/morphoji without Composer
On this page you can find all versions of the php package chefkoch/morphoji. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download chefkoch/morphoji
More information about chefkoch/morphoji
Files in chefkoch/morphoji
Package morphoji
Short Description A library to convert UTF-8 emoji characters to latin1 placeholders and vice versa.
License MIT
Homepage https://github.com/chefkoch-dev/morphoji
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package morphoji
Morphoji
Morphoji is a tiny PHP library to morph Unicode Emoji characters 🤗 into Latin1 placeholders🙀 and back. 👍
Use Case
Why would you want to do this in the first place? Maybe for the same reason I
did: you got a big old MySQL Database with all text columns defined as utf8.
Great, because with utf8 you can store everything Unicode has to offer,
including Emoji characters, right?
Wrong-o.
Apparently utf8 in MySQL (and some other applications) is limited to 3 Byte
Unicode characters.
Unfortunately the bulk of the
Emoji characters is found in 4 Byte
Unicode space.
Trying to store those Emoji (and other 4 Byte characters) in a MySQL utf8
table will result in those characters silently getting lost.
utf8mb4
Of course there is a systematic solution for this. Convert the columns in
question (and your database connections to them) from utf8 to utf8mb4. THAT
charset is actually able to store ALL of the characters specified by Unicode.
If you want to go that route (which is by far the cleanest approach) Mathias Bynens wrote a great article on that.
But also, if your database is really big and has lots of text columns and you
don't want to convert just a few columns to the new charset but all of them
(because consistency and because you will have to change your connection's
charset as well) and you really only care about Emoji and not about
characters for
Ancient Greek Musical Notation
aaand you just did all that converting a couple of years ago for utf8 and
don't really have the time and nerve to do it again ...
... you could just use Morphoji.
Usage
Morphoji can be required via Composer in the project where you want to use it:
Converting
Now if you have $text containing (possibly) Emoji characters handle it like
this:
Wrapping
Additionally you can convert a string with emoji placeholders to a string where these placeholders are wrapped with arbitray prefix and suffix.
For example you can use this to decorate the placeholders with tags.
This way you can replace them with your own graphics when rendering the text in whatever your frontend may be.
How it works
Morphoji will only convert characters which have an official emoji representation. This happens by using a regular expression derived from official Unicode charts.
Every character matching that regular expression will be converted into a latin1 placeholder:
E.g. a replaced "face blowing a kiss" Emoji (1F618, 😘) will be represented
as :emoji-1f618:.
Converting the placeholder back works with an according regex; other than that it's pretty much vice versa.
Why not just convert into HTML entities and then use those in the output?
Morphoji aims to be output device agnostic. If you just want to HTML everything that's fine, but in that case this is probably not the library you are looking for.
In my case the data stored in the database isn't necessarily output in an HTML context, so being able to convert the entities back is mandatory. (And in a time where almost all output devices / applications are able to handle full UTF-8 it is the generally cleaner approach.)
Other languages
There are no plans to implement this in any other language. Coming up with the emoji detection regex is about half the work, if you want to use it in your own implementation: go ahead.
Tests
If you want to contribute, please don't forget to add / adapt the tests.
To run them:
License
Morphoji is licensed under the MIT License.
