Astuces de rédaction

PHP code

• Utiliser du code PHP personnalisé

  Du code PHP personnalisé peut être inséré dans certains types de contenu du site, tels les contribution et les blocs. Même si l'insertion du code PHP à l'intérieur d'un contenu ou d'un bloc est une fonctionnalité puissante et flexible pour les utilisateurs de confiance expérimentés en PHP, c'est une fonctionnalité qui présente un risque de danger significatif mis entre les mains d'utilisateurs malveillants. Même une petite erreur lors de l'inclusion du code PHP peut accidentellement compromettre votre site.

  Si vous n'êtes pas familier de PHP, SQL ou Drupal, évitez d'utiliser du code PHP personnalisé dans les contributions. L'expérimentation avec PHP pourrait corrompre votre base de données, rendre votre site inopérant ou compromettre de façon significative sa sécurité.

  Notes :

  • Souvenez-vous de vérifier par deux fois, ligne par ligne, les erreurs de syntax et de logique avant d'enregistrer.
  • Les déclarations doivent être convenablement terminées par un point-virgule.
  • Les variables globales utilisées au sein de votre code PHP perdurent après l'exécution de votre script.
  • register_globals est désactivé. Si vous devez utiliser des formulaires, comprenez et utilisez les fonctions de l'API de formulaire Drupal.
  • Utiliser une déclaration print ou return dans votre code pour afficher du contenu.
  • Développez et testez votre code PHP en utilisant un script et une base de données de test avant de déployer sur un site en production.
  • Envisagez plutôt d'inclure votre code PHP personnalisé au sein d'un module spécifique au site ou dans le fichier template.php plutôt que de l'embarquer directement dans une contribution ou un bloc.
  • Soyez avisé que la capacité à inclure du code PHP à l'intérieur du contenu est fournie par le module PHP Filter. Si ce module est désactivé ou supprimé, alors les blocs et contributions comportant du code PHP pourraient afficher, au lieu de l'exécuter, ce code PHP.

  Un exemple de base : Créer un bloc "Bienvenue" pour saluer les visiteurs avec un message simple.

  • Ajoute un bloc personnalisé, appelé "Bienvenue", à votre site. Avec son format de texte paramétré sur "Code PHP" (ou un autre format acceptant les insertions de PHP), ajoutez ce qui suit dans le corps du bloc :

    print t('Bienvenue, cher visiteur ! Merci de votre passage.');
    

  • Pour afficher le nom d'un utilisateur inscrit, utilisez ceci à la place :

    global $user;
    if ($user->uid) {
      print t('Bienvenue @name ! Merci de votre visite.', array('@name' => format_username($user)));
    }
    else {
      print t('Bienvenue, cher visiteur ! Merci de votre visite.');
    }
    

  Drupal.org offre quelques exemples de codes PHP, ou vous pouvez créer le vôtre avec un peu d'expérience en PHP et une connaissance du système Drupal.