Los Apache Handlers indican al servidor web Apache cómo debe procesar determinados tipos o extensiones de archivo. En lugar de entregar todos los archivos como contenido estático, Apache puede enviar algunos a un manejador específico para que realice una acción antes de responder al navegador.
Es una función avanzada. La mayoría de los sitios actuales no necesita crear handlers personalizados, porque el servidor y las aplicaciones ya incluyen las asociaciones necesarias. Una configuración incorrecta puede provocar errores, hacer que un archivo se ejecute de una manera no prevista o exponer información sensible.
Qué hace un handler
Cuando Apache recibe una solicitud, analiza la configuración aplicable al archivo y al directorio. El handler define qué componente se encargará de la respuesta. El manejador predeterminado entrega contenido estático; otros pueden procesar scripts CGI, Server Side Includes, mapas de imagen o tipos especiales habilitados por el administrador.
La extensión por sí sola no ejecuta nada. Es la asociación entre esa extensión y un handler disponible en el servidor la que cambia el tratamiento. Por eso copiar una configuración de otro hosting no garantiza que funcione: el módulo o manejador mencionado puede no existir o estar deshabilitado.
Ejemplos habituales
cPanel documenta varios handlers incluidos por Apache. Entre ellos se encuentran:
default-handler, que utiliza el tratamiento predeterminado para contenido estático.cgi-script, asociado a scripts CGI cuando el servidor permite esa función.server-parsed, utilizado para archivos procesados mediante Server Side Includes.type-map, destinado a archivos de negociación de contenido.
Extensiones como .cgi, .pl o .shtml aparecen en configuraciones históricas, pero su disponibilidad depende del servidor. No agregues estas asociaciones si una aplicación o el soporte técnico no lo requiere expresamente.
Diferencia entre un handler y un tipo MIME
Un tipo MIME informa al navegador qué clase de contenido recibe, por ejemplo una imagen, un documento o una hoja de estilos. Un handler, en cambio, le indica al servidor cómo procesar el archivo antes de enviarlo.
Confundir ambos conceptos puede llevar a configuraciones ineficaces o inseguras. Si solamente necesitás que el navegador reconozca una extensión, revisá la herramienta MIME Types. Si necesitás que Apache procese el archivo mediante un componente existente, entonces corresponde evaluar un handler.
Cómo agregar un Apache Handler en cPanel
Si el proveedor habilitó la función, cPanel muestra Apache Handlers dentro de Advanced o Avanzado. Para crear una asociación:
- Confirmá con la documentación de la aplicación el nombre exacto del handler y la extensión requerida.
- Ingresá a Apache Handlers.
- Escribí el nombre del manejador existente en el campo Handler.
- Ingresá la extensión sin agregar archivos ni datos innecesarios.
- Hacé clic en Add y probá solamente el recurso afectado.
La tabla de handlers definidos por el usuario permite eliminar una asociación creada desde la cuenta. cPanel no permite borrar las extensiones que Apache administra automáticamente. Si la herramienta no aparece, el proveedor puede haberla desactivado mediante Feature Manager.
Alcance de la configuración
Las asociaciones creadas por una cuenta suelen reflejarse en reglas de configuración aplicables al sitio. Dependiendo del directorio y de la herencia de Apache, el cambio puede afectar también subdirectorios. Antes de modificarlo, guardá una copia de la configuración actual y anotá qué extensión se agregó.
No hagas pruebas sobre un sitio en producción sin un plan de reversión. Una extensión aparentemente inofensiva puede existir en archivos cargados por usuarios o en recursos que antes se servían como texto. Convertirla en ejecutable cambia el modelo de seguridad del sitio.
Apache Handlers no es el selector de versión de PHP
Muchos tutoriales antiguos proponen agregar handlers de PHP en .htaccess para cambiar de versión. Esa práctica no es adecuada para una cuenta cPanel moderna. La versión de PHP por dominio normalmente se administra con MultiPHP Manager o con la herramienta que haya habilitado el proveedor.
Para cambiarla de forma segura, seguí la guía sobre cómo elegir o cambiar la versión de PHP en cPanel. Si necesitás comprobar el resultado, consultá la versión de PHP y los módulos instalados.
El concepto de PHP handler también existe a nivel del servidor, pero se refiere al modo en que Apache se comunica con PHP. Esa elección pertenece al administrador del servidor y se gestiona desde WHM o mediante herramientas de EasyApache 4. No debe confundirse con la interfaz Apache Handlers disponible para una cuenta.
Riesgos de una asociación incorrecta
- Ejecución no deseada: archivos que antes eran estáticos pueden pasar a interpretarse como programas.
- Exposición de código: un handler ausente o mal configurado puede hacer que el servidor entregue el contenido en lugar de procesarlo.
- Error 500: Apache puede rechazar una directiva, una extensión o un manejador no disponible.
- Descargas inesperadas: el navegador puede recibir el archivo con un tratamiento incorrecto.
- Impacto heredado: una regla aplicada en un directorio superior puede modificar varios sitios o subdirectorios.
Qué hacer si el cambio genera un error
- Eliminá el handler definido por el usuario desde la misma interfaz, si todavía podés acceder.
- Restaurá la copia de la configuración previa.
- Revisá el registro de errores del sitio para identificar la directiva rechazada.
- Confirmá que el handler existe y está habilitado en el servidor.
- Consultá al proveedor si el error continúa o si el cambio involucraba PHP.
No intentes resolver un error 500 agregando más handlers al azar. Primero aislá el cambio que lo produjo. Si la causa se encuentra en una regla del archivo de configuración, la guía sobre uso de directivas en .htaccess aporta contexto sobre alcance, compatibilidad y respaldo.
Cuándo conviene modificarlo
Un handler personalizado tiene sentido cuando una aplicación mantenida necesita asociar una extensión adicional a un manejador que el servidor ya ofrece, y la documentación especifica exactamente la configuración. También puede utilizarse en un entorno controlado para compatibilidad con un formato heredado.
No conviene modificarlo para acelerar un sitio, cambiar la versión de PHP, habilitar una extensión de PHP, corregir permisos o ejecutar un archivo desconocido. Cada uno de esos objetivos requiere una herramienta diferente.
Lista de comprobación
- ¿La aplicación menciona el handler y la extensión exactos?
- ¿El proveedor confirmó que el manejador está disponible?
- ¿La extensión no se utiliza para archivos que suben los visitantes?
- ¿Existe un respaldo y una forma rápida de revertir el cambio?
- ¿La prueba se realizará en un entorno o recurso controlado?
La documentación oficial de Apache Handlers en cPanel mantiene vigente esta interfaz y enumera los manejadores incorporados. Aun así, su presencia depende de las funciones habilitadas por cada proveedor. Si no existe una necesidad técnica concreta, lo más seguro es conservar la configuración predeterminada.
