Pour démarrer

+ + Pour dÃ©marrer + +

Si vous ne connaissez rien au serveur HTTP Apache, ou mÃªme au +fonctionnement d'un site web, vous vous demandez probablement par oÃ¹ +commencer ou quelles questions poser. Ce document vous permettra de +parcourir les bases du sujet.

+ +

+Clients, serveurs et URLs + +

+Les adresses des pages web sur la Toile se prÃ©sentent sous forme d'URLs +- Uniform Resource Locators - qui comportent un protocole (par + exemple http), un nom de serveur (par exemple + www.apache.org), un chemin (par exemple + /docs/current/getting-started.html), et parfois + une chaÃ®ne de paramÃ¨tres (par exemple ?arg=value) + permettant de transmettre des informations supplÃ©mentaires au serveur. +

+ +

Tout client (par exemple un navigateur web) se connecte Ã un serveur +(par exemple votre serveur HTTP Apache) en suivant un protocole spÃ©cifique, et +effectue une requÃªte pour une ressource en spÃ©cifiant +son chemin.

+ +

Un chemin peut reprÃ©senter plusieurs types de ressources sur le +serveur. Ce peut Ãªtre un fichier (comme +getting-started.html), un gestionnaire (comme server-status), ou toute sorte de +programme (comme index.php). Nous dÃ©crirons tout ceci plus +en dÃ©tails ci-dessous dans la section Contenu d'un +site web.

+ +

+Le serveur envoie alors une rÃ©ponse comportant un code +d'Ã©tat, et le plus souvent un corps de rÃ©ponse. Le code d'Ã©tat indique si +la requÃªte a Ã©tÃ© traitÃ©e avec succÃ¨s, ou dans la nÃ©gative quel type +d'erreur a Ã©tÃ© rencontrÃ©. Le client est alors sensÃ© savoir quoi faire de +la rÃ©ponse. Vous pouvez vous familiariser avec les diffÃ©rents codes +d'Ã©tat en consultant le Wiki du +serveur HTTP Apache.

+ +

Les dÃ©tails de la transaction, ainsi que les erreurs rencontrÃ©es, +sont enregistrÃ©s dans des fichiers journaux. Tout ceci est dÃ©crit en +dÃ©tails ci-dessous dans la section DÃ©bogage et fichiers +journaux.

+ +

+Noms d'hÃ´te et DNS + +

Pour se connecter Ã un serveur, le client doit tout d'abord traduire +le nom du serveur en une adresse IP, cette derniÃ¨re permettant de localiser +le serveur sur Internet. Ainsi, pour que votre serveur web soit +accessible, son nom doit Ãªtre enregistrÃ© dans le DNS.

+ +

Si vous ne savez pas comment utiliser cette fonctionnalitÃ©, vous +devez contacter votre administrateur rÃ©seau ou votre fournisseur d'accÃ¨s +Ã Internet qui le feront pour vous.

+ +

Plusieurs noms d'hÃ´te peuvent pointer vers la mÃªme adresse IP, et +plusieurs adresses IP peuvent Ãªtre attachÃ©es au mÃªme serveur physique. +Vous pouvez ainsi hÃ©berger plusieurs serveurs web sur le mÃªme serveur +physique grÃ¢ce au mÃ©canisme des serveurs virtuels.

+ +

Pour tester un serveur non encore accessible sur Internet, vous +pouvez renseigner son nom d'hÃ´te dans votre fichier hosts afin +d'effectuer une rÃ©solution de nom locale. Par exemple, pour tester le +serveur web www.example.com depuis le serveur physique qui +l'hÃ©berge, vous pouvez ajouter la ligne suivante au fichier hosts de ce +dernier :

+ + +127.0.0.1 www.example.com + + +

En gÃ©nÃ©ral, le fichier hosts se trouve dans le rÃ©pertoire +/etc sur les systÃ¨mes de style Unix, ou +C:\Windows\system32\drivers\etc sous Windows.

+ +

Vous trouverez plus de dÃ©tails Ã propos du fichier hosts Ã Wikipedia.org/wiki/Hosts_(file), +et Ã propos du DNS Ã Wikipedia.org/wiki/Domain_Name_System.

+ +

+Fichiers de configuration et directives + +

La configuration du serveur HTTP Apache s'effectue via de simples +fichiers textes. Ces fichiers peuvent se trouver dans de nombreux +endroits diffÃ©rents en fonction du mode d'installation du serveur. Vous +trouverez les positions courantes de ces fichiers dans le wiki httpd. +Si vous installez httpd depuis le code source, le rÃ©pertoire par dÃ©faut +des fichiers de configuration est /usr/local/apache2/conf. +Le nom du fichier de configuration par dÃ©faut est en gÃ©nÃ©ral +httpd.conf, mais peut aussi varier en fonction des +distributions tierces du serveur.

+ +

On trouve souvent la configuration divisÃ©e en plusieurs +fichiers afin d'en faciliter la gestion. Ces fichiers sont inclus dans +le fichier de configuration principal via la directive Include. Les noms ou positions de ces fichiers +ne sont pas figÃ©s et peuvent varier considÃ©rablement d'une distribution +Ã l'autre. N'hÃ©sitez pas Ã les arranger et subdiviser selon +vos goÃ»ts et besoins, quitte Ã en modifier +l'organisation par dÃ©faut.

+ +

La configuration du serveur s'effectue via des directives de configuration que l'on +insÃ¨re dans les fichiers de configuration. Une directive se compose d'un +mot-clÃ© suivi d'un ou plusieurs arguments qui dÃ©finissent sa valeur.

+ +

La rÃ©ponse Ã la question "OÃ¹ dois-je placer cette directive +?" dÃ©pend en gÃ©nÃ©ral du niveau auquel cette directive doit Ãªtre +prise en compte. S'il s'agit du niveau global, elle doit Ãªtre placÃ©e +dans le fichier de configuration principal, et en dehors de toute +section Directory, Location, VirtualHost, ou de toute autre section. Si +par exemple elle ne doit s'appliquer qu'Ã un rÃ©pertoire particulier, +elle doit Ãªtre placÃ©e dans la section Directory qui fait rÃ©fÃ©rence Ã ce rÃ©pertoire. +Voir la documentation sur les Sections de +configuration pour plus de dÃ©tails.

+ +

En complÃ©ment des fichiers de configuration principaux, certaines +directives peuvent Ãªtre insÃ©rÃ©es dans des fichiers +.htaccess que l'on place directement dans le rÃ©pertoire +concernÃ©. Les fichiers .htaccess sont essentiellement +destinÃ©s aux personnes qui n'ont pas accÃ¨s aux fichiers de configuration +du serveur. Vous trouverez plus de dÃ©tails Ã propos des fichiers +.htaccess dans ce howto .htaccess.

+ +

+Contenu du site web + +

Si le contenu du site web peut se prÃ©senter sous de nombreuses +formes, il peut en gÃ©nÃ©ral Ãªtre scindÃ© en deux formes principales : les +contenus statiques et les contenus dynamiques.

+ +

Les contenus statiques sont par exemple les fichiers HTML, les +images, les fichiers CSS et tout autre fichier rÃ©sidant sur le systÃ¨me +de fichiers. La directive DocumentRoot permet de dÃ©finir la position +dans l'arborescence du site oÃ¹ vous devez placer ces fichiers. On peut +dÃ©finir cette directive au niveau global, ainsi que dans chaque +serveur virtuel. Consultez vos fichiers de configuration +pour vÃ©rifier la maniÃ¨re dont cette directive est dÃ©finie pour votre +serveur.

+ +

En gÃ©nÃ©ral, et si aucun nom de fichier n'est spÃ©cifiÃ© dans la +requÃªte, c'est une page de nom index.html qui sera +renvoyÃ©e. Par exemple, si la directive DocumentRoot est +dÃ©finie Ã /var/www/html, et si une requÃªte est effectuÃ©e +pour l'adresse http://www.example.com/work/, c'est le +fichier /var/www/html/work/index.html qui sera envoyÃ© au +client par le serveur.

+ +

Un contenu dynamique est un contenu qui est gÃ©nÃ©rÃ© au moment du +traitement de la requÃªte, et qui peut diffÃ©rer d'une requÃªte Ã l'autre. +Ces contenus dynamiques peuvent Ãªtre gÃ©nÃ©rÃ©s de nombreuses maniÃ¨res par +l'intermÃ©diaire de gestionnaires de contenu +ou "handlers". Il est Ã©galement possible de crÃ©er des programmes CGI pour gÃ©nÃ©rer le contenu de +votre site.

+ +

Enfin, on peut utiliser des modules tiers comme mod_php pour Ã©crire +du code permettant d'effectuer de nombreuses choses. De nombreuses +applications tierces Ã©crites Ã partir de divers langages ou outils sont +disponibles en tÃ©lÃ©chargement et peuvent Ãªtre installÃ©es sur votre +serveur HTTP Apache. Le support de ces applications dÃ©passe le sujet de +ce document, et nous vous invitons Ã consulter le site de leur Ã©diteur +pour accÃ©der Ã leur documentation.

+ +

En tant qu'administrateur d'un serveur HTTP Apache, vos sources +d'informations principales sont les fichiers journaux, et en particulier +le journal des erreurs. Toute tentative de rÃ©solution d'un problÃ¨me sans +consulter le journal des erreurs revient Ã conduire les yeux fermÃ©s.

+ +

La position dans le systÃ¨me de fichiers du journal des erreurs est +spÃ©cifiÃ©e par la directive ErrorLog +qui peut Ãªtre dÃ©finie au niveau global, ainsi que dans chaque serveur +virtuel. Chaque entrÃ©e du journal des erreurs vous informe sur la nature +des problÃ¨mes et le moment de leur survenue. En outre, elle vous indique +souvent comment rÃ©soudre le problÃ¨me. Chaque message d'erreur contient +un code d'erreur que vous pouvez utiliser pour effectuer une recherche +en ligne afin d'obtenir une description plus dÃ©taillÃ©e de la maniÃ¨re de +rÃ©soudre le problÃ¨me. Vous pouvez aussi configurer votre journal des +erreurs de maniÃ¨re Ã ce qu'il enregistre un identifiant d'erreur que +vous pourrez ensuite utiliser pour effectuer une corrÃ©lation avec le +journal des accÃ¨s afin de dÃ©terminer quelle requÃªte est Ã l'origine de +l'erreur.

+ +

+Que dois-je savoir d'autre ? +

Ce document ne couvre que les notions de base. Nous espÃ©rons qu'il +vous permettra de mettre le pied Ã l'Ã©trier, mais il y a encore de +nombreuses choses que vous devez savoir. Voici une liste non exhaustive +des documents que nous vous recommandons de consulter :

+ +

Clients, serveurs et URLs

Noms d'hôte et DNS

Fichiers de configuration et directives

Contenu du site web

Fichiers journaux et résolution des problèmes

Que dois-je savoir d'autre ?

Commentaires