mysqli::set_charset

mysqli_set_charset

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

mysqli::set_charset -- mysqli_set_charsetDefine el juego de caracteres del cliente

Descripción

Estilo orientado a objetos

public mysqli::set_charset(string $charset): bool

Estilo por procedimientos

mysqli_set_charset(mysqli $mysql, string $charset): bool

Define el juego de caracteres a utilizar al enviar datos desde y hacia el servidor de base de datos.

Parámetros

link

Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()

charset

El juego de caracteres a definir.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Errores/Excepciones

If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

Ejemplos

Ejemplo #1 Ejemplo con mysqli::set_charset()

Estilo orientado a objetos

<?php
mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "test");

printf("Juego de caracteres inicial: %s\n", $mysqli->character_set_name());

/* Cambio del juego de resultados a utf8mb4 */
$mysqli->set_charset("utf8mb4");

printf("Juego de caracteres actual: %s\n", $mysqli->character_set_name());
?>

Estilo por procedimientos

<?php
mysqli_report
(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'test');

printf("Juego de caracteres inicial: %s\n", mysqli_character_set_name($link));

/* Cambio del juego de resultados a utf8mb4 */
mysqli_set_charset($link, "utf8mb4");

printf("Juego de caracteres actual: %s\n", mysqli_character_set_name($link));
?>

El resultado de los ejemplos sería algo similar a:

Juego de caracteres inicial: latin1
Juego de caracteres actual: utf8mb4

Notas

Nota:

Esta es la mejor forma de modificar el juego de caracteres. No se recomienda utilizar la función mysqli_query() para definirlo (como con la consulta SET NAMES utf8). Ver la sección Conceptos de juegos de caracteres de MySQL para más información.

Ver también