Extensión mejorada de MySQL
Introducción
La extensión mysqli permite acceder a la funcionalidad provista por MySQL 4.1 y superior. Más información acerca del servidor de base de datos MySQL puede ser encontrada en » https://www.mysql.com/
La documentación para MySQL puede ser encontrada en » https://dev.mysql.com/doc/.
Partes de esta documentación ha sido incluida del manual de MySQL con permiso de MySQL AB.
Requisitos
Para tener estas funciones disponibles, usted debe compilar PHP con soporte para la extensión MySQLI.
Note: La extensión mysqli está diseñada para trabajar con la versión 4.1.3 o superior de MySQL. Para versiones previas, por favor vea documentación de la extensión MySQL.
Instalación
Para instalar la extensión de mysqli para PHP, use la opción de configuración --with-mysqli=mysql_config_path/mysql_config donde mysql_config_path representa la ubicación del programa mysql_config que viene con MySQL en versiones superiores a 4.1.
Si quiere instalar la extensión de mysql junto con la extensión mysqli, usted tiene que usar la mismas librerias cliente, para evitar cualquier conflicto.
Configuración en tiempo de ejecución
El comportamiento de estas funciones está afectado por los valores definidos en php.ini.
Nombre | Default | Cambiable | Changelog |
---|---|---|---|
mysqli.max_links | "-1" | PHP_INI_SYSTEM | Available since PPH 5.0.0. |
mysqli.default_port | 3306 | PHP_INI_ALL | Available since PPH 5.0.0. |
mysqli.default_socket | NULL | PHP_INI_ALL | Available since PPH 5.0.0. |
mysqli.default_host | NULL | PHP_INI_ALL | Available since PPH 5.0.0. |
mysqli.default_user | NULL | PHP_INI_ALL | Available since PPH 5.0.0. |
mysqli.default_pw | NULL | PHP_INI_ALL | Available since PPH 5.0.0. |
Para más detalles y definiciones de las constantes PHP_INI_* anteriores, vea el capÃtulo sobre Cambios de configuración.
A continuación se presenta una corta explicación de las directivas de configuración.
- mysqli.max_links integer
-
El número máximo de conexiones MySQL por proceso.
- mysqli.default_port string
-
El puerto TCP por defecto a usar cuando se conecte al servidor de base de datos si no se ha especÃficado otro puerto. Si no se define el default, el puerto será tomado de la variable de ambiente MYSQL_TCP_PORT, la entrada mysql-tcp en el archivo /etc/services o la constante en tiempo de ejecución MYSQL_PORT en ese orden. Win32 usará solo la constante MYSQL_PORT.
- mysqli.default_socket string
-
El nombre de socket por defecto a usar cuando se conecte a un servidor de base de datos local si no se ha especÃficado otro nombre de socket.
- mysqli.default_host string
-
El servidor huésped por defecto a usar cuando se conecta al servidor de base de datos si no se ha especÃficado otro. No aplica en modo seguro.
- mysqli.default_user string
-
El nombre de usuario por defecto a usar cuando se conecta al servidor de base de datos si no se especÃfica otro nombre. No aplica en modo seguro.
- mysqli.default_pw string
-
La contraseña a usar cuando se conecta al servidor de base de datos si no se especÃfica otra contraseña. No aplica en modo seguro.
Clases predefinidas
mysqli
Representa una conexión entres PHP y la base de datos MySQL.
Constructor
-
mysqli - constructor de un nuevo objeto mysqli
Métodos
-
autocommit - cambia en on o off las modificaciones de auto-commiting en la base de datos
-
change_user - cambia el usuario del identificador de enlace especÃficado
-
character_set_name - regresa el conjunto de caracteres del identificador de enlace especÃficado
-
close - cierra una conexión previamente abierta
-
commit - completa la transacció actual
-
connect - abre una nueva conexión al servidor de MySQL
-
debug - realiza operaciones de rastreo
-
dump_debug_info - vacÃa informació de rastreo
-
get_client_info - regresa la versión del cliente
-
get_host_info - regresa el tipo de conexión usada
-
get_server_info - regresa la versión del servidor MySQL
-
get_server_version - regresa la versión del servidor MySQL
-
init - inicializa el objeto mysqli
-
info - obtiene información acerca de la consulta más recientemente ejecutada
-
kill - solicita al servidor destruir un thread de mysql
-
multi_query - realiza consultas de SQL múltiples
-
more_results - checa si existen mas resultados de la consulta múltiple actualmente ejecutada
-
next_result - lee el siguiente resultado de la consulta múltiple actualmente ejecutada
-
options - fija opciones
-
ping - llama una conexión con el servidor o reconecta si no hay conexión
-
prepare - prepara una sentencia SQL
-
query - ejecuta una sentencia SQL
-
real_connect - intenta abrir una conexión al servidor de base de datos MySQL
-
escape_string - caracteres especiales de escape para ser usados en una sentencia SQL, tomando en cuenta el conjunto de caracteres actual de la conexión
-
rollback - deshace la transacción actual
-
select_db - selecciona la base de datos por defecto
-
ssl_set - fija los parámetros SSL
-
stat - obtiene el estado actual del sistema
-
stmt_init - inicializa una sentencia para ser usada con mysqli_stmt_prepare
-
store_result - transfiere un resultado de la última consulta
-
use_result - transfiere un resultado sin almacenamiento intermedio de la última consulta
-
thread_safe - regresa si se ha dado thread_safety o no
Propiedades
-
affected_rows - obtiene el número de filas afectadas en la operación MySQL previa
-
client_info - regresa en una cadena la versión del cliente de MySQL
-
client_version - regresa en un entero la versión del cliente de MySQL
-
errno - regresa el código de error para la llamada a función más reciente
-
error - regresa la cadena de error para la llamada a función más reciente
-
field_count - regresa el número de columnas para la consulta más reciente
-
host_info - regresa la cadena representando el tipo de conexión usado
-
info - regresa información acerca de la consulta ejecutada más recientemente
-
insert_id - regresa el identificador generado automáticamente usado en la última consulta
-
protocol_version - regresa la versión del protocolo usado por MySQL
-
sqlstate - regresa una cadena que contiene el código de error SQLSTATE para el último error
-
thread_id - regresa el identificador del THREAD para la conexión actual
-
warning_count - regresa el número de alertas generadas durante la ejecución del enunciado SQL previo
mysqli_stmt
Representa una sentencia preparada.
Métodos
-
bind_param - enlaza variables a una sentencia preparada
-
bind_result - enlaza variables a una sentencia preparada para el almacenamiento del resultado
-
close - cierra la sentencia preparada
-
data_seek - busca a una fila arbitrariamente en el resultado
-
execute - ejecuta una sentencia preparada
-
fetch - obtiene el resultado de la sentencia preparada en variables lÃmite
-
free_result - libera la memoria del resultado almacenado para el manejador de la sentencia dada
-
result_metadata - obtiene un resultado de la sentencia preparada para información de metadatos
-
prepare - prepara una consulta SQL
-
send_long_data - envÃa datos en partes
-
reset - resetea una sentencia preparada
-
store_result - almacena el resultado completo de la sentencia preparada
Propiedades
-
affected_rows - regresa las filas afectadas de la última sentencia ejecutdada
-
errno - regresa el código de error para la llamada a función más reciente
-
error - regresa el mensaje de error para la llamada a función más reciente
-
param_count - regresa el numero de parámetros para la sentencia preparada dada
-
sqlstate - regresa una cadena conteniendo el código de error SQLSTATE para la llamada a función más reciente
mysqli_result
Representa el resultado obtenido de la consulta hecha en la base de datos.
Métodos
-
close - cierra el resultado
-
data_seek - mueve el puntero interno del resultado
-
fetch_field - obtiene la información de la columna en el resultado
-
fetch_fields - obtiene la información para todas las columnas del resultado
-
fetch_field_direct - obtiene información de la columna para la columna dada
-
fetch_array - recupera una fila como una matriz asociativa, una matriz numérica, o ambos.
-
fetch_assoc - obtiene una fuka como una matriz asociativa
-
fetch_object - obtiene una fila como un objeto
-
fetch_row - obtiene una fila como una matriz enumerada
-
close - libera la memoria ocupada por el resultado
-
field_seek - fija el apuntador del resultado a la posición especÃficada
Propiedades
-
current_field - regresa la posición de puntero actual
-
field_count - regresa el número de campos en el resultado
-
lengths - regresa una matriz con la longitud de los campos
-
num_rows - regresa el número de filas en el resultado
Constantes predefinidas
Nombre | Descripción |
---|---|
MYSQLI_READ_DEFAULT_GROUP (integer) | Lee las opciones del grupo llamado de `my.cnf' o la fila especificada con MYSQLI_READ_DEFAULT_FILE |
MYSQLI_READ_DEFAULT_FILE (integer) | Lee las opciones del archivo especÃficado en vez de my.cnf |
MYSQLI_OPT_CONNECT_TIMEOUT (integer) | Tiempo de espera para la conexión en segundos |
MYSQLI_OPT_LOCAL_INFILE (integer) | Habilita el comando LOAD LOCAL INFILE |
MYSQLI_INIT_COMMAND (integer) | Comando a ejecutar cuando se conecta al servidor MySQL. Será automáticamente re-ejecutado cuando se vuelva a conectar. |
MYSQLI_CLIENT_SSL (integer) | Usa SSL (protocolo de encripción). Esta opción no debe ser fijado por programas de apliación; esta es fijada internamente en la libreria cliente de MySQL |
MYSQLI_CLIENT_COMPRESS (integer) | Usa el protocolo de compresión |
MYSQLI_CLIENT_INTERACTIVE (integer) | Permite tiempo de espera interactivo en segundos (en vez de esperar ciertos segundos) de inactividad antes de cerrar la conexión. La variable wait_timeout de sesión del cliente será fijada a el valor de la variable de sesión interactive_timeout. |
MYSQLI_CLIENT_IGNORE_SPACE (integer) | Permite espacios después de los nombres de las funciones. Esto hace a todas las funciones palabras reservadas. |
MYSQLI_CLIENT_NO_SCHEMA (integer) | No permite la sintaxis db_name.tbl_name.col_name syntax. |
MYSQLI_CLIENT_MULTI_QUERIES (integer) | |
MYSQLI_STORE_RESULT (integer) | Para usar resultados con almacenamiento intermedio |
MYSQLI_USE_RESULT (integer) | Para usar resultados sin almacenamiento intermedio |
MYSQLI_ASSOC (integer) | Las columnas son regresadas en una matriz que tiene el nombre del campo como Ãndice de la matriz. |
MYSQLI_NUM (integer) | Las columnas son regresadas en una matriz teniendo un Ãndice enumerado. |
MYSQLI_BOTH (integer) | Las clumnas son regresadas en una matriz teniendo ambas formas de Ãndice numérico y con el nombre del campo como Ãndice asociativo. |
MYSQLI_NOT_NULL_FLAG (integer) | Indica que un campo es definido como NOT NULL |
MYSQLI_PRI_KEY_FLAG (integer) | El campo es parte de un Ãndice primario |
MYSQLI_UNIQUE_KEY_FLAG (integer) | El campo es parte de un Ãndice único |
MYSQLI_MULTIPLE_KEY_FLAG (integer) | El campo es parte de un Ãndice. |
MYSQLI_BLOB_FLAG (integer) | El campo está definido como BLOB |
MYSQLI_UNSIGNED_FLAG (integer) | El campo está definido como UNSIGNED |
MYSQLI_ZEROFILL_FLAG (integer) | El campo está definido como ZEROFILL |
MYSQLI_AUTO_INCREMENT_FLAG (integer) | El campo está definido como AUTO_INCREMENT |
MYSQLI_TIMESTAMP_FLAG (integer) | El campo está definido como TIMESTAMP |
MYSQLI_SET_FLAG (integer) | El campo está definido como SET |
MYSQLI_NUM_FLAG (integer) | El campo está definido como NUMERIC |
MYSQLI_PART_KEY_FLAG (integer) | El campo es parte de un Ãndice multiple |
MYSQLI_GROUP_FLAG (integer) | El campo es parte de GROUP BY |
MYSQLI_TYPE_DECIMAL (integer) | El campo está definido como DECIMAL |
MYSQLI_TYPE_TINY (integer) | El campo está definido como TINYINT |
MYSQLI_TYPE_SHORT (integer) | El campo está definido como INT |
MYSQLI_TYPE_LONG (integer) | El campo está definido como INT |
MYSQLI_TYPE_FLOAT (integer) | El campo está definido como FLOAT |
MYSQLI_TYPE_DOUBLE (integer) | El campo está definido como DOUBLE |
MYSQLI_TYPE_NULL (integer) | El campo está definido como DEFAULT NULL |
MYSQLI_TYPE_TIMESTAMP (integer) | El campo está definido como TIMESTAMP |
MYSQLI_TYPE_LONGLONG (integer) | El campo está definido como BIGINT |
MYSQLI_TYPE_INT24 (integer) | El campo está definido como MEDIUMINT |
MYSQLI_TYPE_DATE (integer) | El campo está definido como DATE |
MYSQLI_TYPE_TIME (integer) | El campo está definido como TIME |
MYSQLI_TYPE_DATETIME (integer) | El campo está definido como DATETIME |
MYSQLI_TYPE_YEAR (integer) | El campo está definido como YEAR |
MYSQLI_TYPE_NEWDATE (integer) | El campo está definido como DATE |
MYSQLI_TYPE_ENUM (integer) | El campo está definido como ENUM |
MYSQLI_TYPE_SET (integer) | El campo está definido como SET |
MYSQLI_TYPE_TINY_BLOB (integer) | El campo está definido como TINYBLOB |
MYSQLI_TYPE_MEDIUM_BLOB (integer) | El campo está definido como MEDIUMBLOB |
MYSQLI_TYPE_LONG_BLOB (integer) | El campo está definido como LONGBLOB |
MYSQLI_TYPE_BLOB (integer) | El campo está definido como BLOB |
MYSQLI_TYPE_VAR_STRING (integer) | El campo está definido como VARCHAR |
MYSQLI_TYPE_STRING (integer) | El campo está definido como CHAR |
MYSQLI_TYPE_GEOMETRY (integer) | El campo está definido como GEOMETRY |
MYSQLI_NEED_DATA (integer) | Obtiene más información para varibles enlazadas (bind) |
MYSQLI_NO_DATA (integer) | No obtiene más información para variables enlazadas (bind) |
Ejemplos
Todos los ejemplos en la documentación MySQLI usan la base de datos de MySQL AB. Puede ser encontrada en » https://dev.mysql.com/get/Downloads/Manual/world.sql.gz/from/pick
Table of Contents
- mysqli_affected_rows — Obtiene el número de filas afectadas en una operación de MySQL previa
- mysqli_autocommit — Activa o desactiva la modificación de auto-entrega de la base de datos
- mysqli_bind_param — Alias para mysqli_stmt_bind_param
- mysqli_bind_result — Alias para mysqli_stmt_bind_result
- mysqli_change_user — Cambia el usuario de la conexión a la base de datos especificada
- mysqli_character_set_name — Regresa el conjunto de caracteres determinados por default para la conexión de base de datos
- mysqli_client_encoding — Alias de mysqli_character_set_name
- mysqli_close — Cierra la conexión de base de datos previamente abierta
- mysqli_commit — Completa la transacción actual
- mysqli_connect_errno — Regresa el código de error de la última llamada a la conexión
- mysqli_connect_error — Regresa una descripción del último error de la conexión
- mysqli_connect — Abre una nueva conexión al servidor MySQL
- mysqli_data_seek — Ajusta el apuntador arbitrariamente a una fila en el resultado
- mysqli_debug — Realiza operaciones de rastreo de errores
- mysqli_disable_reads_from_master — Deshabilita lectura del Servidor maestro
- mysqli_disable_rpl_parse — Deshabilita el analizador RPL
- mysqli_dump_debug_info — VacÃa información de rastreo de errores en el log
- mysqli_embedded_server_end — Descripción
- mysqli_embedded_server_start — Descripción
- mysqli_enable_reads_from_master — Habilita la lectura del servidor Maestro
- mysqli_enable_rpl_parse — Habilita el analizador RPL
- mysqli_errno — Regresa el código de error para la función más recientemente llamada
- mysqli_error — Regresa una cadena con la descripció del último error
- mysqli_escape_string — Alias de mysqli_real_escape_string
- mysqli_execute — Alias de mysqli_stmt_execute
- mysqli_fetch_array — Obtiene una fila como una matriz asociativa, una matriz numérica o ambos
- mysqli_fetch_assoc — Obtiene una fila del resultado como una matriz asociativa
- mysqli_fetch_field_direct — Obtiene los metadatos de un campo
- mysqli_fetch_field — Regresa metadatos de el campo en el resultado
- mysqli_fetch_fields — Regresa una matriz de objetos representando los campos en un resultado
- mysqli_fetch_lengths — Regresa la longitud de las columnas de la fila actual en el resultado
- mysqli_fetch_object — Regresa la fila actual del resultado como un objeto
- mysqli_fetch_row — Obtiene una fila del resultado como una matriz enumerada
- mysqli_fetch — Alias de mysqli_stmt_fetch
- mysqli_field_count — Regresa el número de columnas para la consulta más reciente
- mysqli_field_seek — Fija el apuntador del resultado a una posicion especÃfica
- mysqli_field_tell — Obtiene la posición de desplazamiento del apuntador de un resultado
- mysqli_free_result — Libera la memoria asociada con el resultado
- mysqli_get_charset — Returns a character set object
- mysqli_get_client_info — Regresa en una cadena la versión del cliente de MySQL
- mysqli_get_client_version — Obtiene información del cliente MySQL
- mysqli_get_host_info — Regresa una cadena que representa el tipo de conexión usada
- mysqli_get_metadata — Alias para mysqli_stmt_result_metadata
- mysqli_get_proto_info — Regresa la versión del protocolo de MySQL usado
- mysqli_get_server_info — Regresa la version del servidor de MySQL
- mysqli_get_server_version — Regresa la versión del servidor MySQL como un entero
- mysqli_get_warnings — Descripción
- mysqli_info — Obtiene información acerca de la consulta más recientemente ejecutada
- mysqli_init — Inicializa MySQLi y regresa un objeto para ser usado con mysqli_rea_connect
- mysqli_insert_id — Regresa el ID generado automáticamente en la última consulta
- mysqli_kill — Le pide al servidor "matar" el proceso MySQL
- mysqli_master_query — Hace cumplir la ejecución de una consulta en el servidor en una configuración cliente/servidor
- mysqli_more_results — Checa si hay má resultados de consultas de una consulta múltiple
- mysqli_multi_query — Ejecuta una consulta en la base de datos
- mysqli_next_result — Prepara el siguiente resultado de una consulta múltiple
- mysqli_num_fields — Obtiene el número de campos en un resultado Get the number of fields in a result
- mysqli_num_rows — Obtiene el número de filas en un resultado
- mysqli_options — Fija opciones
- mysqli_param_count — Alias para mysqli_stmt_param_count
- mysqli_ping — Revisa una conexión al servidor o intenta reconectar si la conexión se ha perdido
- mysqli_prepare — Prepara una sentencia SQL para su ejecución
- mysqli_query — Ejecuta una consulta en la base de datos
- mysqli_real_connect — Abre una conexión a un servidor de MySQL
- mysqli_real_escape_string — Protege caracteres especiales en una cadena para ser usada en una sentencia SQL, tomando en cuenta el conjunto de caracteres para la conexión
- mysqli_real_query — Ejecuta una consulta SQL
- mysqli_report — Habilita o deshabilita las funciones internas de reporte
- mysqli_rollback — Regresa/deshace la transacción actual
- mysqli_rpl_parse_enabled — Revisa si el analizador RPL está habilitado
- mysqli_rpl_probe — Prueba RPL
- mysqli_rpl_query_type — Regresa el tipo de consulta RPL
- mysqli_select_db — Selecciona la base de datos por defecto para las consultas de la base de datos
- mysqli_send_long_data — Alias para mysqli_stmt_send_long_data
- mysqli_send_query — EnvÃa la consulta y regresa
- mysqli_server_end — Termina el proceso del Servidor
- mysqli_server_init — Inicializa un servidor embebido
- mysqli_set_charset — Sets the default client character set
- mysqli_set_local_infile_default — Unsets user defined handler for load local infile command
- mysqli_set_local_infile_handler — Set callback functions for LOAD DATA LOCAL INFILE command
- mysqli_set_opt — Alias de mysqli_options
- mysqli_slave_query — Force execution of a query on a slave in a master/slave setup
- mysqli_sqlstate — Regresa el error SQLSTATE de la operación MySQL previa
- mysqli_ssl_set — Usado para establecer conexiones seguras usando SSL
- mysqli_stat — Obtiene el estado actual del sistema
- mysqli_stmt_affected_rows — Regresa el número total de filas cambiadas, borradas o insertadas por la última sentencia ejecutada
- mysqli_stmt_attr_get — Descripción
- mysqli_stmt_attr_set — Descripción
- mysqli_stmt_bind_param — Enlaza variables como parámetros a una sentencia preparada
- mysqli_stmt_bind_result — Enlaza variables a una sentencia preparada para el almacenamiento del resultado
- mysqli_stmt_close — Cierra la sentencia preparada
- mysqli_stmt_data_seek — Busca una fila arbitrariamente en el resultado
- mysqli_stmt_errno — Regresa el código de error para la llamada más reciente
- mysqli_stmt_error — Regresa una descipción para el último error
- mysqli_stmt_execute — Ejecuta una consulta preparada
- mysqli_stmt_fetch — Obtiene el resultado de una sentencia SQL preparada en las variables enlazadas
- mysqli_stmt_field_count — Returns the number of field in the given statement
- mysqli_stmt_free_result — Libera la memoria donde se almacenó el resultado
- mysqli_stmt_get_warnings — Descripción
- mysqli_stmt_init — Inicializa una sentencia y regresa un objeto para ser usado con mysqli_stmt_prepare
- mysqli_stmt_insert_id — Get the ID generated from the previous INSERT operation
- mysqli_stmt_num_rows — Regresa el número de filas en un resultado de la sentencia
- mysqli_stmt_param_count — Regresa el número de parámetros para la sentencia dada
- mysqli_stmt_prepare — Prepara una sentencia SQL para su ejecución
- mysqli_stmt_reset — Resetea una sentencia preparada
- mysqli_stmt_result_metadata — Regresa metadatos del resultado de una sentencia preparada
- mysqli_stmt_send_long_data — EnvÃa los datos en bloques
- mysqli_stmt_sqlstate — Regresa el error SQLSTATE de la operación con sentencias previa
- mysqli_stmt_store_result — Transfiere un resultado de una sentencia preparada
- mysqli_store_result — Transfiere un resultado de la última consulta
- mysqli_thread_id — Regresa el identificador del THREAD para la conexión actual
- mysqli_thread_safe — Regresa si se ha dado un THREAD seguro o no Returns whether thread safety is given or not
- mysqli_use_result — Inicia una recuperación de un resultado
- mysqli_warning_count — Regresa el número de alertas de la última consulta para el identificador de enlace dado