3. Annotation d’une page (écrire dans un fichier et inclure)

Usage:

• Créer une page php avec un contenu (ici: forum.php)
• Inclure le module "annotate.php" (voir page suivante!)
• Créer un fichier *.php.comment (ici: forum.php.comment)
• dans lequel le module va écrire les commentaires
• sur certains systèmes ce fichier doit être "writable" par le serveur
  (uid=nobody ou apache, ou autoriser tout le monde à écrire (mode 666).
• à Tecfa le répertoire/fichier doit être à vous (configuration php = safe_mode)

Le fichier exemple

• http://tecfa.unige.ch/guides/php/examples/forum/forum.php
• http://tecfa.unige.ch/guides/php/examples/forum/forum.text

Voici un texte ..... Il peut être aussi long ou compliqué que vous voulez !

<hr><? require("annotate.php"); ?>

Le module d’annotation

• Renommez ce fichier *.text en fichier *.php pour l’inclusion dans votre page.
• http://tecfa.unige.ch/guides/php/examples/forum/annotate.text

$secret = "zap";

$mode = "a";

// the module can’t be called by itself

if ( basename($_SERVER[’PHP_SELF’]) == "annotate.php") {

  exit;

}

// if the password is correct we overwrite

if ($password == $secret) { 

  $mode = "w";

  $fp = fopen (basename($PHP_SELF) . ".comment", $mode);

  fwrite ($fp, $message);

  fclose ($fp);

}

// if there is a message we append it to a file called file.comment

// make sure that file.comment is writeable by the server)

if ($message) {

  /* uncomment the next two lines to strip out html from input */

  /* $name = strip_tags($name); */

  /* $message = strip_tags($message); */

  $name = StripSlashes($name);

  $message = StripSlashes($message);

  $message = ereg_replace("\n\n", "\n<P>", $message);

  $date = date("l, F j Y, H:i");

  $message = "<B>$name </B> -- $date<P> $message <BR><HR>";

  $fp = fopen (basename($PHP_SELF) . ".comment", $mode);

  fwrite ($fp, $message);

  fclose ($fp);

  @readfile(basename(($PHP_SELF . ".comment")));

}

A retenir:

• Pour écrire dans un fichier, il faut:
• que le fichier appartienne à vous, ou encore à “nobody” (le serveur tourne sous ce nom) ou alternativement qu’il soit “world writeable” (chmod 666)
• fopen(<nom du fichier>, mode)
  ouvre un fichier et retourne un “handle”
• fwrite (<handle>, “string”)
  permet d’écrire (il existe d’autres fonctions pour cela)
• fclose (<handle>)
  ferme le fichier (IMPORTANT)
• @readfile (<file>)
  insére le contenu d’un fichier

Attention

• Ce type de script peut présenter des graves problèmes de sécurité !
• Dès que vous mettez un champs libre (input text ou textarea) à disposition, il y aura des centaines des messages de spam. Il faut donc limiter l’accès au scripts.
• En aucun cas il faut utiliser la fonction include() au lieu de readfile()