Primero expliquemos la diferencia entre ambos:
$stmt->free_result()
libera la memoria relacionada con un conjunto de resultados, mientras que $stmt->close()
libera la memoria relacionada con una consulta preparada. Posteriormente, al llamar $stmt->close()
se cancelará cualquier resultado que quede.
Básicamente, llamar a $stmt->close()
proporcionará el mismo efecto que invocar a $stmt->free_result()
ya que también cancela el conjunto de resultados. Pero al invocar $stmt->free_result()
no se borrará la memoria utilizada por la declaración preparada, en cuyo caso debe usar $stmt->close()
.
En cuanto a cuál usar, puede haber situaciones en las que pretendas usar la declaración preparada que has inicializado, pero ya no necesites el conjunto de resultados que tienes actualmente. En tal caso, llamarías a $stmt->close()
cuando hayas terminado con la declaración preparada (puedes pasar valores diferentes a una misma consulta preparada... esa es una de sus ventajas) y, en su lugar, llamarías a $stmt->free_result()
antes de ejecutar otra instrucción.
Respondiendo concretamente a tu pregunta
En el ejemplo de código que pones, si observas en el Manual de PHP, el código viene escrito así:
$consulta = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 150,5";
/*Antes de hacer cualquier cosa con $stmt se verifica que no sea falso*/
/*$stmt sería false si hay algún error al llamar el método prepare*/
/*Todo lo que se hace con $stmt se hace dentro de este bloque*/
if ($stmt = $mysqli->prepare($consulta)) {
/* ejecutar la sentencia */
$stmt->execute();
/* vincular las variables de resultados */
$stmt->bind_result($nombre, $código);
/* obtener los valores */
while ($stmt->fetch()) {
printf ("%s (%s)\n", $nombre, $código);
}
/* cerrar la sentencia */
$stmt->close();
}
/*Si hay un error preparando la consulta y aquí escribes $stmt->close()*/
/*Tendrás el error: Exception: Call to a member function close() on boolean*/
/*Porque $stmt sería false, no la representación de una consulta preparada*/
/* cerrar la conexión a la BD*/
$mysqli->close();
Este código lo que hace es liberar el $stmt
al salir del bucle. Al cerrar $stmt
no es necesario usar free.
Tú pones además un ejemplo de código usando if
... pero con fetch
los datos deben ser leídos dentro de un bucle, ya que al leerlos dentro de un simple if
no podrás obtener todos los resultados, en caso de que haya más de una fila.
En resumen: Si usas close
al terminar de usar tu consulta preparada y tus datos, sería suficiente. Si quieres usar free_result
antes de close
, úsalo. Hay debates sobre si es vital o no su uso. Según esta respuesta el uso de free_result
no aporta nada. Puedes hacer una prueba con memory_get_usage()
en varios escenarios y determinar si realmente aporta algo. Según la misma respuesta, su uso no es vital.