Funciones de MySQL PHP
- Página anterior PHP Math
- Página siguiente PHP MySQLi
Introducción a PHP MySQL
Las funciones MySQL le permiten acceder al servidor de bases de datos MySQL.
Instalación
Para poder usar las funciones de esta clase sin problemas, debe agregar soporte para MySQL al compilar PHP.
Basta con usar la opción de configuración --with-mysql[=DIR] durante la compilación, donde [DIR] es opcional y se refiere al directorio de instalación de MySQL.
Aunque esta biblioteca de extensión MySQL es compatible con versiones 4.1.0 y posteriores de MySQL, no admite las funciones adicionales proporcionadas por estas versiones. Para usar estas funciones, utilice la biblioteca de extensión MySQLi.
Si se debe instalar tanto la biblioteca de extensión mysql como la biblioteca de extensión mysqli, debe usar la misma biblioteca de cliente para evitar cualquier conflicto.
Instalación en sistemas Linux
PHP 4
La opción --with-mysql se activa por defecto. Este comportamiento por defecto se puede prohibir utilizando la opción de configuración --without-mysql. Si se activa MySQL sin especificar el directorio de instalación, PHP usará la biblioteca de conexión del cliente MySQL asociada.
Los usuarios de otras aplicaciones que utilizan MySQL (por ejemplo, auth-mysql) no deben usar la biblioteca asociada, sino especificar el directorio de instalación de MySQL, como así: --with-mysql=/ruta/al/mysql. Esto obligará a PHP a usar la biblioteca de conexión del cliente que se instala con MySQL, evitando así cualquier conflicto.
PHP 5+
MySQL no está activado por defecto y no tiene biblioteca MySQL asociada. Utilice la opción de configuración --with-mysql[=DIR] para agregar soporte para MySQL. Puede hacerlo desde MySQL Descargue los archivos de encabezado y bibliotecas.
Instalación en sistemas Windows
PHP 4
La extensión PHP MySQL ya está compilada en PHP.
PHP 5+
MySQL no está activado por defecto, por lo tanto, debe activar la biblioteca de conexión dinámica php_mysql.dll en php.ini. Además, PHP necesita acceder a la biblioteca de conexión del cliente MySQL. La versión de Windows de PHP incluye un libmysql.dll, y para que PHP pueda comunicarse con MySQL, este archivo debe estar en la ruta del sistema PATH de Windows.
Para activar cualquier biblioteca de extensión PHP (por ejemplo, php_mysql.dll), la instrucción extension_dir debe establecerse en el directorio donde se encuentra la biblioteca de extensión PHP. Un ejemplo de valor para extension_dir en PHP 5 es c:\php\ext.
Comentarios:Si se produce un error similar al siguiente al iniciar el servidor web: "Unable to load dynamic library './php_mysql.dll'" es porque el sistema no encuentra php_mysql.dll y / o libmysql.dll.
Configuración en tiempo de ejecución
El comportamiento de las funciones de MySQL se ve afectado por la configuración establecida en php.ini.
Opciones de configuración de MySQL:
| Nombre | Predeterminado | Descripción | Modificable |
|---|---|---|---|
| mysql.allow_persistent | "1" | Permitir conexiones persistentes de MySQL. | PHP_INI_SYSTEM |
| mysql.max_persistent | "-1" | Número máximo de conexiones persistentes en cada proceso. | PHP_INI_SYSTEM |
| mysql.max_links | "-1" | Número máximo de conexiones en cada proceso, incluyendo las conexiones persistentes. | PHP_INI_SYSTEM |
| mysql.trace_mode | "0" | Modo de seguimiento. Disponible desde PHP 4.3.0. | PHP_INI_ALL |
| mysql.default_port | NULL | Especificar el número de puerto TCP predeterminado de conexión de base de datos. | PHP_INI_ALL |
| mysql.default_socket | NULL | Nombre de socket predeterminado. Disponible desde PHP 4.0.1. | PHP_INI_ALL |
| mysql.default_host | NULL | Dirección del servidor predeterminada. No se aplica al modo de seguridad SQL. | PHP_INI_ALL |
| mysql.default_user | NULL | Nombre de usuario predeterminado utilizado. No se aplica al modo de seguridad SQL. | PHP_INI_ALL |
| mysql.default_password | NULL | Contraseña predeterminada utilizada. No se aplica al modo de seguridad SQL. | PHP_INI_ALL |
| mysql.connect_timeout | "60" | Número de segundos de tiempo de espera de conexión. | PHP_INI_ALL |
Tipo de recurso
En el módulo MySQL se utilizan dos tipos de recursos. El primero es el manejador de conexión de la base de datos, y el segundo es el conjunto de resultados devuelto por la consulta SQL.
Funciones de MySQL PHP
PHP:Indica la versión más antigua de PHP que admite esta función.
| Función | Descripción | PHP |
|---|---|---|
| mysql_affected_rows() | Obtiene el número de filas afectadas por la última operación MySQL. | 3 |
| mysql_change_user() | No recomendado. Cambia el usuario de la conexión activa. | 3 |
| mysql_client_encoding() | Devuelve el nombre del conjunto de caracteres de la conexión actual. | 4 |
| mysql_close() | Cierra una conexión MySQL no persistente. | 3 |
| mysql_connect() | Abre una conexión MySQL no persistente. | 3 |
| mysql_create_db() | No recomendado. Crea una base de datos MySQL nueva. Usa mysql_query() en su lugar. | 3 |
| mysql_data_seek() | Mueve el puntero de registro. | 3 |
| mysql_db_name() | Devuelve el nombre de la base de datos desde la llamada a mysql_list_dbs(). | 3 |
| mysql_db_query() |
No recomendado. Envía una consulta MySQL. Usa mysql_select_db() y mysql_query() en su lugar. |
3 |
| mysql_drop_db() |
No recomendado. Elimina (borra) una base de datos MySQL. Utilice mysql_query() en su lugar. |
3 |
| mysql_errno() | Devuelve el código numérico del error de la última operación MySQL. | 3 |
| mysql_error() | Devuelve el mensaje de error de texto de la última operación MySQL. | 3 |
| mysql_escape_string() |
No recomendado. Escape una cadena para mysql_query. Usa mysql_real_escape_string() en su lugar. |
4 |
| mysql_fetch_array() | Obtiene una fila del conjunto de resultados como un array asociativo, un array numérico o ambos. | 3 |
| mysql_fetch_assoc() | Obtiene una fila del conjunto de resultados como un array asociativo. | 4 |
| mysql_fetch_field() | Obtiene la información de las columnas del conjunto de resultados y la devuelve como un objeto. | 3 |
| mysql_fetch_lengths() | Obtiene la longitud del contenido de cada campo en el conjunto de resultados. | 3 |
| mysql_fetch_object() | Obtiene una fila del conjunto de resultados como un objeto. | 3 |
| mysql_fetch_row() | Obtiene una fila del conjunto de resultados como un array de números. | 3 |
| mysql_field_flags() | Obtiene el marcador asociado con el campo especificado del resultado. | 3 |
| mysql_field_len() | Devuelve la longitud del campo especificado. | 3 |
| mysql_field_name() | Obtener el nombre del campo especificado en el resultado. | 3 |
| mysql_field_seek() | Establecer el puntero del resultado en el desplazamiento de campo especificado. | 3 |
| mysql_field_table() | Obtener el nombre de la tabla donde se encuentra el campo especificado. | 3 |
| mysql_field_type() | Obtener el tipo de campo especificado en el conjunto de resultados. | 3 |
| mysql_free_result() | Liberar la memoria del resultado. | 3 |
| mysql_get_client_info() | Obtener información del cliente MySQL. | 4 |
| mysql_get_host_info() | Obtener información del anfitrión MySQL. | 4 |
| mysql_get_proto_info() | Obtener información del protocolo MySQL. | 4 |
| mysql_get_server_info() | Obtener información del servidor MySQL. | 4 |
| mysql_info() | Obtener la información de la última consulta. | 4 |
| mysql_insert_id() | Obtener el ID generado por la operación INSERT anterior. | 3 |
| mysql_list_dbs() | Listar todas las bases de datos en el servidor MySQL. | 3 |
| mysql_list_fields() |
No se recomienda. Listar los campos en los resultados MySQL. Utilice mysql_query() en su lugar. |
3 |
| mysql_list_processes() | Listar los procesos MySQL. | 4 |
| mysql_list_tables() |
No se recomienda. Listar las tablas en la base de datos MySQL. Utilice mysql_query() en su lugar. |
3 |
| mysql_num_fields() | Obtener el número de campos en el conjunto de resultados. | 3 |
| mysql_num_rows() | Obtener el número de filas en el conjunto de resultados. | 3 |
| mysql_pconnect() | Abrir una conexión persistente a un servidor MySQL. | 3 |
| mysql_ping() | Ping una conexión de servidor, si no hay conexión, vuelva a conectarse. | 4 |
| mysql_query() | Enviar una consulta MySQL. | 3 |
| mysql_real_escape_string() | Escapar caracteres especiales en las cadenas utilizadas en las sentencias SQL. | 4 |
| mysql_result() | Obtener los datos de los resultados. | 3 |
| mysql_select_db() | Seleccione la base de datos MySQL. | 3 |
| mysql_stat() | Obtener el estado del sistema actual. | 4 |
| mysql_tablename() | No se recomienda. Obtener el nombre de la tabla. Utilice mysql_query() en su lugar. | 3 |
| mysql_thread_id() | Devuelve el ID de la hilera actual. | 4 |
| mysql_unbuffered_query() | Enviar una consulta SQL a MySQL (sin obtener / cachear los resultados). | 4 |
Constantes MySQL PHP
En versiones posteriores a PHP 4.3.0, se permite especificar más marcas de cliente en las funciones mysql_connect() y mysql_pconnect():
PHP:Indica la versión más antigua de PHP que admite esta constante.
| Constantes | Descripción | PHP |
|---|---|---|
| MYSQL_CLIENT_COMPRESS | Uso de protocolo de comunicación comprimido. | 4.3 |
| MYSQL_CLIENT_IGNORE_SPACE | Permite dejar espacios en blanco después del nombre de la función. | 4.3 |
| MYSQL_CLIENT_INTERACTIVE | Tiempo de inactividad de interacción permitido antes de cerrar la conexión. | 4.3 |
| MYSQL_CLIENT_SSL | Uso de cifrado SSL (disponible solo en versiones de 4+ de la biblioteca de cliente MySQL). | 4.3 |
La función mysql_fetch_array() utiliza una constante para representar el tipo de array devuelto:
| Constantes | Descripción | PHP |
|---|---|---|
| MYSQL_ASSOC | Las columnas de datos devueltos utilizan nombres de campo como nombres de índice de arrays. | |
| MYSQL_BOTH | Las columnas de datos devueltos utilizan nombres de campo y números de índice como nombres de índice de arrays. | |
| MYSQL_NUM |
Las columnas de datos devueltos utilizan índices numéricos como nombres de índice de arrays. Los índices de índice comienzan en 0, lo que representa el primer campo de los resultados devueltos. |
- Página anterior PHP Math
- Página siguiente PHP MySQLi
