tims-todo/system/core/Utf8.php

165 lines
4.3 KiB
PHP
Raw Permalink Normal View History

<?php
2014-08-08 15:41:59 -04:00
/**
* CodeIgniter
*
* An open source application development framework for PHP
2014-08-08 15:41:59 -04:00
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014 - 2019, British Columbia Institute of Technology
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author EllisLab Dev Team
* @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
* @copyright Copyright (c) 2014 - 2019, British Columbia Institute of Technology (https://bcit.ca/)
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 2.0.0
2014-08-08 15:41:59 -04:00
* @filesource
*/
defined('BASEPATH') OR exit('No direct script access allowed');
2014-08-08 15:41:59 -04:00
/**
* Utf8 Class
*
* Provides support for UTF-8 environments
*
* @package CodeIgniter
* @subpackage Libraries
* @category UTF-8
* @author EllisLab Dev Team
* @link https://codeigniter.com/user_guide/libraries/utf8.html
2014-08-08 15:41:59 -04:00
*/
class CI_Utf8 {
/**
* Class constructor
2014-08-08 15:41:59 -04:00
*
* Determines if UTF-8 support is to be enabled.
2014-08-08 15:41:59 -04:00
*
* @return void
2014-08-08 15:41:59 -04:00
*/
public function __construct()
2014-08-08 15:41:59 -04:00
{
if (
defined('PREG_BAD_UTF8_ERROR') // PCRE must support UTF-8
&& (ICONV_ENABLED === TRUE OR MB_ENABLED === TRUE) // iconv or mbstring must be installed
&& strtoupper(config_item('charset')) === 'UTF-8' // Application charset must be UTF-8
2014-08-08 15:41:59 -04:00
)
{
define('UTF8_ENABLED', TRUE);
log_message('debug', 'UTF-8 Support Enabled');
2014-08-08 15:41:59 -04:00
}
else
{
define('UTF8_ENABLED', FALSE);
log_message('debug', 'UTF-8 Support Disabled');
2014-08-08 15:41:59 -04:00
}
log_message('info', 'Utf8 Class Initialized');
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Clean UTF-8 strings
*
* Ensures strings contain only valid UTF-8 characters.
2014-08-08 15:41:59 -04:00
*
* @param string $str String to clean
2014-08-08 15:41:59 -04:00
* @return string
*/
public function clean_string($str)
2014-08-08 15:41:59 -04:00
{
if ($this->is_ascii($str) === FALSE)
2014-08-08 15:41:59 -04:00
{
if (MB_ENABLED)
{
$str = mb_convert_encoding($str, 'UTF-8', 'UTF-8');
}
elseif (ICONV_ENABLED)
{
$str = @iconv('UTF-8', 'UTF-8//IGNORE', $str);
}
2014-08-08 15:41:59 -04:00
}
return $str;
}
// --------------------------------------------------------------------
/**
* Remove ASCII control characters
*
* Removes all ASCII control characters except horizontal tabs,
* line feeds, and carriage returns, as all others can cause
* problems in XML.
2014-08-08 15:41:59 -04:00
*
* @param string $str String to clean
2014-08-08 15:41:59 -04:00
* @return string
*/
public function safe_ascii_for_xml($str)
2014-08-08 15:41:59 -04:00
{
return remove_invisible_characters($str, FALSE);
}
// --------------------------------------------------------------------
/**
* Convert to UTF-8
*
* Attempts to convert a string to UTF-8.
2014-08-08 15:41:59 -04:00
*
* @param string $str Input string
* @param string $encoding Input encoding
* @return string $str encoded in UTF-8 or FALSE on failure
2014-08-08 15:41:59 -04:00
*/
public function convert_to_utf8($str, $encoding)
2014-08-08 15:41:59 -04:00
{
if (MB_ENABLED)
2014-08-08 15:41:59 -04:00
{
return mb_convert_encoding($str, 'UTF-8', $encoding);
2014-08-08 15:41:59 -04:00
}
elseif (ICONV_ENABLED)
2014-08-08 15:41:59 -04:00
{
return @iconv($encoding, 'UTF-8', $str);
2014-08-08 15:41:59 -04:00
}
return FALSE;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Is ASCII?
*
* Tests if a string is standard 7-bit ASCII or not.
2014-08-08 15:41:59 -04:00
*
* @param string $str String to check
2014-08-08 15:41:59 -04:00
* @return bool
*/
public function is_ascii($str)
2014-08-08 15:41:59 -04:00
{
return (preg_match('/[^\x00-\x7F]/S', $str) === 0);
2014-08-08 15:41:59 -04:00
}
}