En este post te mostraré la manera óptima que utiliza poca memoria para servir un archivo con PHP y que el usuario lo descargue, sin importar el peso del archivo.

Podemos usar readfile para forzar la descarga de un archivo con PHP, pero si el archivo es muy grande y la memoria no es suficiente, habrá problemas como:

PHP Fatal error: Allowed memory size of 2097152 bytes exhausted (tried to allocate 2998272 bytes)

Por ello es que en este post te enseñaré cómo servir un archivo grande con PHP para su descarga, utilizando poca memoria y leyendo el archivo en fragmentos, con una alternativa a readfile.

¿Qué hace readfile?

Esta función lee el contenido del archivo en formato binario (es decir, tal y como fue escrito, sin intentar abrirlo como determinado formato) y lo imprime en la salida estándar del navegador.

Combinada con algunos encabezados permite forzar la descarga de ficheros, pero en ocasiones tiene problemas con la memoria cuando son ficheros pesados.

Servir archivo con PHP – Optimización

Para permitir la descarga de un archivo con PHP y no acabar con la memoria, podemos leer fragmentos del archivo e ir imprimiendo el contenido. Así que el código queda así:

<?php

$rutaAbsoluta = "Cuphead.zip"; // La ubicación del archivo. En mi caso está en el mismo directorio que este script
$nombreArchivo = "Cuphead.zip"; // El nombre que se le sugiere al usuario cuando guarda el archivo. Solo el nombre, NO la ruta absoluta
$tamanio = filesize($rutaAbsoluta);
$tamanioFragmento = 5 * (1024 * 1024); //5 MB
set_time_limit(300);
header('Content-Type: application/octet-stream');
header("Content-Transfer-Encoding: Binary");
header("Pragma: no-cache");
header('Content-Length: ' . $tamanio);
header(sprintf('Content-disposition: attachment; filename="%s"', $nombreArchivo));
// Servir el archivo en fragmentos, en caso de que el tamaño del mismo sea mayor que el tamaño del fragmento
if ($tamanio > $tamanioFragmento) {
    $manejador = fopen($rutaAbsoluta, 'rb');

    // Mientras no lleguemos al final del archivo...
    while (!feof($manejador)) {
        // Imprime lo que regrese fread, y fread leerá N cantidad de bytes en donde N es el tamaño del fragmento
        print(@fread($manejador, $tamanioFragmento));

        ob_flush();
        flush();
    }
    // Cerrar el archivo
    fclose($manejador);
} else {
    // Si el tamaño del archivo es menor que el del fragmento, podemos usar readfile sin problema
    readfile($rutaAbsoluta);
}

Los comentarios explican el código. Puedes cambiar el tamaño del fragmento de acuerdo a tus necesidades.

Lo importante aquí es la ruta del archivo y el nombre del archivo. La ruta es la ubicación absoluta del mismo (algo como C:\xampp\htdocs\Cuphead.zip) y el nombre es lo que se muestra en el cuadro de diálogo al usuario cuando lo va a descargar.

Como lo dije, este método soporta archivos grandes o pesados. Yo he descargado (de manera local) ficheros de hasta 3.2 GB pero recuerda que esto siempre puede variar por las condiciones de red, etcétera.

De este modo puedes usar PHP para servir archivos sin agotar la memoria, usando un método ligero.