Stockage du fichier FITS dans une table MySQL Nous utiliserons des types de données spéciaux, qui sont les BLOBS (binary large objects).

Transcription

1 Stockage des fichiers FITS du téléscope MISOLFA dans une base de donnée MySQL avec PHP Auteur : Erwan Simon CNRS UMR 6202 O.C.A Département Cassiopée Le 24/05/2009, Le but de ce document est de donner les principes de manipulations de fichiers images FITS provenant du logiciel Misolfa V1.x pour Windows (auteur : Erwan SIMON) dans une table MySQL à partir de scripts écrits en language PHP. Les exemples développés dans ce documents ont été testés grâce au logiciel EasyPHP 3,0 (serveur Apache, MySQL 5, PHP 5.2). Dans ce document, on verra comment enregistrer ces fichiers dans une table, comment récupérer un fichier donné depuis une page Web et comment en regénérer un fichier FITS (aspect client). D'autre part, un exemple de page Web servant d'interface homme-machine sera présentée au sein de laquelle on retrouvera les fonctionnalités précédemment décrites (création de la table, ajout de fichier, recherche d'image, affichage...) Stockage du fichier FITS dans une table MySQL Nous utiliserons des types de données spéciaux, qui sont les BLOBS (binary large objects). Création de la table : Nous allons créer la table «fichiers» où seront stockés les fichiers FITS; il faut exécuter la commande SQL de création de table suivante : CREATE TABLE `fichiers` ( Ìd` int(11) NOT NULL auto_increment, `Nom` varchar(50) default NULL, `Type_seq` varchar(50) default NULL, `Long_onde` varchar(50) default NULL, `Donnees` longblob, PRIMARY KEY (Ìd`), UNIQUE KEY ìd` (Ìd`) ); Cette requête peut être directement testée en local dans un premier temps sous l'interface de phpmyadmin (après avoir créé la base de donnée images et l'avoir sélectionnée) ou par le biais d'un script PHP (cf «creation_table.php»), puis la tester sur un serveur dédié où il faudra installer PHP et MySQL (serveur Unix de préférence). La table ainsi créée comporte un identifiant unique Id, un nom pour le fichier stocké, les données binaires du fichier ainsi que le type de séquence (courant d'obscurité (dark), plage lumineuse unifome (PLU), limbes solaire, test...) et la longueur d'onde du filtre utilisé lors de l'observation (ex : 535nm...). Le type blob des données indique que ces données ont stockées sans modification; longblob indique aussi la taille maximum des données qui peuvent être stockées (< octets). Typiquement les images FITS générées pour l'observation solaire avec l'instrument MISOLFA font 604Ko.

2 Fichier «creation_table.php» <html> <head> <title>création de la table de fichiers (FITS) </title> </head> <body> // Déclaration des paramètres de connexion et autres variables $host = "localhost"; $user = "root"; $bdd = "images"; $passwd = "mysql"; //declaration des define define("table","fichiers"); // Connexion au serveur mysql_connect($host, $user,$passwd) or die("erreur de connexion au serveur"); mysql_select_db($bdd) or die("erreur de connexion a la base de donnees"); $req = "CREATE TABLE ".TABLE." ( Ìd` int(11) NOT NULL auto_increment, `Nom` varchar(50) default NULL, `Type_seq` varchar(50) default NULL, `Long_onde` varchar(50) default NULL, `Donnees` longblob, PRIMARY KEY (Ìd`), UNIQUE KEY ìd` (Ìd`) );"; //echo $req; mysql_query($req) or die("pas moyen de créer la table fichiers!!!"); </body> </html>

3 Récupération du fichier depuis le serveur d'acquisition d'images: Par le biais d'une page HTML (DEPOT_FICHIER.HTML) affichée sur dans le navigateur Web, on va demander à l'utilisateur de localiser le fichier image qui se trouve sur le réseau. Pour valider l'exemple, j'ai partagé le répertoire c:\misolfa\test_input_files qui contient des fichiers FITS. Le fichier sera dans un premier temps récupéré sur le PC client à l'endroit où a été installé le programme EasyPHP 3.0 sous le répertoire www (donc localement). Voici l'aspect qu'aura la page de téléchargement du fichier : et lorsque l'opération s'est bien déroulée, on obtient la fenêtre suivante :

4 Fichier «DEPOT_FICHIER.HTML» <html> <head> <title>astrométrie solaire - Téléchargement de fichier FITS</title> </head> <body> <h1>astrométrie solaire - Téléchargement de fichier FITS</h1> <form enctype="multipart/form-data" action="telechargement.php" method=post> <input type="hidden" name="max_file_size" value=" "> Chargement de ce fichier: <input name="userfile" type="file"> <input type="submit" value="telecharger"> </form> </body> </html>

5 Fichier «TELECHARGEMENT.PHP» <html> <head> <title>chargement de fichier...</title> </head> <body> <h1>chargement de fichier...</h1> //Vérification si une erreur a eue lieu lors du chargment if ($_FILES['userfile']['error'] > 0) echo 'Problème: '; switch ($_FILES['userfile']['error']) case 1: echo 'Dépassement de la taille maximale de telechargement'; break; case 2: echo 'Dépassement de la taille maximale autorisée'; break; case 3: echo 'chargement partiel'; case 4: exit; break; echo 'Fichier non téléchargé'; break; case 6: echo 'Pas de répertoire temporaire spécifié'; break; case 7: echo 'Ecriture sur disque impossible'; break; // Le fichier possède t-il le bon type MIME? if ($_FILES['userfile']['type']!= 'text/plain') echo "Problème: le fichier n'est pas du texte brut"; exit; // recupération du fichier sous la racine locale de EasyPHP 3.0 pour faciliter l'enregistrement $upfile = '/./Program Files/EasyPHP 3.0/www/'.$_FILES['userfile']['name']; if (is_uploaded_file($_files['userfile']['tmp_name'])) if (!move_uploaded_file($_files['userfile']['tmp_name'], $upfile)) echo 'Problème: impossible de déplacer le fichier vers sa destination'; exit; else echo 'Problème: attaque possible par le fichier '; echo $_FILES['userfile']['name']; exit; echo 'Chargement OK<br><br>'; // reformatage du contenu du fichier $fp = fopen($upfile, 'r');

6 $contents = fread ($fp, filesize ($upfile)); fclose ($fp); $contents = strip_tags($contents); $fp = fopen($upfile, 'w'); fwrite($fp, $contents); fclose($fp); </body> </html>

7 Récupération des paramètres du fichier: Par le biais d'une nouvelle page HTML affichée sur dans le navigateur Web, on va ensuite demander à l'utilisateur de renseigner les champs d'informations nécessaires au stockage des fichiers FITS dans la base «images» et qui seront utiles pour leur tri. C'est ce que fait le code HTML «NOUVELLE_IMAGE.html» fourni en annexe et dont voici l'aspect dans le navigateur Internet Explorer : On retrouve ici le type de séquence à partir de laquelle a été réalisée cette image FITS, la longueur d'onde du filtre utilisé ainsi que le nom du fichier tel qu'il a été chargé localement sur le serveur Apache lors de l'opération précédente et un identificateur unique de fichier (nombre entier). Le stockage de l'image dans la table «fichiers» précédemment créée lors de l'opération de création de table est effectuée dans le script insertion_image.php dont le code est fourni ci après. Si l'opération s'est déroulée correctement, on obtient la page suivante :

8 Fichier «NOUVELLE_IMAGE.HTML» <html> <head> <title>astrométrie solaire- Ajout d'une nouvelle image FITS à la base images</title> </head> <body> <h1>astrométrie solaire- Ajout d'une nouvelle image FITS à la base images</h1> <form action="insertion_image.php" method="post" enctype="multipart/form-data"/> <table border="0"> <tr> <td>type de séquence</td> <td><input type="text" name="type_seq" maxlength="13" size="13"><br /></td> </tr> <tr> <td>longueur d'onde</td> <td> <input type="text" name="long_onde" maxlength="30" size="30"><br /></td> </tr> <tr> <td>nom du fichier</td> <td> <input type="text" name="titre" maxlength="60" size="30"><br></td> </tr> <tr> <td colspan="2"><input type="submit" value="enregistrer"></td> </tr> </table> </form> </body> </html>

9 Fichier «INSERTION_IMAGE.PHP» <html> <head> <title>base de données images : enregistrement</title> </head> <body> <h1>base de données images : enregistrement</h1> // déclaration des variables $type_seq=$_post['type_seq']; $long_onde=$_post['long_onde']; $titre=$_post['titre']; $id=$_post['id']; if (!$type_seq!$long_onde!$titre!$id ) echo "Vous n'avez pas rempli tous les paramètres.<br />"."Veuillez recommencer."; exit; //préparation des données if(!$r=@fopen($titre,"r")) die ("Erreur d'accès au fichier \n"); $size = filesize($titre); $donnees = addslashes(fread($r, $size)); if (!get_magic_quotes_gpc()) $type_seq = addslashes($type_seq); $long_onde = addslashes($long_onde); $titre = addslashes($titre); $id = $db = new mysqli('localhost', 'root', 'mysql', 'images'); if (mysqli_connect_errno()) echo "Erreur: Impossible de se connecter à la base de données. Veuillez réessayer ultérieurement."; exit; $query = "insert into fichiers values ('".$id."','".$titre."', '".$type_seq."', '".$long_onde."', '".$donnees."')"; $result = $db->query($query); if ($result) echo $db->affected_rows." image inseree dans la database."; else echo "Une erreur est survenue.l'image n'a pas ete inseree."; $db->close(); </body> </html>

10 Sur le principe précédent, on créera une page Web de recherche d'une image FITS dans la base de donnée puis la recréation d'un fichier FITS à partir des données binaires incluses dans la base (à partir des BLOBS)...

11 Création d'un site Web regroupant les différents services: Afin de réunir les différentes requêtes d'accès à la base de donnée images, j'ai regroupé dans une même page l'accès aux différents services (création de table, téléchargement d'images, ajout à la base MySQL...). L'interface est appelée via le script home.php et se présente comme ceci : L'activation des services se fait par simple click sur le bouton adéquat et est géré par le script «services.php» qui est écrit en langage PHP orienté objet dont le code est fourni ci-après. Les différents services ont été testés avec succès à l'aide de EasyPHP 3.0. Les autres services seront définis ultérieurement.

12 Fichier «HOME.PHP» require("page.inc"); $homepage = new Page(); $homepage->content ="<p>bienvenue sur le site d'astrométrie solaire lié au projet MISOLFA...</p> <p>ce site a été réalisé par Erwan Simon (OCA Cassiopée) afin d'intégrer dans une base les images FITS issues de l'acquisition sur le serveur misolfa2.</p>"; $homepage->display(); Fichier «PAGE.INC» class Page // class Page's attributes public $content; public $title = "Astrométrie solaire"; public $keywords = "Astrometrie solaire"; public $buttons = array("home" => "home.php", "Services" => "services.php" ); // class Page's operations public function set($name, $value) $this->$name = $value; public function Display() echo "<html>\n<head>\n"; $this -> DisplayTitle(); $this -> DisplayKeywords(); $this -> DisplayStyles(); echo "</head>\n<body>\n"; $this -> DisplayHeader(); $this -> DisplayMenu($this->buttons); echo $this->content; $this -> DisplayFooter(); echo "</body>\n</html>\n"; public function DisplayTitle() echo "<title>".$this->title."</title>"; public function DisplayKeywords() echo "<meta name=\"keywords\" content=\"".$this->keywords."\"/>"; public function DisplayStyles() <style> h1 color:white; font-size:24pt; text-align:center;

13 font-family:arial,sans-serif.menu color:white; font-size:12pt; text-align:center; font-family:arial,sans-serif; font-weight:bold td background:black p color:black; font-size:12pt; text-align:justify; font-family:arial,sans-serif p.foot color:white; font-size:9pt; text-align:center; font-family:arial,sans-serif; font-weight:bold a:link,a:visited,a:active color:white </style> public function DisplayHeader() <table width="100%" cellpadding="12" cellspacing="0" border="0"> <tr bgcolor ="black"> <td align ="left"><img src = "logo.gif" /></td> <td> <h1>astrométrie solaire</h1> </td> <td align ="right"><img src = "logo.gif" /></td> </tr> </table> public function DisplayMenu($buttons) echo "<table width=\"100%\" bgcolor=\"white\" cellpadding=\"4\" cellspacing=\"4\">\n"; echo "<tr>\n"; //calculate button size $width = 100/count($buttons); while (list($name, $url) = each($buttons)) $this -> DisplayButton($width, $name, $url,!$this->isurlcurrentpage($url)); echo "</tr>\n"; echo "</table>\n"; public function IsURLCurrentPage($url) if(strpos($_server['php_self'], $url )==false) return false;

14 else return true; public function DisplayButton($width,$name,$url,$active = true) if ($active) echo "<td width = \"".$width."%\"> <a href=\"".$url."\"> <img src=\"s-logo.gif\" alt=\"".$name."\" border=\"0\" /></a> <a href=\"".$url."\"><span class=\"menu\">".$name."</span></a> </td>"; else echo "<td width=\"".$width."%\"> <img src=\"side-logo.gif\"> <span class=\"menu\">".$name."</span> </td>"; public function DisplayFooter() <table width="100%" bgcolor="black" cellpadding="12" border="0"> <tr> <td> <p class="foot"> Astrométrie solaire</p> </td> </tr> </table> FICHIER SERVICES.PHP require ("page.inc"); class ServicesPage extends Page private $row2buttons = array( "Creation d'une table dans la database images" => "creation_table.php", "Téléchargement d'une image" => "DEPOT_FICHIER.html", "Insertion d'une nouvelle image dans la base" => "NOUVELLE_IMAGE.html", ); public function Display() echo "<html>\n<head>\n"; $this -> DisplayTitle(); $this -> DisplayKeywords(); $this -> DisplayStyles(); echo "</head>\n<body>\n"; $this -> DisplayHeader(); $this -> DisplayMenu($this->buttons); $this -> DisplayMenu($this->row2buttons); echo $this->content; $this -> DisplayFooter();

15 echo "</body>\n</html>\n"; $services = new ServicesPage(); $services -> content ="<p>création d'une table : permet de créer la table qui va stocker les images FITS, Téléchargement : permet de récupérer localement une image stockée sur le serveur distant, Insertion d'une image : inclusion du fichier FITS dans la database.</p>"; $services -> Display();