Le plugin YAML

YAML est un format de fichier simple et néanmoins complet permettant d’éditer des listes de données de manière très aisée.

Pour une présentation de ce format, lire «Je suis fan de YAML».

YAML est de plus en plus utilisé dans SPIP, par divers plugins (par exemple textwheel, saisies, itérateurs...). Ce plugin permet aux autres plugins d’exploiter ce format, aussi bien en lecture :
— fonction yaml_decode()
— boucle (DATA){source yaml, fichier.yaml}

qu’en écriture :
— fonction yaml_encode()

Son utilisation est on ne peut plus simple.

En PHP

Pour lire des données YAML, il suffit de faire :

include_spip('inc/yaml');
$data = yaml_decode( $contenu_du_fichier_yaml );
var_dump( $data );

Pour transformer un tableau de données (array) en YAML, on fera :

include_spip('inc/yaml');
$yaml = yaml_encode( $tableau );
var_dump( $yaml );

La boucle YAML

Dans un squelette, on utilisera la boucle (DATA) (cela nécessite les itérateurs de SPIP) avec le format yaml :

Boucle :

<BOUCLE_yaml(DATA){source yaml, http://per.sonn.es/Fil.yaml}>
<dt>#CLE</dt>
<dd>[(#VALEUR|print)]</dd>
</BOUCLE_yaml>

Résultat :

name
Fil
sex
F
birthday
1966-08-17
job
Calorifugeur
friends
Maude Guérin, Zohra Robin, Pierre-Yves Philippe, Lauriane Bertin, Jeannine Pichon, Vanessa Michel, Wendy Allard, Sylvie Michaud, Gwenaël Voisin, Paule Mary, Maia Ribeiro, Josianne François, Lucas Fernandes
...

updated on 2 October 2019

Discussion

2 discussions

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom