array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'mysqli.set-charset.php', 1 => 'mysqli::set_charset', 2 => 'Define el juego de caracteres del cliente', ), 'up' => array ( 0 => 'class.mysqli.php', 1 => 'mysqli', ), 'prev' => array ( 0 => 'mysqli.select-db.php', 1 => 'mysqli::select_db', ), 'next' => array ( 0 => 'mysqli.sqlstate.php', 1 => 'mysqli::$sqlstate', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/mysqli/mysqli/set-charset.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

mysqli::set_charset

mysqli_set_charset

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

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

Estilo procedimental

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

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