API Documentation
Table of Contents
Constants
- _EZCACHE_CODAGE_CSV_DELIMITEUR = ['csv' => ',', 'tsv' => "\t", 'ssv' => ';']
Functions
- action_telecharger_cache_dist() : void
- Telecharge un fichier cache identifié par son chemin.
- ezcache_cache_configurer() : array<string, mixed>
- Récupère ou charge la configuration des types de cache d'un plugin, la complète et la stocke dans une meta.
- ezcache_cache_verifier() : array<string, mixed>
- Vérifie l'identifiant relatif du cache et le complète le cas échéant si le plugin utilise un sous-dossier ou un préfixe.
- ezcache_cache_composer() : string
- Construit le chemin complet du fichier cache.
- ezcache_cache_decomposer() : array<string, mixed>
- Décompose le chemin complet du fichier cache en éléments constitutifs. Par défaut, le tableau obtenu coïncide avec l’identifiant relatif du cache. La fonction utilise la configuration générale pour connaitre la structure du chemin du fichier.
- ezcache_cache_completer() : array<string, mixed>
- Complète la description d'un cache issue du service `cache_decomposer()`.
- ezcache_cache_encoder() : string
- Encode le contenu futur d'un cache (tableau) en fonction de l'attribut de codage configuré pour le type de cache.
- ezcache_cache_decoder() : array<string|int, mixed>
- Décode le contenu du fichier cache en fonction de l'attribut de codage configuré pour le type de cache.
- ezcache_cache_valider() : bool
- Vérifie la validité du fichier cache.
- ezcache_valider_codage() : bool
- Vérifie la validité du codage.
- ezcache_sous_chemin() : void
- Crée tous les répertoires manquants dans une arborescence donnée.
- balise_CACHE_LISTE_dist() : Champ
- Compile la balise `#CACHE_LISTE` qui fournit la liste des caches pour un plugin utilisateur donné et conformes aux filtres éventuellement fournis. Pour se focaliser sur un type de cache donné du plugin il faut le fournir en filtre avec pour critère `type_cache`.
- balise_EZCACHE_PLUGINS_dist() : Champ
- Compile la balise `#EZCACHE_PLUGINS` qui fournit les plugins utilisateur actifs implémentant des caches.
- traiter_balise_ezcache_plugins() : array<string|int, mixed>
- Renvoie la liste des préfixes des plugins actifs ou tous les plugins utilisant Cache Factory.
- ezcache_affiche_milieu() : array<string|int, mixed>
- Supprime la meta stockant la configuration des caches de tous les plugins utilisateur quand la page d'administration des plugins est affiché.
- formulaires_cache_vider_charger() : array<string, mixed>
- Chargement des données : le formulaire affiche la liste des caches administrables issus de l'utilisation du service et propose le vidage de tout ou partie des fichiers.
- formulaires_cache_vider_verifier() : array<string, mixed>
- Vérification des saisies : il est obligatoire de choisir un cache à supprimer.
- formulaires_cache_vider_traiter() : array<string, mixed>
- Exécution du formulaire : la liste des caches sélectionnés est récupérée et fournie à l'API cache pour suppression.
- cache_ecrire() : bool
- Ecrit un contenu donné dans un cache spécifié par son identifiant relatif ou par son chemin complet.
- cache_lire() : array<string|int, mixed>|bool|string
- Lit le cache spécifié par son identifiant relatif ou son chemin complet et renvoie le contenu sous forme de tableau ou de chaine suivant l’attribut de sérialisation.
- cache_est_valide() : string
- Teste l'existence d'un cache sur le disque spécifié par son identifiant relatif ou par son chemin complet et, si il existe, teste si la date d'expiration du fichier n'est pas dépassée. Si le fichier existe et n'est pas périmé, la fonction renvoie le chemin complet, sinon elle renvoie une chaine vide.
- cache_nommer() : string
- Renvoie le chemin complet du cache sans tester son existence.
- cache_supprimer() : bool
- Supprime le cache spécifié par son identifiant relatif ou par son chemin complet.
- cache_repertorier() : array<string|int, mixed>
- Retourne la description des caches d'un plugin utilisateur filtrée sur un ensemble de critères. La description de base fournie par Cache Factory contient les éléments de l’identifiant relatif mais peut-être remplacée ou complétée par le plugin appelant au travers de services propres.
- cache_vider() : bool
- Supprime, pour un plugin donné, les caches désignés par leur chemin complet.
- configuration_cache_recharger() : void
- Recharge les configurations standard des types de cache d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.
- configuration_cache_lire() : array<string, mixed>
- Lit la configuration standard d'un type de cache d'un plugin utilisateur, de tous les types de caches ou de tous les plugins utilisateur ayant enregistrés une configuration.
- configuration_cache_effacer() : bool
- Efface les configurations standard de types de cache d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.
- configuration_codage_csv_lire() : array<string, mixed>
- Lit la configuration du délimiteur CSV correspondant au codage (`csv`, `ssv`, ou `tsv`).
Constants
_EZCACHE_CODAGE_CSV_DELIMITEUR
public
mixed
_EZCACHE_CODAGE_CSV_DELIMITEUR
= ['csv' => ',', 'tsv' => "\t", 'ssv' => ';']
Functions
action_telecharger_cache_dist()
Telecharge un fichier cache identifié par son chemin.
action_telecharger_cache_dist() : void
ezcache_cache_configurer()
Récupère ou charge la configuration des types de cache d'un plugin, la complète et la stocke dans une meta.
ezcache_cache_configurer(string $plugin) : array<string, mixed>
Le plugin Cache Factory propose une configuration par défaut des caches.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
Tags
Return values
array<string, mixed> —Tableau des configurations complétée des caches d'un plugin venant d'être enregistrée.
ezcache_cache_verifier()
Vérifie l'identifiant relatif du cache et le complète le cas échéant si le plugin utilise un sous-dossier ou un préfixe.
ezcache_cache_verifier(string $plugin, array<string, mixed> $cache, array<string, mixed> $configuration) : array<string, mixed>
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $cache : array<string, mixed>
-
Tableau identifiant le cache pour lequel on veut construire le nom.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utlisateur lue à partir de la meta de stockage.
Tags
Return values
array<string, mixed> —L'identifiant relatif du cache vérifié et éventuellement complété ou tableau vide si erreur.
ezcache_cache_composer()
Construit le chemin complet du fichier cache.
ezcache_cache_composer(string $plugin, array<string, mixed> $cache, array<string, mixed> $configuration) : string
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $cache : array<string, mixed>
-
Tableau identifiant le cache pour lequel on veut construire le nom.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utlisateur lue à partir de la meta de stockage.
Tags
Return values
stringezcache_cache_decomposer()
Décompose le chemin complet du fichier cache en éléments constitutifs. Par défaut, le tableau obtenu coïncide avec l’identifiant relatif du cache. La fonction utilise la configuration générale pour connaitre la structure du chemin du fichier.
ezcache_cache_decomposer(string $plugin, string $fichier_cache, array<string, mixed> $configuration) : array<string, mixed>
Cache Factory renvoie uniquement les éléments de l'identifiant relatif.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $fichier_cache : string
-
Le chemin complet du fichier à phraser.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utlisateur lue à partir de la meta de stockage.
Tags
Return values
array<string, mixed> —Tableau des composants constitutifs du cache
ezcache_cache_completer()
Complète la description d'un cache issue du service `cache_decomposer()`.
ezcache_cache_completer(string $plugin, array<string, mixed> $cache, string $fichier_cache, array<string, mixed> $configuration) : array<string, mixed>
Le plugin Cache Factory complète la description canonique avec le nom sans extension, l'extension du fichier, la date et la taille du fichier.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $cache : array<string, mixed>
-
Tableau identifiant le cache pour lequel on veut construire le nom.
- $fichier_cache : string
-
Fichier cache désigné par son chemin complet.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utilisateur lue à partir de la meta de stockage.
Tags
Return values
array<string, mixed> —Description du cache complétée par un ensemble de données propres au plugin.
ezcache_cache_encoder()
Encode le contenu futur d'un cache (tableau) en fonction de l'attribut de codage configuré pour le type de cache.
ezcache_cache_encoder(string $plugin, string $codage, array<string|int, mixed> $contenu, array<string, mixed> $configuration) : string
Le plugin Cache Factory utilise des fonctions standard de PHP, de SPIP, du plugin YAML ou les siennes (CSV).
- Un plugin appelant peut proposer une fonction spécifique de décodage
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $codage : string
-
Codage à prendre en priorité par rapport à celui configuré (utile parfois pour les csv)
- $contenu : array<string|int, mixed>
-
Contenu futur du fichier cache au format tableau.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utilisateur lue à partir de la meta de stockage.
Tags
Return values
string —Contenu tabulaire du cache encodé en chaine si la fonction idoine a été appliqué ou chaine vide sinon.
ezcache_cache_decoder()
Décode le contenu du fichier cache en fonction de l'attribut de codage configuré pour le type de cache.
ezcache_cache_decoder(string $plugin, string $codage, string $contenu, array<string, mixed> $configuration) : array<string|int, mixed>
Le plugin Cache Factory utilise des fonctions standard de PHP, de SPIP, du plugin YAML ou les siennes (CSV). Un plugin appelant peut proposer une fonction spécifique de décodage
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $codage : string
-
Codage à prendre en priorité par rapport à celui configuré (utile parfois pour les csv)
- $contenu : string
-
Contenu du fichier cache au format chaine.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utilisateur lue à partir de la meta de stockage.
Tags
Return values
array<string|int, mixed> —Contenu du cache décodé en tableau si la fonction idoine a été appliquée ou tableau vide sinon.
ezcache_cache_valider()
Vérifie la validité du fichier cache.
ezcache_cache_valider(string $plugin, string $fichier_cache, array<string, mixed> $cache, array<string, mixed> $configuration) : bool
Le plugin Cache Factory teste toujours la péremption du fichier (durée de conservation issue). Il est toutefois possible de rajouter des tests spécifiques en appelant un service propre au plugin.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $fichier_cache : string
-
Le chemin complet du fichier à valider.
- $cache : array<string, mixed>
-
Tableau identifiant le cache (redondant avec l'argument $fichier_cache mais peut être nécessaire pour les éventuels tests complémentaires du plugin utilisateur.
- $configuration : array<string, mixed>
-
Configuration complète des caches du plugin utlisateur lue à partir de la meta de stockage.
Tags
Return values
bool —true
si le cache est valide, false
sinon.
ezcache_valider_codage()
Vérifie la validité du codage.
ezcache_valider_codage(string $codage) : bool
Parameters
- $codage : string
Return values
bool —true
si le codage est valide, false
sinon.
ezcache_sous_chemin()
Crée tous les répertoires manquants dans une arborescence donnée.
ezcache_sous_chemin(string $arborescence) : void
Les répertoires sont séparés par des '/'.
Parameters
- $arborescence : string
-
Arborescence telle que 'prive/squelettes/contenu'
Tags
balise_CACHE_LISTE_dist()
Compile la balise `#CACHE_LISTE` qui fournit la liste des caches pour un plugin utilisateur donné et conformes aux filtres éventuellement fournis. Pour se focaliser sur un type de cache donné du plugin il faut le fournir en filtre avec pour critère `type_cache`.
balise_CACHE_LISTE_dist(Champ $p) : Champ
La signature de la balise est : #CACHE_LISTE{plugin[, filtres]}
.
Parameters
- $p : Champ
-
Pile au niveau de la balise.
Tags
Return values
Champ —Pile complétée par le code à générer.
balise_EZCACHE_PLUGINS_dist()
Compile la balise `#EZCACHE_PLUGINS` qui fournit les plugins utilisateur actifs implémentant des caches.
balise_EZCACHE_PLUGINS_dist(Champ $p) : Champ
La signature de la balise est : #EZCACHE_PLUGINS{[actifs_seuls]}
.
Parameters
- $p : Champ
-
Pile au niveau de la balise.
Tags
Return values
Champ —Pile complétée par le code à générer.
traiter_balise_ezcache_plugins()
Renvoie la liste des préfixes des plugins actifs ou tous les plugins utilisant Cache Factory.
traiter_balise_ezcache_plugins([mixed $actifs_seuls = 'oui' ]) : array<string|int, mixed>
L'utilisation du plugin Cache Factory est repérée via la meta cache
dans la table spip_meta
.
Parameters
- $actifs_seuls : mixed = 'oui'
Return values
array<string|int, mixed> —Liste des préfixes en minuscules
ezcache_affiche_milieu()
Supprime la meta stockant la configuration des caches de tous les plugins utilisateur quand la page d'administration des plugins est affiché.
ezcache_affiche_milieu(array<string|int, mixed> $flux) : array<string|int, mixed>
C'est un peu grossier mais il n'existe pas de pipeline pour agir à la mise à jour d'un plugin. Au moins, cela permet facilement de recharger une configuration d'un plugin utilisateur qui aurait changée sans être une opération trop récurrente.
Parameters
- $flux : array<string|int, mixed>
-
Tableau des données permettant de caractériser la page concernée et de déclencher le traitement uniquement sur la page
admin_plugin
.
Tags
Return values
array<string|int, mixed> —Le flux entrant n'est pas modifié.
formulaires_cache_vider_charger()
Chargement des données : le formulaire affiche la liste des caches administrables issus de l'utilisation du service et propose le vidage de tout ou partie des fichiers.
formulaires_cache_vider_charger(string $plugin[, null|array<string|int, mixed> $options = [] ]) : array<string, mixed>
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $options : null|array<string|int, mixed> = []
-
Tableau d'options qui peut être fourni par un plugin utilisateur uniquement si celui-ci fait appel au formulaire. La page cache_vider de Cache Factory n'utilise pas ce paramètre. Le tableau est passé à la fonction de service de chargement du formulaire uniquement.
Tags
Return values
array<string, mixed> —Tableau des données à charger par le formulaire (affichage). Aucune donnée chargée n'est un champ de saisie, celle-ci sont systématiquement remises à zéro. Le tableau comprend à minima l'index suivant:
_caches
: (affichage) liste des descriptions des caches du plugin rangés par groupes
formulaires_cache_vider_verifier()
Vérification des saisies : il est obligatoire de choisir un cache à supprimer.
formulaires_cache_vider_verifier(string $plugin[, null|array<string|int, mixed> $options = [] ]) : array<string, mixed>
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $options : null|array<string|int, mixed> = []
-
Tableau d'options qui peut être fourni par un plugin utilisateur uniquement si celui-ci fait appel au formulaire. La page cache_vider de Cache Factory n'utilise pas ce paramètre. Le tableau est passé à la fonction de service de chargement du formulaire uniquement.
Return values
array<string, mixed> —Tableau des erreurs qui se limite à la non sélection d'au moins un cache.
formulaires_cache_vider_traiter()
Exécution du formulaire : la liste des caches sélectionnés est récupérée et fournie à l'API cache pour suppression.
formulaires_cache_vider_traiter(string $plugin[, null|array<string|int, mixed> $options = [] ]) : array<string, mixed>
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $options : null|array<string|int, mixed> = []
-
Tableau d'options qui peut être fourni par un plugin utilisateur uniquement si celui-ci fait appel au formulaire. La page cache_vider de Cache Factory n'utilise pas ce paramètre. Le tableau est passé à la fonction de service de chargement du formulaire uniquement.
Tags
Return values
array<string, mixed> —Tableau retourné par le formulaire contenant toujours un message de bonne exécution. L'indicateur editable est toujours à vrai.
cache_ecrire()
Ecrit un contenu donné dans un cache spécifié par son identifiant relatif ou par son chemin complet.
cache_ecrire(string $plugin, string $type_cache, array<string, mixed>|string $cache, array<string|int, mixed>|string $contenu[, null|bool $post_cache = true ]) : bool
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $cache : array<string, mixed>|string
-
Identifiant du cache sous la forme d'une chaine (le chemin du fichier) ou d'un tableau fournissant les composants canoniques du nom.
- $contenu : array<string|int, mixed>|string
-
Contenu sous forme de tableau à sérialiser/encoder ou sous la forme d'une chaine.
- $post_cache : null|bool = true
-
true
si on doit appeler le pipeline post_cache oufalse
sinon. Le défaut vauttrue
. Permet d'utiliser l'API dans le pipeline post_cache.
Tags
Return values
bool —True si l'écriture s'est bien passée, false sinon.
cache_lire()
Lit le cache spécifié par son identifiant relatif ou son chemin complet et renvoie le contenu sous forme de tableau ou de chaine suivant l’attribut de sérialisation.
cache_lire(string $plugin, string $type_cache, array<string, mixed>|string $cache) : array<string|int, mixed>|bool|string
En cas d’erreur, la fonction renvoie false.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $cache : array<string, mixed>|string
-
Identifiant du cache sous la forme d'une chaine (le chemin du fichier) ou d'un tableau fournissant les composants canoniques du nom.
Tags
Return values
array<string|int, mixed>|bool|string —Contenu du fichier sous la forme d'un tableau, d'une chaine ou false si une erreur s'est produite.
cache_est_valide()
Teste l'existence d'un cache sur le disque spécifié par son identifiant relatif ou par son chemin complet et, si il existe, teste si la date d'expiration du fichier n'est pas dépassée. Si le fichier existe et n'est pas périmé, la fonction renvoie le chemin complet, sinon elle renvoie une chaine vide.
cache_est_valide(string $plugin, string $type_cache, array<string, mixed>|string $cache) : string
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $cache : array<string, mixed>|string
-
Identifiant du cache sous la forme d'une chaine (le chemin du fichier) ou d'un tableau fournissant les composants canoniques du nom.
Tags
Return values
string —Le chemin complet du fichier si valide, la chaine vide sinon.
cache_nommer()
Renvoie le chemin complet du cache sans tester son existence.
cache_nommer(string $plugin, string $type_cache, array<string, mixed> $cache) : string
Cette fonction est une encapsulation du service ezcache_cache_composer().
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $cache : array<string, mixed>
-
Identifiant du cache sous la forme d'un tableau fournissant les composants canoniques du nom.
Tags
Return values
string —Chemin complet du fichier cache
cache_supprimer()
Supprime le cache spécifié par son identifiant relatif ou par son chemin complet.
cache_supprimer(string $plugin, string $type_cache, array<string, mixed>|string $cache[, null|bool $post_cache = true ]) : bool
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $cache : array<string, mixed>|string
-
Identifiant du cache sous la forme d'une chaine (le chemin du fichier) ou d'un tableau fournissant les composants canoniques du nom.
- $post_cache : null|bool = true
-
true
si on doit appeler le pipeline post_cache oufalse
sinon. Le défaut vauttrue
. Permet d'utiliser l'API dans le pipeline post_cache.
Tags
Return values
bool —true
si la suppression s'est bien passée, false
sinon.
cache_repertorier()
Retourne la description des caches d'un plugin utilisateur filtrée sur un ensemble de critères. La description de base fournie par Cache Factory contient les éléments de l’identifiant relatif mais peut-être remplacée ou complétée par le plugin appelant au travers de services propres.
cache_repertorier(string $plugin, string $type_cache[, null|array<string, mixed> $filtres = [] ]) : array<string|int, mixed>
Les filtres concernent uniquement les éléments de l’identifiant relatif.
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $filtres : null|array<string, mixed> = []
-
Tableau associatif
[champ] = valeur
ou[champ] = !valeur
de critères de filtres sur les composants de caches. Les opérateurs égalité et inégalité sont possibles.
Tags
Return values
array<string|int, mixed> —Tableau des descriptions des fichiers cache créés par le plugin indexé par le chemin complet de chaque fichier cache.
cache_vider()
Supprime, pour un plugin donné, les caches désignés par leur chemin complet.
cache_vider(string $plugin, string $type_cache, array<string|int, mixed> $caches[, null|bool $post_cache = true ]) : bool
Parameters
- $plugin : string
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe.
- $type_cache : string
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin
- $caches : array<string|int, mixed>
-
Liste des fichiers caches désignés par leur chemin complet.
- $post_cache : null|bool = true
-
true
si on doit appeler le pipeline post_cache oufalse
sinon. Le défaut vauttrue
. Permet d'utiliser l'API dans le pipeline post_cache.
Tags
Return values
bool —true
si la suppression s'est bien passée, false
sinon.
configuration_cache_recharger()
Recharge les configurations standard des types de cache d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.
configuration_cache_recharger([null|string $plugin = '' ]) : void
Parameters
- $plugin : null|string = ''
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe. Si vide, toutes les configurations sont rechargées.
Tags
configuration_cache_lire()
Lit la configuration standard d'un type de cache d'un plugin utilisateur, de tous les types de caches ou de tous les plugins utilisateur ayant enregistrés une configuration.
configuration_cache_lire([null|string $plugin = '' ][, null|string $type_cache = '' ]) : array<string, mixed>
Parameters
- $plugin : null|string = ''
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe. Si vide, toutes les configurations sont fournies.
- $type_cache : null|string = ''
-
Type de cache identifiant la configuration dans la liste des configurations de cache du plugin Si vide toutes les configurations du plugin sont renvoyées.
Tags
Return values
array<string, mixed> —Tableau de configuration des caches d'un plugin utilisateur ou tableau vide si aucune configuration n'est encore enregistrée.
configuration_cache_effacer()
Efface les configurations standard de types de cache d'un plugin utilisateur ou de tous les plugins utilisateur ayant enregistrés une configuration.
configuration_cache_effacer([null|string $plugin = '' ]) : bool
Parameters
- $plugin : null|string = ''
-
Identifiant qui permet de distinguer le module appelant qui peut-être un plugin comme le noiZetier ou un script. Pour un plugin, le plus pertinent est d'utiliser le préfixe. Si vide, toutes les configurations sont effacées.
Tags
Return values
bool —true
si la suppression s'est bien passée, false
sinon.
configuration_codage_csv_lire()
Lit la configuration du délimiteur CSV correspondant au codage (`csv`, `ssv`, ou `tsv`).
configuration_codage_csv_lire() : array<string, mixed>
Return values
array<string, mixed> —Tableau de configuration du codage CSV qui définit le délimiteur.