Uso e exemplo da função PHP mysqli_free_result()

PHP MySQLi Referência

A função mysqli_free_result() libera a memória dos resultados.

Definição e uso

Um objeto de resultados PHP (classe mysqli_result) representa os resultados retornados por uma consulta SELECT ou DESCRIBE ou EXPLAIN.

mysqli_free_result()A função aceita um objeto de resultados como parâmetro e libera a memória associada.

Sintaxe

mysqli_free_result($result);

Parâmetro

Retorno

Esta função não retorna nenhum valor.

Versão do PHP

Esta função foi introduzida na versão do PHP5introduzido e pode ser usado em todas as versões mais recentes.

Exemplo online

A seguir, um exemplo demonstramysqli_free_result()Uso da função (estilo orientado a processo), obter linhas do conjunto de resultados e liberar a memória do conjunto de resultados:

<?php
　　　$con = mysqli_connect("localhost", "root", "password", "mydb");
　　　mysqli_query($con, "CREATE TABLE myplayers(ID INT, Primeiro_Nome VARCHAR(255), Sobrenome VARCHAR(255), Local_de_Nascimento VARCHAR(255), País VARCHAR(255))");
　　　print("Criar tabela.....\n");
　　　mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
　　　mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'Cape Town', 'South Africa')");
　　　mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Sri Lanka')");
　　　print("Inserindo registros.....\n");
　　　//Conteúdo da tabela de pesquisa
　　　$res = mysqli_query($con, "SELECT　*　FROM myplayers");
　　　print("Contents of the resultset...\n");
　　　//Conteúdo do conjunto de resultados
　　　while ($row = mysqli_fetch_row($res)) {
　　　　　　print("ID: ".$row[0]."\n");
　　　　　　print("Nome: ".$row[1]."\n");
　　　　　　print("Sobrenome: ".$row[2]."\n");
　　　　　　print("Local_de_Nascimento: ".$row[3]."\n");
　　　　　　print("País: ".$row[4]."\n");
　　　}
　　　//Fim da sentença, liberação da memória
　　　mysqli_free_result($res);
　　　//Fechar conexão
　　　mysqli_close($con);
?>

Resultado da saída

Criar tabela.....
Inserindo registros.....
Contents of the resultset...
ID:　1
First_Name:　Sikhar
Sobrenome: Dhawan
Local_de_Nascimento: Delhi
País: India
ID:　2
Nome: Jonathan
Sobrenome: Trott
Local_de_Nascimento: Cape Town
País: South Africa
ID:　3
Nome: Kumara
Sobrenome: Sangakkara
Local_de_Nascimento: Matale
País: Sri Lanka

Se você tentar obter o conteúdo dos resultados após liberá-los-

$con = mysqli_connect("localhost", "root", "password", "mydb");
mysqli_query($con, "CREATE TABLE myplayers(ID INT, Primeiro_Nome VARCHAR(255), Sobrenome VARCHAR(255), Local_de_Nascimento VARCHAR(255), País VARCHAR(255))");
print("Criar tabela.....\n");
mysqli_query($con, "INSERT INTO myplayers values(1, 'Sikhar', 'Dhawan', 'Delhi', 'India')");
mysqli_query($con, "INSERT INTO myplayers values(2, 'Jonathan', 'Trott', 'Cape Town', 'South Africa')");
mysqli_query($con, "INSERT INTO myplayers values(3, 'Kumara', 'Sangakkara', 'Matale', 'Sri Lanka')");
print("Inserindo registros.....\n");
//Conteúdo da tabela de pesquisa
$res = mysqli_query($con, "SELECT　*　FROM myplayers");
//Terminar instrução
mysqli_free_result($res);
print("Conteúdo do conjunto de resultados...\n");
//Conteúdo do conjunto de resultados
while ($row = mysqli_fetch_row($res)) {
　　　print("ID: ".$row[0]."\n");
　　　print("Nome: ".$row[1]."\n");
　　　print("Sobrenome: ".$row[2]."\n");
　　　print("Local_de_Nascimento: ".$row[3]."\n");
　　　print("País: ".$row[4]."\n");
}
//Fechar conexão
mysqli_close($con);

Você receberá o seguinte erro

Criar tabela.....
Inserindo registros.....
Conteúdo do conjunto de resultados...
PHP Aviso: mysqli_fetch_row(): Não foi possível buscar mysqli_result em E:\PHPExamples\procedure_oriented.php na linha　19
Aviso: mysqli_fetch_row(): Não foi possível buscar mysqli_result em E:\PHPExamples\procedure_oriented.php na linha　19

Exemplo online

No estilo orientado a objetos, a sintaxe dessa função é$result-> fechar();.Aqui está um exemplo dessa função no estilo orientado a objetos;

<?php
　　　//Estabelecer conexão
　　　$con = new mysqli("localhost", "root", "password", "mydb");
　　　$con　-> query("CREATE TABLE Test(Nome VARCHAR(255), ID INT)");
　　　$con　-> query("inserir em Test valores('Raju',　25),('Rahman',　30),('Sarmista',　27);
　　　print("Criar tabela.....\n");
　　　$stmt = $con　-> preparar("SELECT　*　FROM Test WHERE Nome in(?, ?)
　　　$stmt　-> ligar_parametros("ss", $name1, $name2);
　　　$name1　= 'Raju';
　　　$name2　= 'Rahman';
　　　//Executar instrução
　　　$stmt->executar();
　　　//Resultados da busca
　　　$result = $stmt->obter_resultado();
　　　//Número de linhas
　　　$count = $result->num_rows;
　　　print("Número de linhas no resultado: ".$count);
　　　//Fechando o resultado
　　　$result->fechar();
　　　//Terminar instrução
　　　$stmt->fechar();
　　　//Fechar conexão
　　　$con->fechar();
?>

Resultado da saída

Criar tabela.....
Número de linhas no resultado:　2

PHP MySQLi Referência