Autre fonction extrêmement importante de SPIP, recuperer_fond()
permet de retourner le résultat du calcul d’un squelette donné. C’est en quelque sorte l’équivalent de <INCLURE{fond=nom} />
des squelettes mais en PHP.
Elle prend 1 à 4 paramètres :
- nom et adresse du fond (sans extension)
- contexte de compilation (tableau clé/valeur)
- tableau d’options
- nom du fichier de connexion à la base de données à utiliser
Utilisation simple
Le retour est le code généré par le résultat de la compilation :
$code = recuperer_fond($nom, $contexte);
Utilisation avancée
L’option raw
définie à true
permet, plutôt que de récupérer simplement le code généré, d’obtenir un tableau d’éléments résultants de la compilation, dont le code (clé texte
).
Que contient donc ce tableau ? Le texte, l’adresse de la source du squelette (dans « source »), le nom du fichier de cache PHP généré par la compilation (dans « squelette »), un indicateur de présence de PHP dans le fichier de cache généré (dans « process_ins »), divers autres valeurs dont le contexte de compilation (la langue et la date s’ajoutent automatiquement puisqu’on ne les avait pas transmises).