Cómo cambiar el tamaño máximo de archivo subido en PHP: guía completa

¿Por qué PHP no permite subir un archivo de más de 2 MB?

¿Alguna vez ha intentado subir a un sitio web una foto de buena calidad, una presentación o un video, y PHP le respondió secamente: «The uploaded file exceeds the upload_max_filesize directive in php.ini»? ¿Le suena? Este es un problema clásico que se encuentra en uno de cada dos proyectos. En Stack Overflow, la pregunta «Change the maximum upload file size» ha acumulado decenas de miles de visitas, y no es casualidad.

En este artículo, analizaremos cómo funciona la limitación de subida de archivos en PHP, dónde se configura y cómo aumentar correctamente el límite. Aprenderá no solo sobre upload_max_filesize, sino también sobre los obstáculos que podrían echar por tierra todos sus esfuerzos.

¿Cómo limita PHP la subida de archivos?

Cuando envía un archivo a través de un formulario, PHP verifica su tamaño en varios niveles. Si al menos uno de ellos no lo permite, el archivo no se subirá. Analicemos los tres parámetros principales que debe modificar para que change the maximum upload file size funcione correctamente.

1. upload_max_filesize — límite directo por archivo

Este es el parámetro más obvio. Define el tamaño máximo de un solo archivo subido. Por defecto, PHP tiene 2M (2 megabytes). Para aumentarlo, por ejemplo, a 100 MB, debe escribir:

upload_max_filesize = 100M

2. post_max_size — tamaño total de la solicitud POST

Aquí es donde muchos caen. Incluso si ha aumentado upload_max_filesize, pero se olvidó de post_max_size, la subida igualmente no funcionará. ¿Por qué? Porque el archivo se transmite dentro de la solicitud POST, y si el tamaño total de la solicitud supera el límite, PHP simplemente la truncará.

La regla es simple: post_max_size debe ser mayor que upload_max_filesize. Generalmente se establece entre un 20 y un 30% más grande. Ejemplo:

post_max_size = 120M

3. max_execution_time — tiempo para la subida

Los archivos grandes no se suben instantáneamente. Si el archivo pesa 100 MB y el internet es lento, el script podría no completarse en el tiempo asignado. Por defecto, max_execution_time = 30 segundos. Para archivos grandes, auméntelo a 300-600 segundos:

max_execution_time = 600

4. memory_limit — memoria para el procesamiento

Algunos scripts de PHP cargan el archivo en memoria antes de procesarlo. Si memory_limit es menor que el tamaño del archivo, obtendrá un error. Se recomienda establecerlo mayor que post_max_size:

memory_limit = 256M

¿Dónde y cómo cambiar la configuración?

Ahora que sabemos qué parámetros controlan change the maximum upload file size, veamos dónde modificarlos. Tiene tres opciones principales:

Método 1: php.ini (archivo de configuración principal)

Este es el método más fiable. Busque el archivo php.ini en el servidor (normalmente está en /etc/php/ o /usr/local/etc/). Ábralo y encuentre las directivas necesarias. Si no están, agréguelas al final del archivo:

; Permitir la subida de archivos (debe estar en On)\nfile_uploads = On\n\n; Tamaño máximo de un solo archivo\nupload_max_filesize = 100M\n\n; Tamaño máximo de la solicitud POST\npost_max_size = 120M\n\n; Tiempo de ejecución del script\nmax_execution_time = 600\n\n; Límite de memoria\nmemory_limit = 256M

Después de los cambios, reinicie el servidor web:

sudo service apache2 restart   # para Apache\nsudo service nginx restart     # para Nginx

Método 2: .htaccess (solo para Apache)

Si no tiene acceso a php.ini (por ejemplo, en un hosting), puede intentarlo a través de .htaccess en la raíz del sitio:

php_value upload_max_filesize 100M\nphp_value post_max_size 120M\nphp_value max_execution_time 600\nphp_value memory_limit 256M

Importante: este método solo funciona