Este documento contiene información para usar la herramienta Manejadores de Apache de cPanel, que indica al servidor web cómo procesar los archivos según su extensión.
Un manejador (handler) le dice al servidor web qué hacer con un tipo de archivo. Por ejemplo, puede procesar los .html como páginas con inclusiones del lado del servidor (SSI) o ejecutar los .pl como scripts CGI. cPanel ya trae manejadores para los formatos habituales; esta herramienta sirve para agregar los tuyos.
Acceso: ingresá a cPanel desde el portal de clientes → Iniciar sesión en cPanel, o en https://tudominio.com/cpanel. Después abrí Avanzado → Manejadores de Apache.
¿Para qué sirve?
- Usar SSI en archivos
.html, con el manejadorserver-parsed. - Ejecutar scripts Perl o CGI con extensiones como
.plo.cgi, con el manejadorcgi-script.
Agregar un manejador
- En Manejador, escribí el nombre del manejador, por ejemplo
server-parsed. - En Extensiones, escribí una o varias extensiones separadas por espacios, por ejemplo
.html .htm. - Hacé clic en Agregar.
El manejador aparece en Manejadores definidos por el usuario. Para quitarlo, hacé clic en Eliminar junto a él. En la misma pantalla, Manejadores definidos por el sistema muestra los que ya vienen configurados en el servidor.
Importante: no uses esta herramienta para PHP. La versión de PHP se cambia desde el selector de PHP de cPanel. Si agregás un manejador de PHP a mano, el sitio puede dejar de funcionar o el navegador puede descargar los archivos .php en lugar de ejecutarlos.
Esta herramienta no sirve para indicar qué tipo de archivo le envía el servidor al navegador, por ejemplo para que un formato se descargue o se muestre. Para eso se usa la herramienta Tipos MIME.
Problemas frecuentes
- Error 500 después de agregar un manejador: el nombre del manejador no es válido. Eliminalo y revisá cómo está escrito.
- El navegador descarga los archivos en vez de mostrarlos: eliminá el manejador que agregaste para esa extensión.
- Un script CGI da error 500: revisá que tenga permisos
755y que esté guardado con saltos de línea de Linux.
Si tenés dudas sobre qué manejador usar, abrí un ticket desde el portal de clientes o consultá por el chat online del sitio.

