Skip to content

rustyJ4ck/portable-utf8

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status

UTF8 Encoding

Portable UTF-8 library is a Unicode aware alternative to PHP's native string handling API.

Based on Hamid Sarfraz's work: http://pageconfig.com/attachments/portable-utf8.php

Description

It is written in PHP and can work without "mbstring", "iconv", UTF-8 support in "PCRE", or any other library. The benefit of Portable UTF-8 is that it is very light-weight, fast, easy to use, easy to bundle, and it always works (no dependencies).

phpDocumentor

http://htmlpreview.github.io/?https://github.com/voku/portable-utf8/master/doc/classes/voku.helper.UTF8.html

Why Portable UTF-8?

PHP 5 and earlier versions have no native Unicode support. PHP 6 or 7 [1], where the Unicode support has been promised, may take years. To bridge the gap, there exist several extensions like "mbstring", "iconv" and "intl".

The problem with "mbstring" and others is that most of the time you cannot ensure presence of a specific one on a server. If you rely on one of these, your application is no more portable. This problem gets even severe for open source applications that have to run on different servers with different configurations. Considering these, I decided to write a library:

Requirements and Recommendations

  • No extensions are required to run this library. Portable UTF-8 only needs PCRE library that is available by default since PHP 4.2.0 and cannot be disabled since PHP 5.3.0. "\u" modifier support in PCRE for UTF-8 handling is not a must.
  • PHP 4.2 is the minimum requirement, and all later versions are fine with Portable UTF-8.
  • To speed up string handling, it is recommended that you have "mbstring" or "iconv" available on your server, as well as the latest version of PCRE library.
  • Although Portable UTF-8 is easy to use; moving from native API to Portable UTF-8 may not be straight-forward for everyone. It is highly recommended that you do not update your scripts to include Portable UTF-8 or replace or change anything before you first know the reason and consequences. Most of the time, some native function may be all what you need.

Portable UTF-8 on the web

Usage:

Example 1:

$cleanUTF8String = UTF8::cleanup($string);
// ... and then save to db

Example 2:

$string = 'string <strong>with utf-8 chars åèä</strong> - doo-bee doo-bee dooh';

echo strlen($string) . "\n<br />";
echo UTF8::strlen($string) . "\n<br />";

// will output:
// 70
// 67

$string_test1 = strip_tags($string);
$string_test2 = UTF8::strip_tags($string);

echo strlen($string_test1) . "\n<br />";
echo UTF8::strlen($string_test2) . "\n<br />";

// will output:
// 53
// 50

License and Copyright

Unless otherwise stated to the contrary, all my work that I publish on this website is licensed under Creative Commons Attribution 3.0 Unported License (CC BY 3.0) and free for all commercial or non-profit projects under certain conditions.

Read the full legal license. http://creativecommons.org/licenses/by/3.0/legalcode

About

Portable UTF-8 library for PHP

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published