Gestionnaire d'événements

Certaines actions dans Plesk, comme :

  • Créer un compte client
  • Supprimer une adresse IP
  • Mettre à jour des paramètres d'hébergement d'un domaine, etc.

sont considérées comme des événements par Plesk. Pour chaque événement, vous pouvez créer un ou plusieurs gestionnaires d'événements qui exécutent une commande prédéfinie à chaque fois que l'événement se produit.

Les gestionnaires d'événements sont pratiques notamment si vous voulez exécuter une action ou un ensemble d'actions à chaque fois qu'un événement spécifique se produit. Par exemple, vous pouvez créer un gestionnaire d'événements qui se déclenche à chaque création d'abonnement, et à ce moment crée automatiquement une boîte mail, envoie une requête à un service externe, etc.

Dans cette section :

Ajouter de nouveaux gestionnaires d'événements

Transmission des paramètres d'événements

Ajouter et supprimer des gestionnaires d'événements

Paramètres des évènements transmis par les gestionnaires d'évènements

 

Ajouter de nouveaux gestionnaires d'événements

  1. Allez dans Outils & Paramètres > Gestionnaire d'événements.
  2. Cliquez sur Ajouter un gestionnaire d'événements.
  3. Dans la liste des événements, sélectionnez l'événement qui déclenchera le gestionnaire.
  4. Dans les priorités, définissez la priorité pour l'exécution du gestionnaire, soit en la sélectionnant dans la liste, soit en saisissant un numéro personnalisé dans le champ. La priorité joue un rôle important si vous affectez plusieurs gestionnaires à un seul événement. Dans ce cas, les gestionnaires se déclenchent en fonction de leur priorité, par ordre décroissant (l'événement avec la priorité la plus élevée se déclenche en premier, puis la priorité la plus élevée suivante, etc.).
  5. Dans la liste des utilisateurs, sélectionnez le compte d'utilisateur système au nom duquel la tâche sera exécutée.

    Remarque pour les utilisateurs de Linux : l'administrateur du serveur peut créer les gestionnaires d'événements qui seront exécutés sur le serveur au nom de l'utilisateur root. Si vous souhaitez restreindre l'utilisation du compte root, créez un fichier vide nommé root.event_handler.lock dans /usr/local/psa/var/.

  6. Saisissez le chemin d'accès vers le script shell ou vers un fichier .bat qui contient les commandes à exécuter lorsqu'un gestionnaire d'événements se déclenche dans le champ "Commande" (par exemple, /usr/local/psa/bin/script.sh ou C:\Windows\Temp\script.bat).
  7. Cliquez sur OK.
 

Transmission des paramètres d'événements

Lorsqu'un gestionnaire d'événements se déclenche, il transmet certaines données ("Paramètres d'événements") associées à l'événement (les données transmises dépendent du gestionnaire d'événements concerné). Par exemple, le gestionnaire d'événements "Domaine créé" transmet les données suivantes :

  • Le nom du domaine créé.
  • Le GUID du domaine créé.
  • Le GUID du compte client qui appartient au domaine créé.

Chaque paramètre est transmis en tant que variable d'environnement que vous pouvez utiliser dans votre script shell ou fichier .bat comme suit :

Plesk pour Linux

Utilisez la variable ${ENVIRONMENT_VARIABLE_NAME} (par exemple, "${NEW_DOMAIN_NAME}") dans votre script shell. Lorsque le gestionnaire d'événements se déclenche, la variable est remplacée par la valeur correspondant à l'événement.

Plesk pour Windows

Utilisez la variable %N (par exemple, "%1") dans votre fichier .bat et ajoutez-y le nom de la variable d'environnement à la position correspondante à la fin de la commande dans les paramètres du gestionnaire d'événements. Dans cet exemple :

2

la variable "%1" sera remplacée par la valeur de la variable d'environnement "NEW_DOMAIN_NAME" et "%2" sera remplacée par la valeur de "NEW_DOMAIN_GUID". Si vous utilisez "%3" dans le fichier .bat , la variable ne sera pas remplacée, car deux noms de variables d'environnement seulement ont été indiqués après la commande.

Vous pouvez voir la liste complète des paramètres d'événements et des noms de variables d'environnement pour chaque gestionnaire d'événements ici.

Pour référence, voici deux exemples de scripts pour l'événement "Compte client créé" :

  • (Plesk pour Linux) test-handler.sh

    #!/bin/bash

    echo "--------------" >> /tmp/event_gestionnaire.log

    /bin/date >> /tmp/event_handler.log # information on the event date and time

    /usr/bin/id >> /tmp/event_handler.log # information on the user, on behalf of which the script was executed (to ensure control)

    echo "customer created" >> /tmp/event_handler.log # information on the created customer account

    echo "name: ${NEW_CONTACT_NAME}" >> /tmp/event_handler.log # customer's name

    echo "login: ${NEW_LOGIN_NAME}" >> /tmp/event_handler.log # customer's username in Plesk

    echo "--------------" >> /tmp/event_gestionnaire.log

  • (Plesk pour Windows) test-handler.bat

    echo "--------------" >> c:\windows\temp\event_gestionnaire.log

    rem information on the event date and time

    date /T >> c:\windows\temp\event_gestionnaire.log

    rem information on the created customer account

    echo "customer created" >> c:\windows\temp\event_gestionnaire.log

    rem customer's name

    echo "name: %1" >> c:\windows\temp\event_handler.log

    rem customer's username in Plesk

    echo "login: %2" >> c:\windows\temp\event_handler.log

    echo "--------------" >> c:\windows\temp\event_gestionnaire.log

Si vous vous connectez à Plesk et créez un compte ayant comme nom "Jean Dupont" et login "jean_dupont", le gestionnaire d'événements se déclenchera et les enregistrements suivants seront ajoutés au fichier event_handler.log :

  • (Plesk pour Linux)

    Fri Mar 16 15:57:25 NOVT 2007

    uid=0(root) gid=0(root) groups=0(root)

    customer created

    name: Jean Dupont

    login: jean_dupont

  • (Plesk pour Windows)

    Mon March 15 21:46:34 NOVT 2010

    client créé

    name: Jean Dupont

    login: jean_dupont

 

Ajouter et supprimer des gestionnaires d'événements

Pour voir la liste des gestionnaires d'événements actifs actuellement, allez dans Outils & Paramètres > Gestionnaire d'événements. Sur cette page, vous pouvez aussi modifier et supprimer des gestionnaires d'événements :

  • Pour modifier un gestionnaire d'événements, cliquez sur son nom, saisissez vos modifications et cliquez sur OK.
  • Pour supprimer un gestionnaire d'événements, cochez la case correspondante et cliquez sur Supprimer.
 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.