Error de memoria PHP: cómo solucionar el límite de 128 MB

«Allowed Memory Size of 134217728 Bytes Exhausted» – el freno de emergencia de tu aplicación PHP

¿Alguna vez has visto este mensaje en medio de la noche, cuando tu sitio web se cae inesperadamente y en los logs aparece un texto blanco sobre fondo negro? Si es así, no estás solo. Miles de desarrolladores en Stack Overflow se han preguntado por qué su script PHP, aparentemente inofensivo, de repente consume todos los 128 megabytes de RAM y falla con un error fatal.

Vamos a entender qué significa realmente este error, por qué ocurre y, lo más importante, cómo solucionarlo de una vez por todas. No solo aumentaremos el límite de memoria, sino que aprenderemos a escribir código que no devore recursos como un estudiante hambriento en la cafetería.

¿Qué significa «134217728 Bytes Exhausted»?

El número 134,217,728 son 128 megabytes. Esa es la cantidad de memoria que PHP permite usar a tu script por defecto. Cuando el script intenta asignar más – ¡pum! – y obtienes un Fatal Error. Es un mecanismo de protección que evita que un solo script derribe todo el servidor.

Pero aquí está el truco: 128 MB es muy poco para las aplicaciones modernas. Procesar un archivo XML grande, generar un informe desde la base de datos, trabajar con imágenes o librerías pesadas – todo esto puede superar fácilmente el límite.

¿Por qué ocurre esto? Tres causas principales

\n
• Bucles voraces y recursión – cuando cargas todos los datos en memoria de una vez, en lugar de procesarlos por partes.
\n
• Fugas de memoria – variables estáticas, arrays globales y el uso incorrecto de static pueden acumular datos.
\n
• Librerías y extensiones pesadas – por ejemplo, procesamiento de imágenes con GD o trabajo con PDF.
\n

Cómo solucionar el error: de lo simple a lo complejo

Método 1: Aumentar el límite de memoria (solución rápida)

La forma más obvia es simplemente darle más memoria a PHP. Pero recuerda: esto no es una cura, es un analgésico. Si tu código está mal escrito, consumirá 512 MB y hasta 1 GB.

Hay tres formas de aumentar el límite:

1. En el archivo php.ini (cambio permanente):

memory_limit = 256M

2. En .htaccess (si está disponible):

php_value memory_limit 256M

3. En el propio script (solo para la ejecución actual):

ini_set('memory_limit', '256M');

Pero te advertimos: si estás en un hosting compartido, el proveedor puede no permitir aumentar el límite por encima de cierto umbral. E incluso si lo permite, no abuses.

Método 2: Optimización del código – la solución real

En lugar de darle más memoria al script, enseñémosle a usar lo que tiene de forma inteligente.

Usa unset() para liberar memoria

PHP no es C++, pero la gestión manual de memoria sigue funcionando. Cuando una variable grande ya no es necesaria, elimínala:

$data = file_get_contents('archivo_gigante.csv');\n// procesamos los datos\nprocessData($data);\n// liberamos memoria\nunset($data);\n

Procesa los datos por partes

En lugar de cargar 100,000 filas de la base de datos en memoria, usa cursores o límites:

// MAL: cargamos todo en memoria\n$users = $db->query("SELECT * FROM users")->fetchAll();\n\n// BIEN: procesamos fila por fila\n$stmt = $db->query("SELECT * FROM users");\nwhile ($row = $stmt->fetch()) {\n    processUser($row);\n    // PHP libera memoria después de cada iteración\n}\n

Usa generadores (yield)

Los generadores son magia para trabajar con grandes conjuntos de datos. No almacenan todos los valores en memoria:

function getLargeData() {\n    for ($i = 0; $i < 1000000; $i++) {\n        yield $i;\n    }\n}\n\nforeach (getLargeData() as $value) {\n    // procesamos un elemento a la vez\n    echo $value . "\\n";\n}