PHP mysqli_close() Function

Neste artigo, vamos nos concentrar na função mysqli_close() do PHP, usada para encerrar uma conexão MySQLi. Forneceremos uma visão geral da função, como ela funciona e exemplos de uso.

Introdução à função mysqli_close()

A função mysqli_close() é uma função procedural integrada do PHP utilizada para encerrar uma conexão MySQLi. Na API MySQLi orientada a objetos, a operação equivalente é realizada chamando o método close() em um objeto mysqli. Ambas as abordagens são úteis quando você precisa liberar recursos ou quando terminou de usar uma conexão específica.

Como usar a função mysqli_close()

Usar a operação de encerramento de conexão MySQLi é muito simples. Basta chamar a função ou o método adequado em um objeto de conexão válido. Veja um exemplo usando a API orientada a objetos:

Como usar a função mysqli_close()

<?php
$mysqli = new mysqli("localhost", "username", "password", "database");
if ($mysqli->connect_errno) {
    echo "Failed to connect to MySQL: " . $mysqli->connect_error;
    exit();
}

// execute queries using the connection

if (!$mysqli->close()) {
    echo "Connection close failed.";
}
?>

Neste exemplo, criamos um novo objeto MySQLi e conectamos a um banco de dados MySQL com nome de usuário e senha. Em seguida, podemos executar consultas usando a conexão. Por fim, encerramos a conexão chamando o método close() do objeto MySQLi. Note que o método retorna true em caso de sucesso e false em caso de falha. Se não for encerrada explicitamente, o PHP limpa automaticamente a conexão quando o script termina.

Para a API procedural, a sintaxe equivalente é mysqli_close($link);, onde $link é o recurso de conexão retornado por mysqli_connect(). Veja um exemplo procedural:

Uso procedural de mysqli_close()

<?php
$link = mysqli_connect("localhost", "username", "password", "database");
if (!$link) {
    die("Connection failed: " . mysqli_connect_error());
}

// execute queries using the connection

if (!mysqli_close($link)) {
    echo "Connection close failed.";
}
?>

Uso avançado

A operação de encerramento MySQLi também pode ser usada em cenários mais avançados. Por exemplo, você pode usá-la para liberar recursos utilizados por uma conexão específica ou para encerrar múltiplas conexões de uma vez. Veja um exemplo:

Uso avançado de PHP mysqli_close()

<?php
$mysqli1 = new mysqli("localhost", "user1", "pass1", "database1");
$mysqli2 = new mysqli("localhost", "user2", "pass2", "database2");

// execute queries using the connections

$mysqli1->close();
$mysqli2->close();
?>

Neste exemplo, criamos dois novos objetos MySQLi e conectamos a dois bancos de dados MySQL diferentes com nomes de usuário e senhas distintos. Em seguida, podemos executar consultas usando ambas as conexões. Por fim, encerramos as duas conexões chamando o método close() de cada objeto MySQLi.

Nota sobre conexões persistentes: mysqli_close() não pode encerrar conexões persistentes. As conexões persistentes permanecem abertas após o término do script e são gerenciadas pelo pool de conexões.

Conclusão

Em conclusão, a função mysqli_close() (e seu equivalente OOP, o método close()) é uma ferramenta poderosa para encerrar conexões MySQLi no PHP. Ao entender como usar a função e seus cenários de uso avançado, você pode aproveitar esse recurso para liberar recursos e gerenciar conexões de banco de dados de forma eficiente em seus scripts PHP.

Prática