Universidad Mariano Gálvez Diseño

Web Sección B
Vinicio Adalberto Alvarado Calderon
5190-13-5983

Tarea 3
Funciones mysql en php

Vinicio Alvarado Calderon

Contenido
Introducción...................................................................................................................................3
FUNCIONES MYSQL PARA PHP.................................................................................................4
mysql_affected_rows..................................................................................................................4
Descripción...............................................................................................................................4
Parámetros...............................................................................................................................4
Valores devueltos....................................................................................................................4
mysql_client_encoding...............................................................................................................5
Descripción...............................................................................................................................5
Parámetros...............................................................................................................................5
Valores devueltos....................................................................................................................5
mysql_close..................................................................................................................................6
Descripción...............................................................................................................................6
Parámetros...............................................................................................................................6
Valores devueltos....................................................................................................................6
mysql_connect.............................................................................................................................6
Descripción...............................................................................................................................6
Parámetros...............................................................................................................................7
Valores devueltos....................................................................................................................7
mysql_create_db.........................................................................................................................8
Descripción...............................................................................................................................8
Parámetros...............................................................................................................................8
Valores devueltos....................................................................................................................8
mysql_data_seek.........................................................................................................................8
mysql_db_query........................................................................................................................10
mysql_drop_db......................................................................................................................11
mysql_errno................................................................................................................................12
mysql_error.............................................................................................................................13
mysql_escape_string................................................................................................................14
mysql_fetch_array.....................................................................................................................15
mysql_fetch_assoc....................................................................................................................16
mysql_fetch_field.......................................................................................................................17

1
mysql_fetch_lengths.................................................................................................................18
mysql_fetch_object....................................................................................................................18
mysql_fetch_row........................................................................................................................19
mysql_field_flags.......................................................................................................................19
mysql_field_len..........................................................................................................................20
mysql_field_name......................................................................................................................20
mysql_field_seek.......................................................................................................................21
mysql_field_table.......................................................................................................................22
mysql_field_type........................................................................................................................23
mysql_free_result......................................................................................................................23
mysql_get_client_info...............................................................................................................24
mysql_get_host_info.................................................................................................................25
mysql_get_proto_info................................................................................................................25
mysql_get_server_info..............................................................................................................26
mysql_info..................................................................................................................................27
mysql_insert_id..........................................................................................................................27
mysql_list_dbs...........................................................................................................................28
mysql_list_fields.........................................................................................................................29
mysql_list_processes................................................................................................................30
mysql_list_tables.......................................................................................................................31
mysql_num_fields......................................................................................................................32
mysql_num_rows.......................................................................................................................32
mysql_pconnect.........................................................................................................................33
mysql_ping.................................................................................................................................34
mysql_query...............................................................................................................................35
mysql_real_escape_string........................................................................................................36
mysql_result...............................................................................................................................37
mysql_select_db........................................................................................................................39
mysql_set_charset....................................................................................................................39
mysql_stat..................................................................................................................................40
mysql_tablename......................................................................................................................41
mysql_thread_id........................................................................................................................42
mysql_unbuffered_query..........................................................................................................42

2
¿Hasta qué versión de php se pueden utilizar?........................................................................43
¿En qué versión ya no se incluyen?...........................................................................................43
¿Por qué se dejan de usar?.........................................................................................................43
¿Cuáles son las nuevas versiones de estas funciones de bases de datos y sus
diferencias?....................................................................................................................................44
Extensión MySQL....................................................................................................................44
mysqli — La clase mysqli.....................................................................................................44
mysqli_stmt — La clase mysqli_stmt..................................................................................46
mysqli_result — La clase mysqli_result..............................................................................47
mysqli_driver — La clase mysqli_driver.............................................................................48
mysqli_warning — La clase mysqli_warning.....................................................................48
mysqli_sql_exception — La clase mysqli_sql_exception.................................................48
Alias y Funciones de MySQLi obsoletos............................................................................48

3
Introducción
Muchas funciones de MySQL aceptan link_identifier como último parámetro. Si no se
proviene, se utilizará la última conexión abierta. Si esta no existe, se intentará establecer
conexión con el parámetro predeterminado definido en php.ini. Si no hay éxito, las
funciones devuelven FALSE

FUNCIONES MYSQL PARA PHP

mysql_affected_rows
Obtiene el número de filas afectadas en la anterior operación de MySQL

Descripción
int mysql_affected_rows ([ resource $link_identifier = NULL ] )
Obtiene el número de filas afectadas por la última consulta INSERT, UPDATE, REPLACE
o DELETE asociada con link_identifier.

Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

Valores devueltos
Devuelve el número de filas afectadas en caso de éxito, y -1 si la última consulta falló.
Si la consulta anterior fue DELETE con ninguna cláusula WHERE, todos los registros
habrán sido borrados de la tabla, aunque ésta función devolverá cero con una versión
anterior a MySQL 4.1.2.
Al utilizar UPDATE, MySQL no actualiza las columnas donde el nuevo valor es el mismo
que el anterior. Esto crea la posibilidad de que mysql_affected_rows() no pueda equivaler
en realidad al número de filas encontradas, solamente el número de filas que estuvieron
literalmente afectadas por la consulta.
La sentencia REPLACE primero borra el registro con la misma clave primaria y luego
inserta el nuevo registro. Esta función devuelve el número de registros borrados más el
número de registros insertados.
En el caso de consultas "INSERT ... ON DUPLICATE KEY UPDATE", el valor devuelto
será 1 si se realizó una inserción, o 2 para una actualización de una fila existente.

4
mysql_client_encoding
Devuelve el nombre del conjunto de caracteres

Descripción

String mysql_client_encoding ([ resource $link_identifier = NULL ] )

Recupera la variable character_set de MySQL.

Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

Valores devueltos
Devuelve el nombre del conjunto de caracteres predeterminado de la conexión actual.

5
mysql_close
Cerrar una conexión de MySQL

Descripción
Bool mysql_close ([ resource $link_identifier = NULL ] )
mysql_close() cierra la conexión no persistente al servidor de MySQL que está asociada
con el identificador de enlace especificado. Si link_identifier no se especifica, se usará el
último enlace abierto.
Las conexiones de MySQL no persistentes y los conjuntos de resultados son
automáticamente destruidos cuando un script de PHP finaliza su ejecución. Por tanto,
aunque el cierre explícito de conexiones abiertas y la liberación de conjuntos de
resultados sean opcionales, se recomienda hacerlos. Así, se devolverán inmediatamente
los recursos a PHP y a MySQL, lo que puede mejorar el rendimiento. Para información
detalla, véase la liberación de recursos

Parámetros
link_identifier
La conexión MySQL. Si no se especifica el enlace, se asumirá el último enlace abierto
por mysql_connect(). Si no se encuentra o no se puede establecer la conexión se
producirá un error del nivel E_WARNING.

Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_connect
Abre una conexión al servidor MySQL

Descripción
resource mysql_connect ([ string $server =
ini_get("mysql.default_host") [, string $username =
ini_get("mysql.default_user") [, string $password =
ini_get("mysql.default_password") [, bool$new_link = false [, int $client_flags = 0 ]]]]] )
Abre o reutiliza una conexión a un servidor MySQL.

6
Parámetros
El servidor MySQL. También se puede incluir un número de puerto. P.ej.
"nombre_anfitrión:puerto" o una ruta a un socket local, p.ej. ":/ruta/al/socket" para el
servidor local.
Si la directiva PHP mysql.default_host no está definida (por defecto), el valor por defecto
es 'localhost:3306'. En modo seguro de SQL, éste parámetro es ignorado y siempre se
usa el valor 'localhost:3306'.
username
El nombre de usuario. El valor por defecto está definido por mysql.default_user. En modo
seguro de SQL, éste parámetro es ignorado y se usa el nombre de usuario que posee el
proceso del servidor.
password
La contraseña. El valor por defecto está definido por mysql.default_password. En modo
seguro de SQL, éste parámetro es ignorado y se usa la contraseña vacía.
new_link
Si se realiza una segunda llamada a mysql_connect() con los mismos argumentos, un
nuevo enlace no será establecido, pero en su lugar, será devuelto el identificador de
enlace del enlace ya abierto. El parámetro new_link modifica éste comportamiento y hace
que mysql_connect() siempre abra un nuevo enlace, aun si mysql_connect() fue llamada
antes con los mismos parámetros. En modo seguro de SQL, éste parámetro es ignorado.
client_flags
El parámetro client_flags puede ser una combinación de las siguientes constantes: 128
(habilita el manejo de LOAD DATA
LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNO
RE_SPACE oMYSQL_CLIENT_INTERACTIVE. Lea la sección sobre Constantes del
cliente MySQL para más información. En modo seguro de SQL, éste parámetro es
ignorado.

Valores devueltos
Devuelve un identificador de enlace de MySQL en caso de éxito o FALSE en caso de
error.

7
mysql_create_db
Crea una base de datos MySQL

Descripción
bool mysql_create_db ( string $database_name [, resource $link_identifier = NULL ] )
mysql_create_db() intenta crear una nueva base de datos en el servidor asociado con el
identificador de enlace especificado.

Parámetros
database_name
El nombre de la base de datos a crear.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_data_seek
Mueve el puntero de resultados interno
Descripción
bool mysql_data_seek ( resource $result , int $row_number )
mysql_data_seek() mueve el puntero de filas interno del resultado de MySQL asociado
con el identificador de resultado especificado para apuntar al número de fila especificada.

8
La siguiente llamada a una función de obtención de MySQL, tal
como mysql_fetch_assoc(), devolverá esa fila.
row_number empieza en 0. row_number debería ser un valor en el rango de 0
a mysql_num_rows() -1. Sin embargo, si el conjunto de resultados esta vacío
(mysql_num_rows() == 0), una búsqueda a 0 fallará con
un E_WARNING y mysql_data_seek() devolverá FALSE.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
row_number
Número de la fila deseada del puntero de resultados nuevo.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.
Notas
La función mysql_data_seek() puede ser usada solamente junto con mysql_query(), y no
conmysql_unbuffered_query().

 mysql_db_name — Recupera el nombre de la base de datos desde una

llamada a mysql_list_dbs
Descripción
string mysql_db_name ( resource $result , int $row [, mixed $field = NULL ] )
Recupera el nombre de la base de datos de una llamada a mysql_list_dbs().

9
Parámetros
result
El puntero de resultados desde una llamada a mysql_list_dbs().
row
El índice dentro del conjunto de resultados.
field
El nombre del campo.
Valores devueltos
Devuelve el nombre de la base de datos en caso de éxito, y FALSE en caso de error. Si
se devuelve FALSE, se usa mysql_error() para determinar la naturaleza del error.

mysql_db_query
Selecciona una base de datos y ejecuta una consulta sobre la misma
Descripción
resource mysql_db_query ( string $database , string $query [, resource $link_identifier =
NULL ] )
mysql_db_query() selecciona una base de datos y ejecuta una consulta en ella.
Parámetros
database
El nombre de la base de datos que va a ser seleccionada.
query
La consulta MySQL.
Los datos dentro de la consulta deben ser escapados apropiadamente.
link_identifier

10
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve un recurso de resultados de MySQL positivo al resultado de la consulta,
o FALSE en caso de error. La función también retorna TRUE/FALSE para las
consultas INSERT/UPDATE/DELETE indicando éxito/fallo.

mysql_drop_db
Elimina (DROP) una base de datos MySQL
Descripción
bool mysql_drop_db ( string $database_name [, resource $link_identifier = NULL ] )
mysql_drop_db() intenta eliminar (remover) una base de datos entera del servidor
asociado con el identificador de enlace especificado. Esta función es obsoleta; es
preferible usar mysql_query() para ejecutar una sentencia SQL DROP DATABASE en su
lugar.
Parámetros
database_name
El nombre de la base de datos que va a ser eliminada.

11
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_errno
Devuelve el valor numérico del mensaje de error de la última operación MySQL
Descripción
int mysql_errno ([ resource $link_identifier = NULL ] )
Devuelve el número de error de la última función MySQL.
Los errores que provienen del procesamiento de la base de datos MySQL ya no emiten
advertencias. En su lugar, utilice mysql_errno() para recuperar el código de error. Tenga
en cuenta que ésta función solamente devolverá el código de error de la función MySQL
ejecutada mas recientemente (sin incluir a mysql_error() y mysql_errno()), por lo que, si se
quiere usar, hay que asegurarse de revisar el valor antes de llamar otra función MySQL.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

12
Valores devueltos
Devuelve el número de error de la última función de MySQL, o 0 (cero) si no ha ocurrido
ningún error.

mysql_error
Devuelve el texto del mensaje de error de la operación MySQL anterior
Descripción
string mysql_error ([ resource $link_identifier = NULL ] )
Devuelve el texto del error de la última función MySQL. Los errores que provienen del
procesamiento de la base de datos MySQL ya no emiten advertencias. En su lugar,
utilice mysql_errno() para recuperar el código de error. Tenga en cuenta que ésta función
solamente devolverá el código de error de la función MySQL ejecutada mas
recientemente (sin incluir a mysql_error() y mysql_errno()), por lo que, si se quiere usar,
hay que asegurarse de revisar el valor antes de llamar otra función MySQL.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve el texto del error de la última función MySQL, o '' (una cadena vacía) si no ha
ocurrido ningún error.

13
mysql_escape_string
Escapa una cadena para ser usada en mysql_query
Descripción
string mysql_escape_string ( string $unescaped_string )
Esta función escapará unescaped_string, para que sea segura ponerla en
una mysql_query(). Esta función está obsoleta.
Esta función es idéntica a mysql_real_escape_string() excepto
que mysql_real_escape_string() toma un gestor de conexión y escapa la cadena de
acuerdo con el juego de carácteres actual. mysql_escape_string() no toma un argumento
de conexión y no respeta la configuración del juego de caracteres actual.
Parámetros
unescaped_string
La cadena que va a ser escapada.
Valores devueltos
Devuelve la cadena escapada.

14
mysql_fetch_array
Recupera una fila de resultados como un array asociativo, un array numérico o como
ambos
Descripción
array mysql_fetch_array ( resource $result [, int $result_type = MYSQL_BOTH ] )
Devuelve un array que corresponde a la fila recuperada y mueve el puntero de datos
interno hacia delante.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
result_type
El tipo de array que va a ser devuelto. Es una constante y puede tomar los siguientes
valores: MYSQL_ASSOC,MYSQL_NUM, y MYSQL_BOTH.
Valores devueltos
Devuelve un array de cadenas que corresponde a la fila recuperada, o FALSE si no hay
más filas. El tipo del array retornado depende de como esté definido result_type. Al
utilizar MYSQL_BOTH (predeterminado), se obtendrá un array con ambos índices:
asociativos y numéricos. Al utilizar MYSQL_ASSOC, se obtienen solo los índices
asociativos (tal como funciona mysql_fetch_assoc()). Al utilizar MYSQL_NUM, se obtienen
solo los índices numéricos (tal como funciona mysql_fetch_row()).
Si dos o más columnas del resultado tienen el mismo nombre de campo, la última
columna tomará precedencia. Para acceder a la/s otra/s columna/s con el mismo nombre,
se deberá usar el índice numérico de la columna o crear un alias para la columna. Para
las columnas con alias, no se puede acceder al contenido con el nombre de la columna
original.

15
mysql_fetch_assoc
Recupera una fila de resultados como un array asociativo.
Descripción
array mysql_fetch_assoc ( resource $result )
Devuelve un array asociativo que corresponde a la fila recuperada y mueve el puntero de
datos interno hacia adelante. mysql_fetch_assoc() es equivalente a llamar
a mysql_fetch_array() con MYSQL_ASSOC como segundo parámetro opcional.
Únicamente devuelve un array asociativo.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
Valores devueltos
Devuelve un array asociativo de strings que corresponde a la fila recuperada, o FALSE si
no hay más filas disponibles.
Si dos o más columnas del resultado tienen los mismos nombres de campo, la última
columna tomará precedencia. Para acceder a la/s otra/s columna/s con el mismo nombre,

16
se tendrá que acceder al resultado con índices numéricos mediante el uso
de mysql_fetch_row() o agregando sobrenombres.

mysql_fetch_field
Obtiene la información de una columna de un resultado y la devuelve como un objeto
Descripción
object mysql_fetch_field ( resource $result [, int $field_offset = 0 ] )
Devuelve un objeto que contiene la información de los campos. Esta función puede ser
usada para obtener información sobre campos en el resultado de la consulta
proporcionada.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset
El índice numérico del campo. Si el índice del campo no se especifica, se recuperará el
siguiente campo que aún no haya recuperado esta función. Los índices
de field_offset comienzan en 0.
Valores devueltos
Devuelve un object que contiene la información del campo. Las propiedades del objeto
son:

 name - nombre de la columna

 table - nombre de la tabla a la que pertenece la columna, el cual es el

sobrenombre si alguno está definido

 max_length - longitud máxima de la columna

 not_null - 1 si la columna no puede ser NULL

 primary_key - 1 si la columna es una clave primaria

 unique_key - 1 si la columna es una clave única

 multiple_key - 1 si la colmuna es una clave no única

 numeric - 1 si la columna es numérica

 blob - 1 si la columna es un BLOB

 type - el tipo de la columna

 unsigned - 1 si la columna es sin signo

17
 zerofill - 1 si la columna es rellena de ceros

mysql_fetch_lengths
Obtiene la longitud de cada salida en un resultado
Descripción
array mysql_fetch_lengths ( resource $result )
Devuelve un array que corresponde a las longitudes de cada campo de la última fila
recuperada por MySQL.
mysql_fetch_lengths() almacena las longitudes de cada columna del resultado en la última
fila devuelta mediante mysql_fetch_row(), mysql_fetch_assoc(), mysql_fetch_array(),
y mysql_fetch_object() en un array, comenzando desde el índice 0.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
Valores devueltos
Un array de longitudes en caso de éxito o FALSE en caso de error.

mysql_fetch_object
Recupera una fila de resultados como un objeto
Descripción
object mysql_fetch_object ( resource $result [, string $class_name [, array $params ]] )
Devuelve un objeto con propiedades que corresponden a la fila recuperada y mueve el
puntero interno hacia delante.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
class_name
El nombre de la clase donde instanciar, configurar las propiedades y devolver. Si no se
especifica, se devuelve un objeto stdClass.
params

18
Un array opcional de Parámetros para pasar al constructor de los objetos class_name.
Valores devueltos
Devuelve un object con propiedades de tipo string que se corresponden con la fila
recuperada, o FALSE si no quedan más filas.

mysql_fetch_row
Obtiene una fila de resultados como un array numérico
Descripción
array mysql_fetch_row ( resource $result )
Devuelve un array numérico que corresponde a la fila recuperada y mueve el puntero de
datos interno hacia delante.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
Valores devueltos
Devuelve un array numérico que corresponde a la fila recuperada, o FALSE si no quedan
más filas.
mysql_fetch_row() recupera una fila de datos del resultado asociado al identificador de
resultados especificado. La fila es devuelta como un array. Cada columna del resultado es
almacenada en un índice del array, empezando desde 0.

mysql_field_flags
Obtiene las banderas asociadas al campo especificado de un resultado
Descripción
string mysql_field_flags ( resource $result , int $field_offset )
mysql_field_flags() devuelve las banderas del campo especificado. Las banderas son
reportadas como una sola palabra por bandera, separada por un solo espacio, por lo que
se puede dividir el valor devuelto usando explode().
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset

19
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
Devuelve un string de banderas asociadas con el resultado o FALSE en caso de error.
Las siguientes banderas son reportadas si la versión de MySQL es suficientemente actual
para
soportarlas: "not_null", "primary_key", "unique_key", "multiple_key", "blob", "unsigned", "ze
rofill", "binary", "enum","auto_increment" y "timestamp".

mysql_field_len
Devuelve la longitud del campo especificado
Descripción
int mysql_field_len ( resource $result , int $field_offset )
mysql_field_len() devuelve la longitud del campo especificado.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
La longitud del índice del campo especificado en caso de éxito o FALSE en caso de error.

mysql_field_name
Obtiene el nombre del campo especificado de un resultado
Descripción
string mysql_field_name ( resource $result , int $field_offset )
mysql_field_name() devuelve el nombre del índice del campo especificado.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().

20
field_offset
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
El nombre del índice del campo especificado en caso de éxito o FALSE en caso de error.

mysql_field_seek
Establece el puntero del resultado en un índice de campo específicado
Descripción
bool mysql_field_seek ( resource $result , int $field_offset )
Busca el índice del campo especificado. Si la siguiente llamada a mysql_fetch_field() no
incluye un índice de campo, será devuelto el índice del campo especificado
en mysql_field_seek().
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset

21
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_field_table
Obtiene el nombre de la tabla en la que está el campo especificado
Descripción
string mysql_field_table ( resource $result , int $field_offset )
Devuelve el nombre de la tabla en la que está el campo especificado.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
El nombre de la tabla en caso de éxito.

22
mysql_field_type
Obtiene el tipo del campo especificado de un resultado
Descripción
string mysql_field_type ( resource $result , int $field_offset )
mysql_field_type() es similar a la función mysql_field_name(). Los argumentos son
idénticos, pero se devuelve en su lugar el tipo de campo.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
field_offset
El número del campo a buscar. El valor de field_offset comienza en 0. Si field_offset no
existe, un error de nivel E_WARNING es emitido.
Valores devueltos
El tipo de campo devuelto será uno de los siguientes: "int", "real", "string", "blob", y otros
tal como se detalla en » la documentación de MySQL.

mysql_free_result
Libera la memoria del resultado
Descripción
bool mysql_free_result ( resource $result )
mysql_free_result() liberará toda la memoria asociada con el identificador del
resultado result.
mysql_free_result() solo necesita ser llamado si se está preocupado por la cantidad de
memoria que está siendo usada por las consultas que devuelven conjuntos de resultados
grandes. Toda la memoria de resultados asociada se liberará automaticamente al finalizar
la ejecución del script.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

23
Si se utiliza un recurso no válido para result, se emitirá un error de nivel E_WARNING.
Vale la pena señalar quemysql_query() solo devuelve un recurso para las consultas
SELECT, SHOW, EXPLAIN, y DESCRIBE.

mysql_get_client_info
Obtiene información del cliente MySQL
Descripción
string mysql_get_client_info ( void )
mysql_get_client_info() devuelve un string que representa la versión de la biblioteca
cliente.
Valores devueltos
La versión del cliente MySQL.

24
mysql_get_host_info
Obtener información del anfitrión de MySQL
Descripción
string mysql_get_host_info ([ resource $link_identifier = NULL ] )
Describe el tipo de conexión en uso, incluyendo el nombre del servidor anfitrión.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve un string que describe el tipo de conexión MySQL en uso, o o FALSE en caso
de error.

mysql_get_proto_info
Obtener información del protocolo MySQL
Descripción
int mysql_get_proto_info ([ resource $link_identifier = NULL ] )
Recupera el protocolo MySQL.
Parámetros
link_identifier

25
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve el protocolo MySQL en caso de éxito o FALSE en caso de error.

mysql_get_server_info
Obtiene información del servidor MySQL
Descripción
string mysql_get_server_info ([ resource $link_identifier = NULL ] )
Recupera la versión del servidor MySQL.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve la versión del servidor MySQL en caso de éxito o FALSE en caso de error.

26
mysql_info
Obtiene información sobre la consulta más reciente
Descripción
string mysql_info ([ resource $link_identifier = NULL ] )
Devuelve información detallada sobre la última consulta.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve información sobre la sentencia en caso de éxito, o FALSE en caso de error. Vea
el ejemplo siguiente para conocer qué sentencias proveen información, y cuál puede ser
la apariencia del valor devuelto. Las sentencias que no están en la lista
devolverán FALSE.

mysql_insert_id
Obtiene el ID generado en la última consulta
Descripción
int mysql_insert_id ([ resource $link_identifier = NULL ] )
Recupera el ID generado por la consulta anterior (normalmente INSERT) para una
columna AUTO_INCREMENT.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un

27
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
El ID generado por la consulta anterior para una columna AUTO_INCREMENT en caso de
éxito, 0 si la consulta anterior no genera un valor AUTO_INCREMENT, o FALSE si no se
estableció una conexión MySQL.

mysql_list_dbs
Lista las bases de datos disponibles en un servidor MySQL
Descripción
resource mysql_list_dbs ([ resource $link_identifier = NULL ] )
Devuelve un puntero de resultados que contiene las bases de datos disponibles en el
demonio de mysql actual.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve un resource de puntero de resultados en caso de éxito, o FALSE en caso de
error. Use la función mysql_tablename() para atravesar este puntero de resultado, o
cualquier función para obtener tablas, tal comomysql_fetch_array().

28
mysql_list_fields
Lista los campos de una tabla de MySQL
Descripción
resource mysql_list_fields ( string $database_name , string $table_name [, resource$link_i
dentifier = NULL ] )
Devuelve información sobre el nombre de la tabla dado.
Esta función está obsoleta. Es preferible usar mysql_query() para ejecutar una consulta
SQL SHOW COLUMNS FROM tabla [LIKE 'nombre'] en su lugar.
Parámetros
database_name
El nombre de la base de la base de datos que está siendo consultada.
table_name
El nombre de la tabla que está siendo consultada.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Un resource del puntero del resultado en caso de éxito, o FALSE en caso de error.

29
El resultado devuelto puede ser usado con mysql_field_flags(), mysql_field_len(),
mysql_field_name() ymysql_field_type().

mysql_list_processes
Lista los procesos de MySQL
Descripción
resource mysql_list_processes ([ resource $link_identifier = NULL ] )
Recupera los hilos del servidor MySQL actuales.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Un puntero de resultados de tipo resource en caso de éxito o FALSE en caso de error.

30
mysql_list_tables
Enumerar las tablas de una base de datos MySQL
Descripción
resource mysql_list_tables ( string $database [, resource $link_identifier = NULL ] )
Devuelve una lista con el nombre de las tablas de una base de datos MySQL.
Esta función está obsoleta. Es preferible usar mysql_query() para ejecutar la sentencia
SQL SHOW TABLES [FROM nombre_bd] [LIKE 'patrón'] en su lugar.
Parámetros
database
El nombre de la base de datos
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
El puntero de resultados de tipo resource en caso de éxito o FALSE en caso de error.
Use la función mysql_tablename() para atravesar este puntero de resultados, o cualquier
otra función para mostrar tablas, como mysql_fetch_array().

31
mysql_num_fields
Obtiene el número de campos de un resultado
Descripción
int mysql_num_fields ( resource $result )
Obtiene el número de campos de una consulta.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
Valores devueltos
Devuelve el número de campos del resource de conjunto de resultados en caso de éxito
o FALSE en caso de error.

mysql_num_rows
Obtener el número de filas de un conjunto de resultados
Descripción
int mysql_num_rows ( resource $result )
Recupera el número de filas de un conjunto de resultados. Este comando es únicamente
válido para sentencias como SELECT o SHOW que retornan un conjunto de resultados
real. Para recuperar el número de filas afectadas por una consulta INSERT, UPDATE,
REPLACE o DELETE, use mysql_affected_rows().
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().

32
Valores devueltos
El número de filas de un conjunto de resultados en caso de éxito o FALSE en caso de
error.

mysql_pconnect
Abre una conexión persistente a un servidor MySQL
Descripción
resource mysql_pconnect ([ string $server =
ini_get("mysql.default_host") [, string $username =
ini_get("mysql.default_user") [, string $password =
ini_get("mysql.default_password") [, int$client_flags = 0 ]]]] )
Establece una conexión persistente a un servidor MySQL.
mysql_pconnect() se parece mucho a mysql_connect() con dos grandes diferencias.
En primer lugar, cuando se conecta, la función primero intenta encontrar un enlace
(persistente) que ya esté abierto con el mismo anfitrión, nombre de usuario y contraseña.
Si se encuentra uno, se devolverá un identificador para él, en lugar de abrir una nueva
conexión.
Segundo, la conexión al servidor SQL no será cerrada cuando la ejecución del script
finalice. En su lugar, el enlace permanecerá abierto para su uso futuro (mysql_close() no
cerrará los enlaces establecidos mediante mysql_pconnect()).
Por eso a este tipo de enlace se le llama 'persistente'.
Parámetros
server
El servidor de MySQL. También puede incluir un número de puerto. P.ej.
"nombre_anfitrión:puerto" o una ruta a un socket local, p.ej. ":/ruta/al/socket" para el
localhost.

33
Si la directiva de PHP mysql.default_host no se ha definido (predeterminado), entonces el
valor por defecto es 'localhost:3306'
username
El nombre de usuario. El valor por defecto es el nombre del usuario al que pertenece el
proceso del servidor.
password
La contraseña. El valor por defecto es una contraseña vacia.
client_flags
El parámetro client_flags puede ser una combinación de las siguientes constantes: 128
(habilita el manejo de LOAD DATA
LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNO
RE_SPACE oMYSQL_CLIENT_INTERACTIVE.
Valores devueltos
Devuelve un identificador de enlace persistente a MySQL en caso de éxito o FALSE en
caso de error.

mysql_ping
Efectuar un chequeo de respuesta (ping) sobre una conexión al servidor o reconectarse si
no hay conexión
Descripción
bool mysql_ping ([ resource $link_identifier = NULL ] )
Chequea si está activa o no la conexión con el servidor. Si ésta se ha caído, se intenta
una reconexión automática. Esta función puede ser usada por scripts que permanecen
pasivos durante largos espacios de tiempo, para chequear si el servidor ha cerrado la
conexión y reconectarse de ser necesario.
Nota:
La reconexión automática está deshabilitada de forma predeterminada en versiones de
MySQL >= 5.0.3.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

34
Valores devueltos
Devuelve TRUE si la conexión con el servidor MySQL está funcionando, o FALSE si no.

mysql_query
Enviar una consulta MySQL
Descripción
mixed mysql_query ( string $query [, resource $link_identifier = NULL ] )
mysql_query() envía una única consulta (no hay soporte para múltiples consultas) a la
base de datos actualmente activa en el servidor asociado con el identificador de enlace
especificado por link_identifier.
Parámetros
query
Una consulta SQL
El string de la consulta no debería terminar con un punto y coma. Los datos insertados en
la consulta deberían estar correctamente escapados.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.

35
Valores devueltos
Para SELECT, SHOW, DESCRIBE, EXPLAIN y otras sentencias que retornan un conjunto
de resultados, mysql_query()devuelve un resource en caso de éxito, o FALSE en caso de
error.
Para otros tipos de sentencias SQL, tales como INSERT, UPDATE, DELETE, DROP,
etc, mysql_query() devuelve TRUEen caso de éxito o FALSE en caso de error.
El conjunto de resultados devuelto debería ser pasado a mysql_fetch_array(), y otras
funciones para manejar las tablas del resultado, para acceder a los datos retornados.
Use mysql_num_rows() para averiguar cuántas filas fueron devueltas por la sentencia
SELECT, omysql_affected_rows() para averiguar cuántas filas fueron afectadas por las
sentencias DELETE, INSERT, REPLACE, o UPDATE.
mysql_query() también fallará y retornará FALSE si el usuario no está autorizado para
acceder a la/s tabla/s a la/s que hace referencia la consulta.

mysql_real_escape_string
Escapa caracteres especiales en una cadena para su uso en una sentencia SQL
Descripción
string mysql_real_escape_string ( string $unescaped_string [, resource $link_identifier =
NULL] )
Escapa caracteres especiales en la cadena dada por unescaped_string, teniendo en
cuenta el conjunto de caracteres en uso de la conexión, para que sea seguro usarla
en mysql_query(). Si se van a insertar datos binarios, se ha de usar esta función.
mysql_real_escape_string() llama a la función mysql_real_escape_string de la biblioteca
de MySQL, la cual antepone barras invertidas a los siguientes
caracteres: \x00, \n, \r, \, ', " y \x1a.
Esta función siempre debe usarse (con pocas excepciones) para hacer seguros los datos
antes de enviar una consulta a MySQL.

36
Precaución
Seguridad: el conjunto de caracters predeterminado
El conjunto de caracteres debe ser establecido o bien a nivel del servidor, o bien con la
función mysql_set_charset() de la API para que afecte a mysql_real_escape_string().
Véase la sección sobre los conceptos de conjuntos de caracters para más información.
Parámetros
unescaped_string
La cadena a escapar.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve la cadena escapada, o FALSE en caso de error.
Errores/Excepciones
Ejecutar esta función sin una conexión de MySQL presente también emitirá errores de
nivel E_WARNING de PHP. Solo se ha de ejecutar con una conexión de MySQL válida
presente.

mysql_result
Obtener datos de resultado
Descripción
string mysql_result ( resource $result , int $row [, mixed $field = 0 ] )
Recupera el contenido de una celda de un conjunto de resultados de MySQL.

37
Cuando se esté trabajando con conjuntos de resultados grandes, se debería considerar
usar una de las funciones que obtienen una fila completa (especificadas más abajo).
Debido a que estas funciones retornan el contenido de múltiples celdas en una única
llamada a función, son MUCHO MÁS rápidas que mysql_result(). Además, se ha de tener
en cuenta que la especificación de un índice numérico para el campo pasado como
argumento es mucho más rápido que especificar un nombre de campo o el argumento
nombre_tabla.nombre_campo.
Parámetros
result
El resultado resource que está siendo evaluado. Este resultado proviene de una llamada
a mysql_query().
row
El número de fila del conjunto de resultados que está siendo recuperado. El número de
filas empieza a partir de 0.
field
El nombre o el índice del campo que está siendo recuperado.
Puede ser el índice del campo, el nombre del campo, o el nombre de la tabla punto
nombre del campo (nombre_tabla.nombre_campo). Si se ha utilizado un alias para el
nombre de la columna ('select foo as bar from...'), utilice el alias en lugar del nombre del
campo. Si no está definido, se recuperará el primer campo.
Valores devueltos
El contenido de una celda de un conjunto de resultados de MySQL en caso de éxito,
o FALSE en caso de fallo.

38
mysql_select_db
Seleccionar una base de datos MySQL
Descripción
bool mysql_select_db ( string $database_name [, resource $link_identifier = NULL ] )
Establece la base de datos activa actual en el servidor asociado con el identificador de
enlace especificado. Cada llamada posterior a mysql_query() será ejecutada en la base
de datos activa.
Parámetros
database_name
El nombre de la base de datos que va a ser seleccionada.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_set_charset
Establece el conjunto de caracteres del cliente
Descripción
bool mysql_set_charset ( string $charset [, resource $link_identifier = NULL ] )

39
Establece el conjunto de caracteres predeterminado para la conexión actual.
Parámetros
charset
Un nombre válido de un conjunto de caracteres.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve TRUE en caso de éxito o FALSE en caso de error.

mysql_stat
Obtiene el estado actual del sistema
Descripción
string mysql_stat ([ resource $link_identifier = NULL ] )
mysql_stat() devuelve el estado actual del servidor.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Devuelve un string con el estado del tiempo de funcionamiento, hilos, consultas, tablas
abiertas, tablas de volcado y consultas por segundo. Para obtener una lista completa de
variables de estado, es necesario usar el comando SQL SHOW STATUS.
Si link_identifier no es válido, se devuelve NULL.

40
mysql_tablename
Obtiene el nombre de la tabla de un campo
Descripción
string mysql_tablename ( resource $result , int $i )
Recupera el nombre de tabla desde un resultado dado por result.
Esta función está obsoleta. Es preferible usar mysql_query() para ejecutar una consulta
SQL SHOW TABLES [FROM nombre_bd] [LIKE 'patrón'] en su lugar.
Parámetros
result
Un resource de puntero de resultados que se devuelve desde mysql_list_tables().
El índice de tipo integer (número de fila/tabla)
Valores devueltos
El nombre de la tabla en caso de éxito o FALSE en caso de error.
Use la función mysql_tablename() para atravesar este puntero de resultados, o cualquier
función para obtener tablas, tal como mysql_fetch_array().

41
mysql_thread_id
Devuelve el ID del hilo actual
Descripción
int mysql_thread_id ([ resource $link_identifier = NULL ] )
Recupera el ID del hilo actual. Si la conexión se ha perdido, y se ejecuta una reconexión
con mysql_ping(), el ID del hilo cambiará. Esto quiere decir que sólo se ha de recuperar el
ID del hilo cuando sea necesario.
Parámetros
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
El ID del hilo en caso de éxito o FALSE en caso de error.

mysql_unbuffered_query
Envía una consulta SQL a MySQL, sin recuperar ni almacenar en búfer las filas de
resultados
Descripción
resource mysql_unbuffered_query ( string $query [, resource $link_identifier = NULL ] )
mysql_unbuffered_query() envía la consulta SQL query a MySQL, sin recuperar ni
almacenar automáticamente en búfer las filas de resultados, como mysql_query() lo hace.
Esto ahorra una considerable cantidad de memoria con las consultas SQL que producen
conjuntos de resultados grandes, y se puede empezar a trabajar con el conjunto de
resultados inmediatamente después de que la primera fila haya sido recuperada, ya que
no es necesario esperar hasta que la consulta SQL completa haya sido ejecutada. Para

42
usar mysql_unbuffered_query()mientras están abiertas múltiples conexiones a la base de
datos, se debe especificar el parámetro opcionallink_identifier para identificar qué
conexión se desea utilizar.
Parámetros
query
La consulta SQL a ejecutar.
Los datos dentro de la consulta deben estar propiamente escapados.
link_identifier
La conexión MySQL. Si no se especifica el identificador de enlace, se asume el último
enlace abierto por mysql_connect(). Si no se encuentra este enlace, se intentará crear un
nuevo enlace como si mysql_connect() hubiese sido invocada sin argumentos. Si no se
encuentra o establece ninguna conexión, se genera un error de nivel E_WARNING.
Valores devueltos
Para sentencias SELECT, SHOW, DESCRIBE o EXPLAIN, mysql_unbuffered_query()
devuelve un resource en caso de éxito, o FALSE en caso de error.
Para otro tipo de sentencias SQL, UPDATE, DELETE, DROP, etc,
mysql_unbuffered_query() devuelve TRUE en caso de éxito o FALSE en caso de error.

¿Hasta qué versión de php se pueden utilizar?

Las funciones listadas se pueden utilizar desde la versión 3 de php hasta las primeras
versiones de php 5.
(PHP 3 >= 4.0.6, PHP 5)

¿En qué versión ya no se incluyen?

Desde la versión 5.5.0 de php empezaron a hacer obsoletas y fueron eliminada en la
versión PHP 7.0.0.

¿Por qué se dejan de usar?

La API original de php que hacía uso de las extensiones de conexión a base de datos en
php, empezó a ser obsoleta desde la versión 5.5.0, por lo tanto no es recomendable para
la escritura de código, existiría problemas para las versiones posteriores a la ya
mencionada. Como solución están las extensiones mySQLi o PDO_MySQL.

43
¿Cuáles son las nuevas versiones de estas funciones
de bases de datos y sus diferencias?
Se deben utilizar las extensiones MySQLi o PDO_MySQL.

Extensión MySQL
mysqli — La clase mysqli
 mysqli::$affected_rows — Obtiene el número de filas afectadas en la última
operación MySQL
 mysqli::autocommit — Activa o desactiva las modificaciones de la base de
datos autoconsignadas
 mysqli::begin_transaction — Inicia una transacción
 mysqli::change_user — Cambia el usuario de la conexión de bases de
datos especificada
 mysqli::character_set_name — Devuelve el juego de caracteres
predeterminado para la conexión a la base de datos
 mysqli::$client_info — Obtiene información de la versión cliente de MySQL
 mysqli::$client_version — Devuelve la versión cliente de MySQL como una
cadena
 mysqli::close — Cierra una conexión previamente abierta a una base de
datos
 mysqli::commit — Consigna la transacción actual
 mysqli::$connect_errno — Devuelve el código de error de la última llamada
 mysqli::$connect_error — Devuelve una cadena con la Descripción del
último error de conexión
 mysqli::__construct — Abre una nueva conexión al servidor de MySQL
 mysqli::debug — Realiza operaciones de depuración
 mysqli::dump_debug_info — Volcado de información de depuración en el
registro
 mysqli::$errno — Devuelve el código del error de la última función llamada
 mysqli::$error_list — Devuelve una lista de errores desde el último
comando ejecutado
 mysqli::$error — Devuelve una cadena que describe el último error
 mysqli::$field_count — Devuelve el número de columnas para la consulta
más reciente
 mysqli::get_charset — Devuelve un objeto que contiene el conjunto de
caracteres
 mysqli::get_client_info — Obtiene información de la biblioteca cliente de
MySQL
 mysqli_get_client_stats — Devuelve estadísticas de clientes por proceso
 mysqli_get_client_version — Devuelve la versión clientes de MySQL como
valor de tipo integer
 mysqli::get_connection_stats — Devuelve estadísticas sobre la conexión
del cliente
 mysqli::$host_info — Devuelve una cadena que representa el tipo de
conexión usada

44
 mysqli::$protocol_version — Devuelve la versión del protocolo MySQL
utilizada
 mysqli::$server_info — Devuelve la versión del servidor MySQL
 mysqli::$server_version — Devuelve la versión del servidor MySQL como
un valor entero
 mysqli::get_warnings — Obtiene el resultado de SHOW WARNINGS
 mysqli::$info — Obtiene la información de la última consulta ejecutada
 mysqli::init — Inicializa y devuelve un recurso para utilizarlo con
mysqli_real_connect()
 mysqli::$insert_id — Devuelve el id autogenerado que se utilizó en la última
consulta
 mysqli::kill — Pide al servidor poner fin a un hilo de MySQL
 mysqli::more_results — Comprueba si hay más resultados de una multi
consulta
 mysqli::multi_query — Realiza una consulta a la base de datos
 mysqli::next_result — Prepara el siguiente resultado de multi_query
 mysqli::options — Establecer opciones
 mysqli::ping — Comprueba la conexión al servidor, o trata de reconectar si
se perdió la conexión
 mysqli::poll — Almacena en caché conexiones
 mysqli::prepare — Prepara una sentencia SQL para su ejecución
 mysqli::query — Realiza una consulta a la base de datos
 mysqli::real_connect — Abre una conexión a un servidor mysql
 mysqli::real_escape_string — Escapa los caracteres especiales de una
cadena para usarla en una sentencia SQL, tomando en cuenta el conjunto
de caracteres actual de la conexión
 mysqli::real_query — Ejecuta una consulta SQL
 mysqli::reap_async_query — Obtener el resultado de una consulta
asincrónica
 mysqli::refresh — Refresca
 mysqli::release_savepoint — Elimina el punto salvado con nombre del
conjunto de puntos salvados de la transacción actual
 mysqli::rollback — Revierte la transacción actual
 mysqli::rpl_query_type — Devuelve un tipo de consulta RPL
 mysqli::savepoint — Define el nombre de un punto de salvaguarda de la
transacción
 mysqli::select_db — Selecciona la base de datos por defecto para realizar
las consultas
 mysqli::send_query — Enviar una consulta y devolver
 mysqli::set_charset — Establece el conjunto de caracteres predeterminado
del cliente
 mysqli::set_local_infile_default — Desestablece el gestor definido por el
usuario para un comando load local infile
 mysqli::set_local_infile_handler — Establecer la llamada de retorno para el
comando LOAD DATA LOCAL INFILE
 mysqli::$sqlstate — Devuelve el error SQLSTATE de la operación de
MySQL previa
 mysqli::ssl_set — Usada para establece conexiones seguras usando SSL
 mysqli::stat — Obtiene el estado actual del sistema

45
  mysqli::stmt_init — Inicializa una sentencia y devuelve un objeto para
usarlo con mysqli_stmt_prepare
 mysqli::store_result — Transfiere un conjunto de resulados de la última
consulta
 mysqli::$thread_id — Deveulve el ID del hilo de la conexión actual
 mysqli::thread_safe — Devuelve si la seguridad a nivel de hilos está dada o
no
 mysqli::use_result — Inicia la recuperación de un conjunto de resultados
 mysqli::$warning_count — Devuelve el número de mensajes de
advertencia de la última consulta para un enlace dado

mysqli_stmt — La clase mysqli_stmt

 mysqli_stmt::$affected_rows — Devuelve el número total de filas
cambiadas, borradas, o insertadas por la última sentencia ejecutada
 mysqli_stmt::attr_get — Se utiliza para obtener el valor actual de un
atributo de la sentencia
 mysqli_stmt::attr_set — Se utiliza para modificar el comportamiento de una
sentencia preparada
 mysqli_stmt::bind_param — Agrega variables a una sentencia preparada
como parámetros
 mysqli_stmt::bind_result — Vincula variables a una sentencia preparada
para el almacenamiento de resultados
 mysqli_stmt::close — Cierra una sentencia preparada
 mysqli_stmt::__construct — Construye un nuevo objeto mysqli_stmt
 mysqli_stmt::data_seek — Busca una fila arbitraria en un conjunto de
resultados de una sentencia
 mysqli_stmt::$errno — Devuelve el código de error de la llamada de la
sentencia más reciente
 mysqli_stmt::$error_list — Devuelve una lista de errores de la última
sentencia ejecutada
 mysqli_stmt::$error — Devuelve una descripción en forma de string del
último error de una sentencia
 mysqli_stmt::execute — Ejecuta una consulta preparada
 mysqli_stmt::fetch — Obtiene los resultados de una sentencia preparadas
en las variables vinculadas
 mysqli_stmt::$field_count — Devuelve el número de campos de la
sentencia dada
 mysqli_stmt::free_result — Libera la memoria de los resultados
almacenados del gestor de sentencia dado
 mysqli_stmt::get_result — Obtiene un conjunto de resultados de una
sentencia preparada
 mysqli_stmt::get_warnings — Obtener los resultados de SHOW
WARNINGS
 mysqli_stmt::$insert_id — Obtener el ID generado en la operación INSERT
anterior
 mysqli_stmt::more_results — Comprobar si existen más resultados de una
consulta de consultas múltiples
 mysqli_stmt::next_result — Lee el siguiente resultado de una consulta
múltiple

46
  mysqli_stmt::$num_rows — Devuelve el número de filas de un conjunto de
resultados de una sentencia
 mysqli_stmt::$param_count — Devuelve el número de parámetros de la
sentencia dada
 mysqli_stmt::prepare — Preparar una sentencia SQL para su ejecución
 mysqli_stmt::reset — Reinicia una sentencia preparada
 mysqli_stmt::result_metadata — Devuelve los metadatos del conjunto de
resultados de una sentencia preparada
 mysqli_stmt::send_long_data — Enviar datos en bloques
 mysqli_stmt::$sqlstate — Devuelve el error SQLSTATE de la operación de
sentencia previa
 mysqli_stmt::store_result — Transfiere un conjunto de resultados desde
una sentencia preparada

mysqli_result — La clase mysqli_result

 mysqli_result::$current_field — Obtener posición del campo actual de un
puntero a un resultado
 mysqli_result::data_seek — Ajustar el puntero de resultado a una fila
arbitraria del resultado
 mysqli_result::fetch_all — Obtener todas las filas en un array asociativo,
numérico, o en ambos
 mysqli_result::fetch_array — Obtiene una fila de resultados como un array
asociativo, numérico, o ambos
 mysqli_result::fetch_assoc — Obtener una fila de resultado como un array
asociativo
 mysqli_result::fetch_field_direct — Obtener los metadatos de un único
campo
 mysqli_result::fetch_field — Retorna el próximo campo del resultset
 mysqli_result::fetch_fields — Devuelve un array de objetos que representan
los campos de un conjunto de resultados
 mysqli_result::fetch_object — Devuelve la fila actual de un conjunto de
resultados como un objeto
 mysqli_result::fetch_row — Obtener una fila de resultados como un array
enumerado
 mysqli_result::$field_count — Obtiene el número de campos de un
resultado
 mysqli_result::field_seek — Establecer el puntero del resultado al índice del
campo especificado
 mysqli_result::free — Libera la memoria asociada a un resultado
 mysqli_result::$lengths — Retorna los largos de las columnas de la fila
actual en el resultset
 mysqli_result::$num_rows — Obtiene el número de filas de un resultado

mysqli_driver — La clase mysqli_driver

 mysqli_driver::embedded_server_end — Detener el servidor incrustado
 mysqli_driver::embedded_server_start — Inicializa e inicia el servidor
embebido

47
  mysqli_driver::$report_mode — Habilita o desabilita las funciones internas
de notificación

mysqli_warning — La clase mysqli_warning

 mysqli_warning::__construct — El propósito __construct
 mysqli_warning::next — El propósito next

mysqli_sql_exception — La clase mysqli_sql_exception

Alias y Funciones de MySQLi obsoletos
 mysqli_bind_param — Alias de mysqli_stmt_bind_param
 mysqli_bind_result — Alias de mysqli_stmt_bind_result
 mysqli_client_encoding — Alias de mysqli_character_set_name
 mysqli_connect — Alias de mysqli::__construct
 mysqli_disable_reads_from_master — Deshabilita las lecturas
desde el maestro
 mysqli_disable_rpl_parse — Deshabilita el interprete RPL
 mysqli_enable_reads_from_master — Activa las lecturas desde el
maestro
 mysqli_enable_rpl_parse — Habilita el interprete RPL
 mysqli_escape_string — Alias de mysqli_real_escape_string
 mysqli_execute — Alias para mysqli_stmt_execute
 mysqli_fetch — Alias de mysqli_stmt_fetch
 mysqli_get_cache_stats — Devuelve las estadísticas de la caché de
Zval del cliente
 mysqli_get_links_stats — Devolver información sobre enlaces
abiertos y almacenados en caché
 mysqli_get_metadata — Alias de mysqli_stmt_result_metadata
 mysqli_master_query — Fuerza la ejecución de una cosulta en un
maestro en una configuración maestro/esclavo
 mysqli_param_count — Alias de mysqli_stmt_param_count
 mysqli_report — Alias de mysqli_driver->report_mode
 mysqli_rpl_parse_enabled — Verifica si está habilitado el interprete
RPL
 mysqli_rpl_probe — Exploración RPL
 mysqli_send_long_data — Alias de mysqli_stmt_send_long_data
 mysqli::set_opt — Alias de mysqli_options
 mysqli_slave_query — Fuerza la ejecución de una cosulta en un
esclavo en una configuración maestro/esclavo

48