You are here

function _unicode_check in Drupal 5

Same name and namespace in other branches
  1. 4 includes/unicode.inc \_unicode_check()
  2. 6 includes/unicode.inc \_unicode_check()
  3. 7 includes/unicode.inc \_unicode_check()

Perform checks about Unicode support in PHP, and set the right settings if needed.

Because Drupal needs to be able to handle text in various encodings, we do not support mbstring function overloading. HTTP input/output conversion must be disabled for similar reasons.

Parameters

$errors: Whether to report any fatal errors with form_set_error().

2 calls to _unicode_check()
unicode_check in includes/unicode.inc
Wrapper around _unicode_check().
unicode_requirements in includes/unicode.inc
Return Unicode library status and errors.

File

includes/unicode.inc, line 37

Code

function _unicode_check() {

  // Ensure translations don't break at install time
  $t = get_t();

  // Set the standard C locale to ensure consistent, ASCII-only string handling.
  setlocale(LC_CTYPE, 'C');

  // Check for outdated PCRE library
  // Note: we check if U+E2 is in the range U+E0 - U+E1. This test returns TRUE on old PCRE versions.
  if (preg_match('/[à-á]/u', 'â')) {
    return array(
      UNICODE_ERROR,
      $t('The PCRE library in your PHP installation is outdated. This will cause problems when handling Unicode text. If you are running PHP 4.3.3 or higher, make sure you are using the PCRE library supplied by PHP. Please refer to the <a href="@url">PHP PCRE documentation</a> for more information.', array(
        '@url' => 'http://www.php.net/pcre',
      )),
    );
  }

  // Check for mbstring extension
  if (!function_exists('mb_strlen')) {
    return array(
      UNICODE_SINGLEBYTE,
      $t('Operations on Unicode strings are emulated on a best-effort basis. Install the <a href="@url">PHP mbstring extension</a> for improved Unicode support.', array(
        '@url' => 'http://www.php.net/mbstring',
      )),
    );
  }

  // Check mbstring configuration
  if (ini_get('mbstring.func_overload') != 0) {
    return array(
      UNICODE_ERROR,
      $t('Multibyte string function overloading in PHP is active and must be disabled. Check the php.ini <em>mbstring.func_overload</em> setting. Please refer to the <a href="@url">PHP mbstring documentation</a> for more information.', array(
        '@url' => 'http://www.php.net/mbstring',
      )),
    );
  }
  if (ini_get('mbstring.encoding_translation') != 0) {
    return array(
      UNICODE_ERROR,
      $t('Multibyte string input conversion in PHP is active and must be disabled. Check the php.ini <em>mbstring.encoding_translation</em> setting. Please refer to the <a href="@url">PHP mbstring documentation</a> for more information.', array(
        '@url' => 'http://www.php.net/mbstring',
      )),
    );
  }
  if (ini_get('mbstring.http_input') != 'pass') {
    return array(
      UNICODE_ERROR,
      $t('Multibyte string input conversion in PHP is active and must be disabled. Check the php.ini <em>mbstring.http_input</em> setting. Please refer to the <a href="@url">PHP mbstring documentation</a> for more information.', array(
        '@url' => 'http://www.php.net/mbstring',
      )),
    );
  }
  if (ini_get('mbstring.http_output') != 'pass') {
    return array(
      UNICODE_ERROR,
      $t('Multibyte string output conversion in PHP is active and must be disabled. Check the php.ini <em>mbstring.http_output</em> setting. Please refer to the <a href="@url">PHP mbstring documentation</a> for more information.', array(
        '@url' => 'http://www.php.net/mbstring',
      )),
    );
  }

  // Set appropriate configuration
  mb_internal_encoding('utf-8');
  mb_language('uni');
  return array(
    UNICODE_MULTIBYTE,
    '',
  );
}