mysqli::query

mysqli_query

(PHP 5)

mysqli::query -- mysqli_query — Realiza una consulta a la base de datos

Descripción

Estilo orientado a objetos

mixed mysqli::query ( string $query [, int $resultmode = MYSQLI_STORE_RESULT ] )

Estilo por procedimientos

mixed mysqli_query ( mysqli $link , string $query [, int $resultmode = MYSQLI_STORE_RESULT ] )

Realiza una consulta dada por query a la base de datos.

Para consultas que no sean DML (distintas de INSERT, UPDATE o DELETE), esta funcion es similar a invocar a mysqli_real_query() seguida de mysqli_use_result() o mysqli_store_result().

Nota:

En el caso de pasarle una sentencia a mysqli_query() que sea mayor del valor de max_allowed_packet del servidor, los códigos de error retornados diferirán dependiendo de si se está usando el Controlador Nativo de MySQL (mysqlnd) o la Biblioteca Cliente de MySQL (libmysqlclient). El comportamiento es el siguiente:

  • mysqlnd en Linux retorna un código de error 1153. Este mensaje de error significa que "se tiene un paquete mayor que max_allowed_packet bytes".

  • mysqlnd en Windows retorna un código de error 2006. Este mensaje de error significa que "el servidor no está disponible".

  • libmysqlclient en toda las plataformas retorna el código de error 2006. Este mensaje de error significa que "el servidor no está disponible".

Parámetros

link

Sólo estilo por procediminetos: Un identificador de enlace devuelto por mysqli_connect() o mysqli_init()

query

La string de la consulta.

Los datos dentro de la consulta deberían estar adecuadamente escapados.

resultmode

La constante MYSQLI_USE_RESULT o MYSQLI_STORE_RESULT dependiendo del compotamiento deseado. Por defecto, se usa la constante MYSQLI_STORE_RESULT.

Si se usa MYSQLI_USE_RESULT todas la llamadas posteriores retornarán con un error Commands out of sync a menos que se llame a mysqli_free_result()

Con MYSQLI_ASYNC (disponible con mysqlnd), es posible hacer consulta de manera asíncrona. mysqli_poll() se utiliza para obtener los resultados de dichas consultas.

Valores devueltos

Retorna FALSE en caso de error. Si una consulta del tipo SELECT, SHOW, DESCRIBE o EXPLAIN es exitosa, mysqli_query() retornará un objeto mysqli_result. Para otras consultas exitosas de mysqli_query() retornará TRUE.

Historial de cambios

Versión Descripción
5.3.0 Se agregó la posibilidad de realizar consultas asíncronas.

Ejemplos

Ejemplo #1 Ejemplo de mysqli::query()

Estilo orientado a objetos

<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* comprobar la conexión */
if ($mysqli->connect_errno) {
    printf("Falló la conexión: %s\n", $mysqli->connect_error);
    exit();
}

/* Crear una tabla que no devuelve un conjunto de resultados */
if ($mysqli->query("CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
    printf("Se creó con éxtio la tabla myCity.\n");
}

/* Consultas de selección que devuelven un conjunto de resultados */
if ($resultado = $mysqli->query("SELECT Name FROM City LIMIT 10")) {
    printf("La selección devolvió %d filas.\n", $resultado->num_rows);

    /* liberar el conjunto de resultados */
    $resultado->close();
}

/* Si se ha de recuperar una gran cantidad de datos se emplea MYSQLI_USE_RESULT */
if ($resultado = $mysqli->query("SELECT * FROM City", MYSQLI_USE_RESULT)) {

    /* Observar que no se puede ejecutar ninguna función que interactue con el
       servidor hasta que el conjunto de resultados se haya cerrado. Todas las llamadas devolverán un
       error 'out of sync' */
    if (!$mysqli->query("SET @a:='esto no funcionará'")) {
        printf("Error: %s\n", $mysqli->error);
    }
    $resultado->close();
}

$mysqli->close();
?>

Estilo por procedimientos

<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* comprobar la conexión */
if (mysqli_connect_errno()) {
    printf("Falló la conexión: %s\n", mysqli_connect_error());
    exit();
}

/* Crear una tabla que no devuelve un conjunto de resultados */
if (mysqli_query($link, "CREATE TEMPORARY TABLE myCity LIKE City") === TRUE) {
    printf("Se creó con éxtio la tabla myCity.\n");
}

/* Consultas de selección que devuelven un conjunto de resultados */
if ($resultado = mysqli_query($link, "SELECT Name FROM City LIMIT 10")) {
    printf("La selección devolvió %d filas.\n", mysqli_num_rows($resultado));

    /* liberar el conjunto de resultados */
    mysqli_free_result($resultado);
}

/* If we have to retrieve large amount of data we use MYSQLI_USE_RESULT */
if ($resultado = mysqli_query($link, "SELECT * FROM City", MYSQLI_USE_RESULT)) {

    /* Observar que no se puede ejecutar ninguna función que interactue con el
       servidor hasta que el conjunto de resultados se haya cerrado. Todas las llamadas devolverán un
       error 'out of sync' */
    if (!mysqli_query($link, "SET @a:='esto no funcionará'")) {
        printf("Error: %s\n", mysqli_error($link));
    }
    mysqli_free_result($resultado);
}

mysqli_close($link);
?>

El resultado de los ejemplos serían:

Se creó con éxtio la tabla myCity.
La selección devolvió 10 filas.
Error: Commands out of sync;  You can't run this command now

Ver también