Handlers Apache

Apache associe par défaut une extension de fichier à un comportement (text/html pour .html, application/x-httpd-php pour .php, etc.). L'interface Handlers Apache permet d'ajouter vos propres associations — utile pour exécuter un script CGI avec une extension non standard, parser des SSI dans des fichiers .html ou forcer un module spécifique.

Accéder à l'interface

1. Connectez-vous à cPanel.
2. Section Avancé → cliquez sur Handlers Apache.
3. L'écran affiche deux blocs : Créer un handler et Handlers définis par l'utilisateur.

Handlers intégrés (lecture seule)

cPanel affiche en bas de page la liste des handlers déjà connus du serveur. Vous ne pouvez pas les modifier mais vous pouvez les surcharger en créant un handler du même nom de plus haute priorité.

Créer un handler personnalisé

1. Dans le champ Handler, saisissez le nom du gestionnaire (ex. : cgi-script).
2. Dans Extension(s), saisissez la ou les extensions séparées par un espace, sans le point initial — par exemple : pl cgi.
3. Cliquez sur Ajouter. Le couple apparaît dans le tableau Handlers définis par l'utilisateur.

Exemples concrets

Activer SSI sur les fichiers .html

Par défaut, les SSI ne sont parsées que dans les fichiers .shtml. Pour activer le parsing dans .html, créez un handler server-parsed associé à l'extension html. Attention : cela ralentit légèrement le rendu de toutes vos pages HTML.

Forcer une version PHP par extension

Pour forcer PHP 8.2 sur les fichiers .legacy par exemple, ajoutez le handler application/x-httpd-ea-php82 avec l'extension legacy.

Supprimer un handler

1. Dans la liste Handlers définis par l'utilisateur, repérez la ligne à supprimer.
2. Cliquez sur l'icône de poubelle / le lien Supprimer.
3. Confirmez l'action — l'effet est immédiat.

Dépannage

Erreur 500 après ajout d'un handler

• Vérifiez les permissions du script (0755) et celles du dossier (0755).
• Consultez la page Erreurs (cPanel → Métriques → Erreurs) pour le message complet.
• Vérifiez que l'interpréteur (Perl, Python…) est bien installé sur le serveur.

Le handler n'est pas pris en compte

Si une directive .htaccess définit déjà un handler pour la même extension, elle prévaut. Supprimez la ligne SetHandler du .htaccess concerné.