Les options vous permettent d'influence sur le processus. Elles sont passées au rendu et vous devez vérifier si oui ou non le rendu que vous utilisez support ces options.
Sachant qu'il y a actuellement uniquement un rendu disponible (Plain), vous ne devriez pas vous embéter avec cela plus longtemps.
Les options peuvent être passées sous la forme d'un tableau associatif au constructeur de XML_Beautifier. Vous devriez également utiliser setOption(), ou setOptions() pour définir une ou plusieurs options après avoir créée l'instance de XML_Beautifier.
Voilà une liste de toutes les options disponibles supportées par XML_Beautifier.
| Option | Valeurs possibles | Défaut | Description |
|---|---|---|---|
| removeLineBreaks | TRUE ou FALSE | TRUE | Définie si oui ou non les sauts de ligne doivent être ajouter dans les sections cdata |
| indent | toutes chaînes | " " (4 espaces) | La chaîne passée à cette option sera utilisé pour indenter les tags d'un degrès. |
| linebreak | toutes chaînes | "\n" | La chaîne passée à cette option sera utilisé pour effectuer des retours à la ligne. Vous devriez utiliser "\n" ou "\r\n". |
| caseFolding | TRUE ou FALSE | FALSE | Active ou non la casse pour les tags et les attributs |
| caseFoldingTo | "uppercase" ou "lowercase" | "uppercase" | Peut être utilisé, si le paramètre caseFolding a été défini à TRUE pour définir si oui ou non les tags et les attributs doivent être convertie en minuscule ou majuscule. |
| normalizeComments | FALSE ou TRUE | FALSE | Si définie à TRUE, tous les espaces supplémentaires dans les commentaires XML seront convertis en un seul espace. Cela convertira un commentaire sur plusieurs lignes en un commentaire sur une seule ligne. |
| maxCommentLine | entier | -1 | Longueur maximal pour une ligne d'un comentaire. Si un commentaire dépasse cette limite, il sera automatiquement coupé. Si définie à -1, la longueur de la ligne est illimitée. |
| multilineTags | TRUE ou FALSE | FALSE | Si définie à TRUEn un retour à la ligne sera ajouter dans le tag après chaque attribut et les attributs seront indentés. |
L'exemple suivant montre comme définir les options pour XML_Beautifier.
Utilisation de setOptions() et de setOption()
<?php
require_once "XML/Beautifier.php";
$options = array(
"caseFolding" => true,
"caseFoldingTo" => "uppercase",
"normalizeComments" => true
);
$fmt = new XML_Beautifier($options);
$result = $fmt->formatFile('originalFile.xml', 'outputFile.xml');
?>
L'exemple suivant montre comme définir les options pour XML_Beautifier, si l'instance a déjà été créée.
Options de XML_Beautifier
<?php
require_once "XML/Beautifier.php";
$fmt = new XML_Beautifier();
$options = array(
"caseFolding" => true,
"caseFoldingTo" => "uppercase",
"normalizeComments" => true
);
$fmt->setOptions($options);
$fmt->setOption("indent", "\t");
$result = $fmt->formatFile('originalFile.xml', 'outputFile.xml');
?>