Serveur Apache HTTP Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Programmes

# apachectl - L'interface de contrôle du serveur HTTP Apache

`apachectl` est un frontal pour le serveur HTTP Apache. Il a été conçu pour aider l'administrateur à contrôler le fonctionnement du démon Apache `httpd`.

Le script `apachectl` possède deux modes de fonctionnement. Il peut fonctionner en tant que simple frontal de la commande `httpd` et ne fait alors que définir toute variable d'environnement nécessaire, puis invoque `httpd` en lui passant tout argument de ligne de commande souhaité. Il peut aussi fonctionner en tant que script d'initialisation SysV n'acceptant qu'un seul argument tel que `start`, `restart` et `stop`, et traduisant ce dernier en signaux appropriés pour le démon `httpd`.

Si votre installation d'Apache utilise des chemins non standards, vous devrez éditer le script `apachectl` afin de définir les chemins appropriés pour le binaire `httpd`. Vous pouvez aussi spécifier tout argument de ligne de commande de `httpd` nécessaire. Voir les commentaires dans le script pour plus de détails.

Le script `apachectl` renvoie une valeur égale à 0 en cas de succès, et une valeur supérieure à 0 en cas de problème. Voir les commentaires dans le script pour plus de détails.

### Voir aussi

- Démarrer Apache
- Arrêter Apache
- Fichiers de configuration
- Documentation spécifique aux plates-formes
- `httpd`

## Résumé

En mode frontal (pass-through), `apachectl` peut spécifier tous les arguments qu'accepte le binaire `httpd`.

`apachectl [ argument-httpd ]`

En mode script d'initialisation SysV, `apachectl` n'accepte qu'un seul des arguments définis ci-dessous.

`apachectl commande`

## Options

Seules les options du style initialisation SysV sont décrites ici. Les autres arguments sont décrits dans la page de manuel de `httpd`.

`start`
  Démarre le démon Apache `httpd`. Renvoie une erreur s'il est déjà en cours d'exécution. Équivalent à `apachectl -k start`.
`stop`
  Arrête le démon Apache `httpd`. Équivalent à `apachectl -k stop`.
`restart`
  Redémarre le démon Apache `httpd`. Si le démon n'est pas en cours d'exécution, il est démarré. Cette option vérifie automatiquement les fichiers de configuration (de la même manière que l'option `configtest` ) avant de lancer le redémarrage, afin d'être sûr que le fonctionnement du démon ne sera pas compromis. Equivalent à `apachectl -k restart`.
`fullstatus`
  Affiche le rapport d'état complet du module `mod_status`. Pour que ceci fonctionne, `mod_status` doit être activé dans votre serveur et vous devez disposer d'un navigateur en mode texte tel que `lynx` sur votre système. L'URL utilisée pour accéder au rapport d'état peut être modifiée en définissant la variable `STATUSURL` dans le script.
`status`
  Affiche un rapport d'état succinct. Similaire à l'option `fullstatus`, excepté que la liste des requêtes en cours de traitement est omise.
`graceful`
  Redémarre le démon Apache `httpd` en douceur. Si le démon n'est pas en cours d'exécution, il est démarré. À la différence d'un redémarrage normal, les connexions en cours ne sont pas fermées. Comme effet de bord, les anciens fichiers journaux ne seront pas fermés immédiatement. Cela signifie que si l'on utilise un script de rotation des journaux, un délai suffisant sera nécessaire afin d'être sûr que les fichiers journaux seront bien fermés avant leur traitement par le script de rotation. Cette option vérifie automatiquement les fichiers de configuration (de la même manière que l'option `configtest` ) avant de lancer le redémarrage, afin d'être sûr que le fonctionnement du démon ne sera pas compromis. Équivalent à `apachectl -k graceful`.
`graceful-stop`
  Arrête le démon Apache `httpd` en douceur. À la différence d'un arrêt normal, les connexions en cours ne sont pas fermées. Comme effet de bord, les anciens fichiers journaux ne seront pas fermés immédiatement. Équivalent à `apachectl -k graceful-stop`.
`configtest`
  Effectue une vérification de la syntaxe du fichier de configuration. Avec cette option, le script parcourt le fichier de configuration et renvoie soit `Syntax Ok`, soit des informations détaillées à propos des éventuelles erreurs de syntaxe. Equivalent à `apachectl -t`.

Les options suivantes étaient disponibles dans les anciennes versions et ont été supprimées.

`startssl`
  Pour démarrer `httpd` avec le support SSL, vous devez éditer votre fichier de configuration et y inclure les directives appropriées, puis utiliser la commande de démarrage normale `apachectl start`.