mysqli::set_charset

mysqli::set_charset

mysqli_set_charset

Define el juego de caracteres del cliente

Descripción#

Estilo orientado a objetos

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

Estilo procedimental

```php
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#

mysql
Solo estilo procedimental: Un objeto mysqli devuelto por mysqli_connect o mysqli_init

charset
El juego de caracteres a definir.

Valores devueltos#

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones#

Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla, se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT, se lanza una mysqli_sql_exception en su lugar.

Ejemplos#

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 procedimental

<?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));
?>

Los ejemplos anteriores mostrarán algo similar a:

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

Notas#

[!NOTE] 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.

Véase también#

mysqli_character_set_name, mysqli_real_escape_string, Conceptos de juegos de caracteres de MySQL, Lista de juegos de caracteres soportados por MySQL