APACHE_GET_VERSION |
Demande la version Apache |
|---|---|
| PHP 4.3.2+ | |
Syntaxe
| function apache_get_version() |
Retour
| Valeur | Description |
|---|---|
| Chaine de caractères | Ces valeurs contiennent la chaîne de caractères de la version d'Apache. |
| FALSE | Cette valeur permet d'indiquer qu'une erreur est survenue lors de la lecture de la version d'Apache. |
Description
Cette fonction permet de demander la version d'Apache.
Remarques
- Retourne la version d'Apache : La fonction apache_get_version retourne une chaîne de caractères contenant la version du serveur Apache actuellement utilisé. Cette information inclut souvent des détails sur la version exacte (exemple : Apache/2.4.54) ainsi que des informations supplémentaires comme les modules compilés ou les configurations spécifiques.
- Utilisation limitée à Apache : Cette fonction ne fonctionne que si PHP est utilisé avec le serveur Web Apache en tant que module (mod_php). Si PHP est exécuté via CGI, FPM ou d'autres serveurs Web (comme Nginx ou IIS), la fonction retournera une erreur ou sera indisponible.
- Diagnostique utile pour les développeurs : apache_get_version est pratique pour vérifier dynamiquement la version d'Apache afin d'ajuster le comportement des scripts PHP. Par exemple, des fonctionnalités ou modules spécifiques peuvent dépendre d'une version minimale d'Apache.
- Risque lié aux chaînes de caractères vides : Si la fonction est appelée dans un environnement où elle n'est pas supportée, elle peut retourner false ou une chaîne de caractères vide. Il est donc recommandé de vérifier son existence avec function_exists('apache_get_version') et de gérer les cas où elle n'est pas disponible.
- Informations complémentaires incluses : En plus de la version d'Apache, la chaîne de caractères retournée par apache_get_version peut inclure d'autres détails, comme le type de compilation, les modules inclus ou des informations spécifiques à une distribution, ce qui peut être utile pour le diagnostic.
- Non recommandé pour la production : Bien que cette fonction soit utile en développement, afficher ou manipuler directement la version d'Apache dans une application de production peut poser des risques de sécurité. Cela peut fournir des informations sensibles aux attaquants sur le serveur utilisé.
- Alternative via les entêtes HTTP : La version d'Apache est parfois incluse dans les entêtes HTTP d'une réponse serveur (par exemple, via l'entête Server). Cependant, ces informations peuvent être masquées ou modifiées par des configurations comme ServerTokens Prod pour des raisons de sécurité.
- Comparable à phpinfo() : La fonction apache_get_version peut être vue comme une méthode rapide et ciblée pour obtenir la version d'Apache, par rapport à l'exécution de phpinfo(), fournissant un rapport complet. Elle est donc plus efficace si seuls ces détails spécifiques sont nécessaires.
Exemple
Voici un exemple montrant l'utilisation de cette fonction :
- <?php
- echo "La version d'Apache est : " . apache_get_version();
- ?>
on obtiendra un résultat ressemblant à ceci :
La version d'Apache est : Apache/2.2.14 (Win32) PHP/5.2.2Voir également
Serveur ou service logiciel - Apache - Introduction
Index des extensions de fichier - Format de fichier : httpd.conf
Index des extensions de fichier - Format de fichier : .htaccess
Index des extensions de fichier - Format de fichier : .htpasswd
Dernière mise à jour : Dimanche, le 22 mars 2015