NECESSITE : PHP 5.
DOMDocument et XSLTProcessor sont préférables, mais non obligatoires.
Une petite classe qui va permettre de générer un flux XML, et de le transofmer en un menu.
Ce n'est qu'une première approche, et demande à être personnalisé. Mais c'est un bon entrainement pour qui veut voir un peu comment peuvent interagir PHP et le XML.
La classe XML Menu permet donc de générer un type de flux XML. Evidemment, ce flux peut aussi être créé à la main, très facilement.
Ensuite, cette classe utilise des fichiers XSL pour transformer ce flux XML en un menu HTML. J'ai créé 2 types de fichiers, et on peut en créer autant que l'on veut (il suffit de les placer dans le répertoire 'xsl' pour qu'ils soient gérés).
Les flux XML généréré peuvent être sauvegardés (répertoire 'xml'), de même que les menus html générés (répertoire 'html'). On peut aussi charger un flux xml à partir d'un fichier (si, par exemple, on a créé le flux XML à la main).
Voir le fichier class/xmlmenu.cls.php pour plus d'informations sur les différentes méthodes utilisables.
Source / Exemple :
<?php
class abstractxmlmenu {
/**
- protected (object) doc
- DOMDocument object
- /
protected $doc = null;
/**
- protected (object::node) root
- DOMDocument root node
- /
protected $root = null;
/**
- protected (array) aTypes
- XML to HTML XSLT types
- /
protected $aTypes = array ();
/**
- protected (string) sHtml
- HTML menu string
- /
protected $sHtml = '';
/**
- protected (string) sXml
- XML menu string
- /
protected $sXml = '';
/**
- public function __construct
- constructor
- @Param (string) sVersion : xml version
- @Param (string) sEncoding : xml encoding
- /
public function __construct ($sVersion = null, $sEncoding= null) {
$aTypes = scandir ('xsl');
foreach ($aTypes as $type) {
$this -> aTypes[$type] = strtoupper (substr ($type, 0, -4));
}
}
/**
- public function defineNode
- method defining a node
- @Param (string) sText : text of the node
- @Param (array) aAttr : array of attributes for the node
- @Param (int) iId : id of the parent node
- @Return (int) new node's id
- /
public function defineNode ($sText, $aAttr = array (), $iId=0) {
$newElem = $this -> doc -> createElement ('node', $sText);
$dump = $this -> root -> getElementsByTagName('node');
$iNewId = $dump -> length + 1;
if($iId===0){
$newElem = $this -> root -> appendChild ($newElem);
}
else {
$parent = $this -> doc -> getElementById($iId);
$newElem = $parent -> appendChild ($newElem);
}
$newElem -> setAttribute ('xml:id', $iNewId);
if (!empty ($aAttr) && is_array ($aAttr)) {
$this -> defineAttributes ($aAttr, $iNewId);
}
return $iNewId;
}
/**
- public function defineLink
- method defining a link on a given node
- @Param (string) sLink : url of the link
- @Param (int) iId : id of the node
- /
public function defineLink ($sLink, $iId) {
$elem = $this -> doc -> getElementById($iId);
$elem -> setAttribute ('link', $sLink);
}
/**
- public function defineAttributes
- method defining attributes for a given node
- @Param (array) aAttr : array of attributes
- @Param (int) iId : id of the node
- /
public function defineAttributes ($aAttr, $iId) {
$elem = $this -> doc -> getElementById($iId);
foreach ($aAttr as $attrName => $attrValue) {
$elem -> setAttribute ($attrName, $attrValue);
}
}
/**
- public function __toString
- method to return the XML of a menu
- @return (string) iId : XML string
- /
public function __toString () {
return htmlentities ($this -> doc -> saveXML ());
}
/**
- public function xmlToFile
- method to save the xml to a file
- @Param (string) sFileName :filename
- /
public function xmlToFile ($sFileName) {
$this -> doc -> save ('xml/'.$sFileName.'.xml');
}
/**
- public function fileToXml
- method to load an xml from a file
- @Param (string) sFileName :filename
- /
public function fileToXml ($sFileName) {
$this -> doc -> load ('xml/'.$sFileName.'.xml');
}
/**
- public function htmlToFile
- method to save the html to a file.
- cannot be done if XSLTProcessor is not enabled (see comments in the xmlmenu::toHTML () method to learn how to save the HTML file)
- @Param (string) sFileName :filename
- /
public function htmlToFile ($sFileName) {
if (empty ($this -> sHtml)) {
return false;
}
$fp = fopen ('html/'.$sFileName.'.html', 'w+');
fwrite ($fp, $this -> sHtml);
fclose ($fp);
return true;
}
/**
- public function toHTML
- method to transform the xml to html
- @Param (string) sType : XSL file to be used
- @Return (string) sHtml : transformed HTML string
- /
public function toHTML ($sType) {
if (false === ( $type = array_search($sType, $this -> aTypes))) {
return false;
}
$xsl = new XSLTProcessor ();
$xsl -> importStyleSheet (DOMDocument::load ('xsl/'.$type));
$this -> sHtml = $xsl -> transformToXML ($this -> doc);
return $this -> sHtml;
}
}
?>
Conclusion :
Decouverte d'un bug dans la version sans DOM. Bon, on s'en fout, DOM fait partie du core de php...mais quand même!! Bref, problème d'imbrication lorsqu'un noeud a plusieurs noeuds enfants...je travaille à la correction.
Nouvel ajout : DOMDocument n'est plus non plus obligatoire.
Et l'appel à la classe a changé.
On instancie désormais par :
$menu = xmlmenu::getInstance ($sVersion, $sEncoding);
(voir index.php)
L'instanciation correcte est alors appelée, en fonction des extensions activées ou non. Aucun appel aux méthodes ne change de toutes façons :-) Même s'il y a désormais 3 classes différentes.
Si on a pas DOMDocument, le parsing se fait comme un par parsing de chaîne, et c'est assez efficace :-)
Bon, cette fois, XSLTProcessor n'est plus nécessaire. Mais je vais expliquer ici comment j'ai contourné... :
Si XSLTProcessor n'est pas activé, le code le détecte seul (j'ai ajouté la détection de DOMDocument aussi, car je vais aussi faire en sorte que ce code fonctionne même dans DOMDocument).
Dans ce cas, lors de l'application du XSL, voici ce que fait la classe :
- elle prend le XML généré, et le parse pour lui ajouter un lien vers le XSL désiré (<?xml-stylesheet type="text/xsl" href="..." ?>)
- elle réécrit ce XML et le sauvegarde dans un répertoire tmp_xml.
- au lieu de renvoyer, comme c'est le cas si XSLTProcessor est activé, le html généré, elle renvoie un lien vers le fichier XML nouvellement enregistré.
- ce lien va afficher correctement le XML sous forme d'une page HTML...sauf que si on mate la source, on voit toujours du XML (mais l'output est bien du HTML).
- pour récupérer le vrai fichier HTML, il faut, avec son client web (testé avec IE et FF), faire "enregistrer sous...) et l'enregistrer quelque part (on se fiche de l'extension, mais par défaut ce sera un .html).
- si on regarde la source du fichier ainsi enregistré, on verra bien du HTML. Si on le lance, ce sera aussi du html : plus trace du XML :-) ).
C'est un peu compliqué, mais je n'ai pas trouvé, pour l'instant, d'autre moyen.
Vous n'êtes pas encore membre ?
inscrivez-vous, c'est gratuit et ça prend moins d'une minute !
Les membres obtiennent plus de réponses que les utilisateurs anonymes.
Le fait d'être membre vous permet d'avoir un suivi détaillé de vos demandes et codes sources.
Le fait d'être membre vous permet d'avoir des options supplémentaires.