Introducción
Uno de los problemas más frustrantes a los que nos enfrentamos los desarrolladores web al trabajar con scripts pesados, migraciones o consultas grandes en PHP es el temido mensaje Fatal error: Maximum execution time of 30 seconds exceeded. Este fallo interrumpe la ejecución del código de manera abrupta, dejando procesos a medias y afectando la experiencia del usuario.
Causas Principales del Error
El servidor web (generalmente Apache o Nginx con PHP-FPM) establece por defecto un límite de tiempo de 30 segundos para que cualquier script PHP termine de ejecutarse. Si una tarea requiere más tiempo —como procesar imágenes grandes, conectar con APIs externas lentas o realizar consultas complejas a bases de datos—, PHP detiene el proceso automáticamente por motivos de seguridad y optimización de recursos.
Método 1: Modificar el archivo php.ini
La forma más limpia y permanente de solucionar este problema en un entorno de desarrollo local o en un servidor dedicado es editando el archivo de configuración global php.ini.
- Busca y abre tu archivo
php.ini(puedes localizarlo ejecutandophp --inien tu terminal). - Busca la directiva
max_execution_time. Por defecto estará configurada en30. - Cambia el valor al tiempo necesario en segundos, por ejemplo:
max_execution_time = 300(para 5 minutos) o0para eliminar el límite por completo (no recomendado en producción). - Guarda los cambios y reinicia tu servidor web (Apache o Nginx).
Método 2: Aumentar el tiempo desde el archivo .htaccess
Si estás utilizando un servicio de hosting compartido donde no tienes acceso directo al archivo php.ini, puedes utilizar el archivo .htaccess si tu servidor corre bajo Apache.
- Accede al directorio raíz de tu proyecto mediante FTP o el explorador de archivos de tu hosting.
- Busca el archivo
.htaccess(asegúrate de mostrar los archivos ocultos). - Añade la siguiente línea al final del archivo:
php_value max_execution_time 300 - Guarda los cambios y recarga tu página web.
Método 3: Modificar el límite directamente en el código PHP
Si solo necesitas aplicar este cambio de forma puntual en un script específico (como un script de importación o una tarea CRON), puedes utilizar la función set_time_limit() al inicio de tu archivo PHP.
set_time_limit(300);
Colocar esta función al principio del script le indicará a PHP que amplíe el tiempo límite exclusivamente para esa ejecución, evitando tocar configuraciones globales del servidor.