mysqli::get_charset

mysqli_get_charset

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

mysqli::get_charset -- mysqli_get_charset — Возвращает объект со сведениями о кодировке

Описание

Объектно-ориентированный стиль

public function mysqli::get_charset(): ?object

Процедурный стиль

function mysqli_get_charset(mysqli $mysql): ?object

Функция возвращает объект со свойствами текущей кодировки.

Список параметров

mysql
Только для процедурного стиля: объект mysqli, который вернула функция mysqli_connect() или функция mysqli_init().

Возвращаемые значения

Функция возвращает объект со следующими свойствами:

charset

Название кодировки.

collation

Название сопоставления.

dir

Каталог, в котором СУБД нашла описание кодировки, или "" для встроенных наборов символов.

min_length

Минимальный размер символа в байтах.

max_length

Максимальный размер символа в байтах.

number

Внутренний номер кодировки.

state

С PHP 8.2.0 независимо от кодировки возвращается 1.

Примеры

Пример #1 Пример извлечения информации об активной кодировке методом mysqli::get_charset()

Объектно-ориентированный стиль

<?php

$db = mysqli_init();
$db->real_connect("localhost", "root", "", "test");
$db->set_charset('latin1');
var_dump($db->get_charset());

Процедурный стиль

<?php

$db = mysqli_init();
mysqli_real_connect($db, "localhost", "root", "", "test");
$db->set_charset('latin1');
var_dump(mysqli_get_charset($db));

Результат выполнения приведённых примеров: 

object(stdClass)#2 (7) {
  ["charset"]=>
  string(6) "latin1"
  ["collation"]=>
  string(17) "latin1_swedish_ci"
  ["dir"]=>
  string(0) ""
  ["min_length"]=>
  int(1)
  ["max_length"]=>
  int(1)
  ["number"]=>
  int(8)
  ["state"]=>
  int(1)
}

Смотрите также

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке
＋Добавить

Примечания пользователей 1 note

up
4
jab_creations at yahoo dot com
1 year ago
On a new server this function was incorrectly returning "utf8mb4_general_ci".

I started a bug report and it turns out that:

1. The PHP team maintained an internal static list.
2. They ultimately decided to not be bothered to update that internal static list.

So as someone with the intentions on knowing exactly what is going on (e.g. Paris Michigan !== Paris France) I now reject the use of this function.

I'm not sure about other databases though for MariaDB you can determine the many character sets using the following SQL query:

SELECT VARIABLE_NAME, GLOBAL_VALUE, DEFAULT_VALUE 
FROM INFORMATION_SCHEMA.SYSTEM_VARIABLES 
WHERE VARIABLE_NAME LIKE '%CHAR%';
＋Добавить