Documentación offline PHP master

mysql_query

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

mysql_query

Enviar una consulta MySQL

[!WARNING] Esta extensión estaba obsoleta en PHP 5.5.0, y fue eliminada en PHP 7.0.0. En su lugar, se puede utilizar la extensión MySQLi o la extensión PDO_MySQL. Ver también MySQL: elegir una API de la guía. Alternativas a esta función:

mysqli_query

PDO::query

Descripción#

mysql_query(string $query, [resource $link_identifier]): mixed
```php

`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](#function.mysql-real-escape-string).

`link_identifier`  
La conexión MySQL. Si no se especifica, se utilizará la última conexión abierta con la función `mysql_connect`. Si no se encuentra una conexión de este tipo, la función intentará abrir una conexión, como si la función `mysql_connect` hubiera sido llamada sin argumento. Si no se encuentra o establece una conexión, se generará una alerta de nivel `E_WARNING`.

## 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 `true` en 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, o `mysql_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.

## Ejemplos

Consulta inválida

La siguiente consulta no es sintácticamente válida, por lo que `mysql_query` fallará y retornará `false`.
Consulta válida

La siguiente consulta es válida, por lo que `mysql_query` retornará un `resource`.

```php

Véase también#

mysql_connect

mysql_error

mysql_real_escape_string

mysql_result

mysql_fetch_assoc

mysql_unbuffered_query