"Fossies" - the Fresh Open Source Software Archive

Member "libraries/phputf8/README" (12 Sep 2021, 3370 Bytes) of package /linux/www/Joomla_3.10.2-Stable-Full_Package.tar.bz2:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 ++PHP UTF-8++
    2 
    3 Version 0.5
    4 
    5 ++DOCUMENTATION++
    6 
    7 Documentation in progress in ./docs dir
    8 
    9 http://www.phpwact.org/php/i18n/charsets
   10 http://www.phpwact.org/php/i18n/utf-8
   11 
   12 Important Note: DO NOT use these functions without understanding WHY
   13 you are using them. In particular, do not blindly replace all use of PHP's
   14 string functions which functions found here - most of the time you will
   15 not need to, and you will be introducing a significant performance
   16 overhead to your application. You can get a good idea of when to use what
   17 from reading: http://www.phpwact.org/php/i18n/utf-8
   18 
   19 Important Note: For sake of performance most of the functions here are
   20 not "defensive" (e.g. there is not extensive parameter checking, well
   21 formed UTF-8 is assumed). This is particularily relevant when is comes to
   22 catching badly formed UTF-8 - you should screen input on the "outer
   23 perimeter" with help from functions in the utf8_validation.php and
   24 utf8_bad.php files.
   25 
   26 Important Note: this library treats ALL ASCII characters as valid, including ASCII control characters. But if you use some ASCII control characters in XML, it will render the XML ill-formed. Don't be a bozo: http://hsivonen.iki.fi/producing-xml/#controlchar
   27 
   28 ++BUGS / SUPPORT / FEATURE REQUESTS ++
   29 
   30 Please report bugs to:
   31 http://sourceforge.net/tracker/?group_id=142846&atid=753842
   32 - if you are able, please submit a failing unit test
   33 (http://www.lastcraft.com/simple_test.php) with your bug report.
   34 
   35 For feature requests / faster implementation of functions found here,
   36 please drop them in via the RFE tracker: http://sourceforge.net/tracker/?group_id=142846&atid=753845
   37 Particularily interested in faster implementations!
   38 
   39 For general support / help, use:
   40 http://sourceforge.net/tracker/?group_id=142846&atid=753843
   41 
   42 In the VERY WORST case, you can email me: hfuecks gmail com - I tend to be slow to respond though so be warned.
   43 
   44 Important Note: when reporting bugs, please provide the following
   45 information;
   46 
   47 PHP version, whether the iconv extension is loaded (in PHP5 it's
   48 there by default), whether the mbstring extension is loaded. The
   49 following PHP script can be used to determine this information;
   50 
   51 <?php
   52 print "PHP Version: " .phpversion()."<br>";
   53 if ( extension_loaded('mbstring') ) {
   54     print "mbstring available<br>";
   55 } else {
   56     print "mbstring not available<br>";
   57 }
   58 if ( extension_loaded('iconv') ) {
   59     print "iconv available<br>";
   60 } else {
   61     print "iconv not available<br>";
   62 }
   63 ?>
   64 
   65 ++LICENSING++
   66 
   67 Parts of the code in this library come from other places, under different
   68 licenses.
   69 The authors involved have been contacted (see below). Attribution for
   70 which code came from elsewhere can be found in the source code itself.
   71 
   72 +Andreas Gohr / Chris Smith - Dokuwiki
   73 There is a fair degree of collaboration / exchange of ideas and code
   74 beteen Dokuwiki's UTF-8 library;
   75 http://dev.splitbrain.org/view/darcs/dokuwiki/inc/utf8.php
   76 and phputf8. Although Dokuwiki is released under GPL, its UTF-8
   77 library is released under LGPL, hence no conflict with phputf8
   78 
   79 +Henri Sivonen (http://hsivonen.iki.fi/php-utf8/ /
   80 http://hsivonen.iki.fi/php-utf8/) has also given permission for his
   81 code to be released under the terms of the LGPL. He ported a Unicode / UTF-8
   82 converter from the Mozilla codebase to PHP, which is re-used in phputf8