mb_internal_encoding

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_internal_encodingDahili karakter kodlamasını tanımlar/döndürür

Açıklama

mb_internal_encoding(?string $kodlama = null): string|bool

Dahili karakter kodlamasını tanımlar/döndürür.

Bağımsız Değişkenler

kodlama

HTTP girdi karakter kodlaması dönüşümü için kullanılan karakter kodlaması ve dizge işlevleri için mbstring modülü tarafından tanımlanmış öntanımlı karakter kodlaması adı. Farkedileceği gibi, dahili kodlama çok baytlı düzenli ifadelerin kodlamasından tamamen farklıdır.

Dönen Değerler

kodlama belirtilmişse başarı durumunda true döner ve bu durumda çok baytlı düzenli ifade kodlaması değişmez. kodlama belirtilmemişse veya null ise geçerli kodlamanın ismi döner.

Hatalar/İstisnalar

PHP 8.0.0 ve sonrasında, kodlama geçersizse ValueError yavrulanmaktadır. Evvelce E_WARNING çıktılanırdı.

Sürüm Bilgisi

Sürüm: Açıklama
8.0.0 kodlama geçersizse artık ValueError yavrulanıyor. Evvelce E_WARNING çıktılanırdı.
8.0.0kodlama artık null olabiliyor.

Örnekler

Örnek 1 - mb_internal_encoding() örneği

<?php
/* Dahili karakter kodlamasını UTF-8 yapalım */
mb_internal_encoding("UTF-8");

/* Dahili karakter kodlamasını öğrenelim */
echo mb_internal_encoding();
?>

Ayrıca Bakınız

  • mb_http_input() - HTTP girdi karakter kodlamasını algılar
  • mb_http_output() - HTTP çıktı karakter kodlamasını tanımlar/döndürür
  • mb_detect_order() - Karakter kodlaması algılama sırasını tanımlar/döndürür
  • mb_regex_encoding() - Çok baytlı düzenli ifade işlevleri için geçerli kodlamayı dizge olarak atar/döndürür

add a note add a note

User Contributed Notes 7 notes

up
12
Joachim Kruyswijk
18 years ago
Especially when writing PHP scripts for use on different servers, it is a very good idea to explicitly set the internal encoding somewhere on top of every document served, e.g.

mb_internal_encoding("UTF-8");

This, in combination with mysql-statement "SET NAMES 'utf8'", will save a lot of debugging trouble.

Also, use the multi-byte string functions instead of the ones you may be used to, e.g. mb_strlen() instead of strlen(), etc.
up
9
webfav at web dot de
9 years ago
all together

<?php
// ------------------------------------------------------------

header('Content-Type: text/html; charset=UTF-8');

mb_internal_encoding('UTF-8');
mb_http_output('UTF-8');
mb_http_input('UTF-8');
mb_regex_encoding('UTF-8');

// ------------------------------------------------------------
?>
up
6
mortoray at ecircle-ag dot com
19 years ago
Be aware that the strings in your source files must match the encoding you specify by mb_internal_encoding.  It appears the Parser loads raw bytes from the file and refers to its internal encoding to determine their actual encoding.

To demonstrate, the following outputs as espected when the /source/ file is Latin-1 encoded:

<?php
    mb_internal_encoding
("iso-8859-1");
   
mb_http_output( "UTF-8" );
   
ob_start("mb_output_handler");

    echo
"???<br/>";

   
?>???

Now, a typical use of mb_internal_encoding is shown as follows.  Make the change to "utf-8" but leave the /source/ file encoding unchanged:

<?php
    mb_internal_encoding
("UTF-8");
   
mb_http_output( "UTF-8" );
   
ob_start("mb_output_handler");

    echo
"???<br/>";

   
?>???

The output will just show the <br/> tag and no text.

Save the file as UTF-8 encoding and then the results will be as expected.
up
0
Anonymous
9 years ago
Note that mb_internal_encoding is not necessary in PHP 5.6
up
-1
mdirks at gulfstreamcoach dot com
17 years ago
In response to mortoray at ecircle-ag dot com:

The characters display fine as long as you set the Encoding to something more "Latin 1" compatible (i.e. US-ACSII, ISO-8859-1, ISO-8859-1, or  Windows 1252). PHP.net auto-detects to UTF-8
up
-6
john leborgne
12 years ago
i noticed that setting mb_internal_encoding('UTF-8') in my global site config.inc.php, doesn't work in my classes : it reverse back to ISO-8859-1.
Adding the call to the constructor of my top site class resolve this.
up
-13
mortoray at ecircle-ag dot com
19 years ago
To previous example, the PHP notes don't appear to support umlauted characters so there are question marks  (?) there instead of what should be umlauated oue.  Just substitute any high-order/accented character to see the effect.
To Top