Documentation du code de SPIP et de ses plugins

Saisies pour formulaires

Application

Table of Contents

Functions

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille()  : array<string|int, mixed>|string
Déclaration de la balise LISTER_VALEURS pour la saisie `choix_grille`
champs_extras_serialiser_choix_grille()  : string
Sérialise les réponses à un champ extra de type `choix_grille` pour encodage en base.
formulaires_configurer_saisies_saisies_dist()  : array<string|int, mixed>
Saisies du formulaire de configuration de saisies
formulaires_construire_formulaire_charger()  : array<string|int, mixed>
Formulaire permettant de construire un formulaire ! En agençant des champs Chargement.
formulaires_construire_formulaire_verifier()  : mixed
formulaires_construire_formulaire_traiter()  : mixed
construire_formulaire_generer_saisie_configurable()  : string
Préparer une saisie pour la transformer en truc configurable
saisies_groupe_inserer()  : mixed
construire_formulaire_config_inserer_option_depublie()  : array<string|int, mixed>
Insérer dans le formulaire de config l'option pour dépublier une saisie
formulaires_saisies_cvt_saisies_dist()  : mixed
formulaires_saisies_cvt_charger()  : mixed
saisie_editable()  : bool
Indique si une saisie peut être affichée.
saisies_generer_html()  : string
Génère une saisie à partir d'un tableau la décrivant et de l'environnement.
saisies_generer_vue()  : string
Génère une vue d'une saisie à partir d'un tableau la décrivant.
saisies_trouver_erreur()  : string
Récupère l'erreur d'une saisie particulière au sein d'un tableau d'erreur
saisies_saisie_est_tabulaire()  : return
La saisie renvoie t-elle un tableau? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`selection` par ex.) peuvent, en fonction des options, être tabulaire ou pas.
saisies_saisie_est_fichier()  : bool
La saisie remplie-t-elle `$_FILES` ? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`input` par ex.) peuvent, en fonction des options, être fichier ou pas.
saisies_saisie_est_gelee()  : bool
Indique si une saisie à sa valeur gelée - soit par option disabled avec envoi cachée - soit par option readonly
saisies_verifier_gel_saisie()  : bool
saisies_saisie_est_avec_sous_saisies()  : bool
Renvoie true si la saisie est un conteneur de sous saisies, qu'elle contienne effectivement des sous saisies ou pas
saisies_saisie_est_labelisable()  : bool
Renvoie true si la saisie peut recevoir un label, qu'elle contienne effectivement un label ou pas
saisies_saisie_est_champ()  : bool
Renvoie true si la saisie correspond à un champ au sens HTML
saisies_saisie_get_label()  : string
Renvoi le label de la saisie la plupart du temps c'est juste le champ label mais pour certaines saisies c'est autre chose
saisies_lister_par_identifiant()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par identifiant unique.
saisies_lister_par_nom()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par nom.
saisies_lister_finales()  : liste
Liste les saisies en parcourant tous les niveau de la hiérarchie, et en excluant les saisies ayant des sous-saisies
saisies_lister_avec_option()  : liste
Liste les saisies ayant une option X # saisies_lister_avec_option('sql', $saisies);.
saisies_lister_avec_sql()  : liste
Liste les saisies ayant une definition SQL.
saisies_lister_avec_type()  : liste
Liste les saisies d'un certain type.
saisies_lister_par_type()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par type de saisie.
saisies_lister_par_etapes()  : array<string|int, mixed>|bool
Liste les saisies par étapes s'il y en a
saisies_lister_champs()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne une liste des noms des champs du formulaire.
saisies_lister_labels()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne une liste des labels humains des vrais champs du formulaire (par nom)
saisies_charger_champs()  : array<string|int, mixed>
A utiliser dans une fonction charger d'un formulaire CVT, cette fonction renvoie le tableau de contexte correspondant de la forme $contexte['nom_champ'] = ''.
saisies_lister_valeurs_defaut()  : array<string|int, mixed>
Prend la description complète du contenu d'un formulaire et retourne une liste des valeurs par défaut des champs du formulaire.
saisies_comparer()  : array<string|int, mixed>
Compare deux tableaux de saisies pour connaitre les différences.
saisies_comparer_rappel()  : int
Compare deux saisies et indique si elles sont égales ou pas.
saisies_comparer_par_identifiant()  : array<string|int, mixed>
Compare deux tableaux de saisies pour connaitre les différences en s'appuyant sur les identifiants de saisies.
saisies_autonomes()  : array<string|int, mixed>
Quelles sont les saisies qui se débrouillent toutes seules, sans le _base commun.
saisies_chercher()  : array<string|int, mixed>
Cherche une saisie par son id, son nom ou son chemin et renvoie soit la saisie, soit son chemin
saisies_lister_champs_par_section()  : array<string|int, mixed>
Prend un tableau de saisie retourne un tableau contenant uniquement les champs de saisie organisé par section (fieldset), avec pour chaque saisie le nom de la saisie en clé
saisies_lister_disponibles()  : array<string|int, mixed>
Liste toutes les saisies configurables (ayant une description).
saisies_groupes_lister_disponibles()  : array<string|int, mixed>
Liste tous les groupes de saisies configurables (ayant une description).
saisies_lister_disponibles_sql()  : array<string|int, mixed>
Lister les saisies existantes ayant une définition SQL.
saisies_charger_infos()  : array<string|int, mixed>
Charger les informations contenues dans le YAML d'une saisie.
saisies_recuperer_heritage()  : array<string|int, mixed>
Permet à une saisie d'hériter des options et valeur par défaut d'une autre saisies
saisies_lister_categories()  : array<string|int, mixed>
Lister les catégories par défaut, puis les envoyer au pipeline
saisies_lister_disponibles_par_categories()  : array<string|int, mixed>
Lister les saisies disponibles en les regroupant en catégories
saisies_lister_disponibles_sql_par_categories()  : mixed
Liste par catégorie les saisies disponibles ayant une définition SQL
saisies_regrouper_disponibles_par_categories()  : array<string|int, mixed>
Regroupe par categories les saisies
saisies_lister_disponibles_par_categories_usort()  : int
Function de comparaison pour trier les saisies disponibles par rang Si pas de rang défini, on met après ceux avec rang Si deux saisies avec le même rang, on se rabat sur l'ordre alpha
saisies_supprimer()  : array<string|int, mixed>
Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.
saisies_inserer()  : array<string|int, mixed>
Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer
saisies_inserer_avant()  : array<string|int, mixed>
Insère une saisie avant une autre saisie.
saisies_inserer_apres()  : array<string|int, mixed>
Insère une saisie après une autre saisie.
saisies_inserer_selon_chemin()  : array<string|int, mixed>
Insère une saisie à une position donnée, en lui passant un chemin.
saisies_dupliquer()  : array<string|int, mixed>
Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.
saisies_deplacer()  : array<string|int, mixed>
Déplace une saisie existante autre part.
saisies_deplacer_avant()  : array<string|int, mixed>
Déplacer une saisie existante avant une autre
saisies_deplacer_apres()  : array<string|int, mixed>
Déplacer une saisie existante après une autre
saisies_modifier()  : array<string|int, mixed>
Modifie une saisie.
saisies_transformer_noms()  : array<string|int, mixed>
Transforme tous les noms du formulaire avec un preg_replace.
saisies_encapsuler_noms()  : array<string|int, mixed>
Transforme tous les noms en les encapsulant avec un préfixe.
saisies_transformer_option()  : array<string|int, mixed>
Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.
saisies_mapper_option()  : array<string|int, mixed>
Modifie toutes les options d'un certain nom, avec une fonction de rappel.
saisies_supprimer_option()  : array<string|int, mixed>
Supprime toutes les options d'un certain nom.
saisies_transformer_noms_auto()  : array<string|int, mixed>
Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.
saisies_inserer_html()  : array<string|int, mixed>
Insère du HTML au début ou à la fin d'une saisie.
saisies_fieldsets_en_onglets()  : array<string|int, mixed>
Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé
saisies_supprimer_sans_reponse()  : array<string|int, mixed>
Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides
saisies_migrer_afficher_si_remplissage()  : array<string|int, mixed>
Parcours un tableau de saisies, regarde si on a un champ afficher_si_remplissage et le transforme en champs afficher_si + afficher_si_remplissage_uniquement
construire_configuration_saisie()  : mixed
conteneur_inline_est_avec_sous_saisies()  : bool
Un conteneur_inline, c'est une saisie contenante
conteneur_inline_est_labelisable()  : bool
Un conteneur_inline, ca n'a pas de label
conteneur_inline_est_champ()  : bool
Un conteneur_inline, ca n'est pas un champ
explication_est_champ()  : bool
Une explication, ca n'est pas un champ
explication_get_label()  : string
Retourne le label de la saisie `explication` Par ordre de priorité le `titre` sinon le `texte`
fieldset_est_avec_sous_saisies()  : bool
Un fieldset, c'est une saisie contenante
fieldset_est_champ()  : bool
Un fieldset, ca n'est pas un champ
remplir_tableau_mime()  : array<string|int, mixed>
Remplit un tableau de description de types mime Sous la forme type_mime => 'Nom du type (extensions)'
verifier_afficher_si_dist()  : string
verifier_saisies_option_data_dist()  : string
Vérifier qu'une saisie est sous forme d'une chaine transformable en tableau de data C'est-à-dire de la forme cle|valeur Et ce en autorisant les sous-groupes (sauf si demande contraire) Mais en refusant les clés construite automatiquement pour des lignes sans pipe.
verifier_valeurs_acceptables_dist()  : string

Functions

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille()

Déclaration de la balise LISTER_VALEURS pour la saisie `choix_grille`

champs_extras_calculer_balise_LISTER_VALEURS_choix_grille(string $objet, string $colonne, string $cles) : array<string|int, mixed>|string
Parameters
$objet : string

Type d'objet

$colonne : string

Nom de la colonne SQL

$cles : string

Valeurs enregistrées pour ce champ dans la bdd pour l'objet en cours

Return values
array<string|int, mixed>|string

vide Tableau de type 'Clé de ligne|Valeur de ligne' => 'Ligne en valeur humaine|Valeur de ligne en humain'. Par ex 'Ligne1|Colonne1' => 'Ma première ligne|Ma première colonne'

champs_extras_serialiser_choix_grille()

Sérialise les réponses à un champ extra de type `choix_grille` pour encodage en base.

champs_extras_serialiser_choix_grille(array<string|int, mixed> $extra, array<string|int, mixed> $saisie) : string
Parameters
$extra : array<string|int, mixed>

La valeur reçue en POST

$saisie : array<string|int, mixed>

La description de la saisie

Return values
string

Forme serialisé, en l'occurence avec saisies_tableau2chaine

formulaires_configurer_saisies_saisies_dist()

Saisies du formulaire de configuration de saisies

formulaires_configurer_saisies_saisies_dist() : array<string|int, mixed>
Return values
array<string|int, mixed>

formulaires_construire_formulaire_charger()

Formulaire permettant de construire un formulaire ! En agençant des champs Chargement.

formulaires_construire_formulaire_charger(string $identifiant[, mixed $formulaire_initial = [] ][, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Parameters
$identifiant : string

identifiant unique du formulaire

$formulaire_initial : mixed = []
$options : array<string|int, mixed> = []

tableau d'options

  • array options_globales : proposer des options globales pour le formulaire, liste de ces options
  • array saisies_exclues : liste des saisies à ne pas proposer (= à exclure du choix)
  • bool uniquement_sql : ne proposer que les saisies qui permettent de remplir un champ sql
Return values
array<string|int, mixed>

$contexte

formulaires_construire_formulaire_verifier()

formulaires_construire_formulaire_verifier(mixed $identifiant[, mixed $formulaire_initial = [] ][, mixed $options = [] ]) : mixed
Parameters
$identifiant : mixed
$formulaire_initial : mixed = []
$options : mixed = []

formulaires_construire_formulaire_traiter()

formulaires_construire_formulaire_traiter(mixed $identifiant[, mixed $formulaire_initial = [] ][, mixed $options = [] ]) : mixed
Parameters
$identifiant : mixed
$formulaire_initial : mixed = []
$options : mixed = []

construire_formulaire_generer_saisie_configurable()

Préparer une saisie pour la transformer en truc configurable

construire_formulaire_generer_saisie_configurable(array<string|int, mixed> $saisie, array<string|int, mixed> $env) : string
Parameters
$saisie : array<string|int, mixed>

description de la saisie

$env : array<string|int, mixed>

environnement d'appel

Return values
string

fond du formulaire

saisies_groupe_inserer()

saisies_groupe_inserer(mixed $formulaire_actuel, mixed $saisie) : mixed
Parameters
$formulaire_actuel : mixed
$saisie : mixed

construire_formulaire_config_inserer_option_depublie()

Insérer dans le formulaire de config l'option pour dépublier une saisie

construire_formulaire_config_inserer_option_depublie(array<string|int, mixed> $saisies) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>
Return values
array<string|int, mixed>

formulaires_saisies_cvt_saisies_dist()

formulaires_saisies_cvt_saisies_dist() : mixed

formulaires_saisies_cvt_charger()

formulaires_saisies_cvt_charger() : mixed

saisie_editable()

Indique si une saisie peut être affichée.

saisie_editable(array<string|int, mixed> $champ, array<string|int, mixed> $env[, bool $utiliser_editable = true ]) : bool

On utilise en priorité l'option depublie. Si activée, la saisie n'est pas affichée sauf si valeur déjà présente.

Mais par compatibilité historique, on peut s'appuyer sur l'éventuelle clé "editable" du $champ. Si editable vaut :

  • absent : le champ est éditable
  • 1, le champ est éditable
  • 0, le champ n'est pas éditable
  • -1, le champ est éditable s'il y a du contenu dans le champ (l'environnement) ou dans un de ses enfants (fieldsets)
Parameters
$champ : array<string|int, mixed>

Tableau de description de la saisie

$env : array<string|int, mixed>

Environnement transmis à la saisie, certainement l'environnement du formulaire

$utiliser_editable : bool = true
  • false pour juste tester le cas -1
Return values
bool

Retourne un booléen indiquant l'état éditable ou pas :

  • true si la saisie est éditable (peut être affichée)
  • false sinon

saisies_generer_html()

Génère une saisie à partir d'un tableau la décrivant et de l'environnement.

saisies_generer_html(array<string|int, mixed> $champ[, array<string|int, mixed> $env = [] ]) : string
Parameters
$champ : array<string|int, mixed>

Description de la saisie. Le tableau doit être de la forme suivante : array( 'saisie' => 'input', 'options' => array( 'nom' => 'le_name', 'label' => 'Un titre plus joli', 'obligatoire' => 'oui', 'explication' => 'Remplissez ce champ en utilisant votre clavier.' ) )

$env : array<string|int, mixed> = []

Environnement du formulaire Permet de savoir les valeurs actuelles des contenus des saisies, les erreurs eventuelles présentes...

Return values
string

Code HTML des saisies de formulaire

saisies_generer_vue()

Génère une vue d'une saisie à partir d'un tableau la décrivant.

saisies_generer_vue(array<string|int, mixed> $saisie[, array<string|int, mixed> $env = [] ][, array<string|int, mixed> $env_obligatoire = [] ]) : string
Parameters
$saisie : array<string|int, mixed>

Tableau de description d'une saisie

$env : array<string|int, mixed> = []

L'environnement, contenant normalement la réponse à la saisie

$env_obligatoire : array<string|int, mixed> = []

Ce qui doit toujours être passé à l'environnement

Tags
see
saisies_generer_html()
Return values
string

Code HTML de la vue de la saisie

saisies_trouver_erreur()

Récupère l'erreur d'une saisie particulière au sein d'un tableau d'erreur

saisies_trouver_erreur(array<string|int, mixed>|null $erreurs, string $nom_ou_name) : string
Parameters
$erreurs : array<string|int, mixed>|null

Tableau d'erreurs, 3 formats possibles

    • Arborescents SPIP 'niveau1/niveau2/niveau3' => 'erreur'
    • Arborescents HTML 'niveau1[niveau2][niveau3]' => 'erreur'
    • Arborescents PHP ['niveau1' => ['niveau2' => 'niveau3' => 'erreur']]]
$nom_ou_name : string
Return values
string

saisies_saisie_est_tabulaire()

La saisie renvoie t-elle un tableau? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`selection` par ex.) peuvent, en fonction des options, être tabulaire ou pas.

saisies_saisie_est_tabulaire( $saisie) : return
Parameters
$saisie :
Return values
return

bool true si la saisie est tabulaire, false sinon

saisies_saisie_est_fichier()

La saisie remplie-t-elle `$_FILES` ? note: on teste saisie par saisie, et non pas type de saisie par type de saisie, car certains types (`input` par ex.) peuvent, en fonction des options, être fichier ou pas.

saisies_saisie_est_fichier(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

saisies_saisie_est_gelee()

Indique si une saisie à sa valeur gelée - soit par option disabled avec envoi cachée - soit par option readonly

saisies_saisie_est_gelee(array<string|int, mixed> $description) : bool
Parameters
$description : array<string|int, mixed>

description de la saisie

Return values
bool

true si gélée, false sinon)

saisies_verifier_gel_saisie()

saisies_verifier_gel_saisie(array<string|int, mixed> $description) : bool
Parameters
$description : array<string|int, mixed>
Tags
deprecated

saisies_verifier_gel_saisie Renommée en saisies_saisie_est_gelee

Return values
bool

saisies_saisie_est_avec_sous_saisies()

Renvoie true si la saisie est un conteneur de sous saisies, qu'elle contienne effectivement des sous saisies ou pas

saisies_saisie_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

saisies_saisie_est_labelisable()

Renvoie true si la saisie peut recevoir un label, qu'elle contienne effectivement un label ou pas

saisies_saisie_est_labelisable(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

saisies_saisie_est_champ()

Renvoie true si la saisie correspond à un champ au sens HTML

saisies_saisie_est_champ(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

saisies_saisie_get_label()

Renvoi le label de la saisie la plupart du temps c'est juste le champ label mais pour certaines saisies c'est autre chose

saisies_saisie_get_label(array<string|int, mixed> $saisie) : string
Parameters
$saisie : array<string|int, mixed>
Return values
string

saisies_lister_par_identifiant()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par identifiant unique.

saisies_lister_par_identifiant(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

$avec_conteneur : bool = true

Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldsets

Return values
array<string|int, mixed>

Un tableau avec uniquement les saisies

saisies_lister_par_nom()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par nom.

saisies_lister_par_nom(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

$avec_conteneur : bool = true

Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values
array<string|int, mixed>

Un tableau avec uniquement les saisies

saisies_lister_finales()

Liste les saisies en parcourant tous les niveau de la hiérarchie, et en excluant les saisies ayant des sous-saisies

saisies_lister_finales(array<string|int, mixed> $saisies) : liste
Parameters
$saisies : array<string|int, mixed>

Liste de saisies

Return values
liste

de ces saisies triées selon l'ordre de déclaration initiale

saisies_lister_avec_option()

Liste les saisies ayant une option X # saisies_lister_avec_option('sql', $saisies);.

saisies_lister_avec_option(string $option, array<string|int, mixed> $saisies[, string $tri = 'nom' ]) : liste
Parameters
$option : string

Nom de l'option cherchée

$saisies : array<string|int, mixed>

Liste de saisies

$tri : string = 'nom'

tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom', 'identifiant')

Return values
liste

de ces saisies triees par nom ayant une option X définie

saisies_lister_avec_sql()

Liste les saisies ayant une definition SQL.

saisies_lister_avec_sql(array<string|int, mixed> $saisies[, string $tri = 'nom' ]) : liste
Parameters
$saisies : array<string|int, mixed>

liste de saisies

$tri : string = 'nom'

tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom', 'identifiant')

Return values
liste

de ces saisies triees par nom ayant une option sql définie

saisies_lister_avec_type()

Liste les saisies d'un certain type.

saisies_lister_avec_type(array<string|int, mixed> $saisies, string|array<string|int, mixed> $type[, string $tri = 'nom' ][, mixed $avec_conteneur = false ]) : liste
Parameters
$saisies : array<string|int, mixed>

liste de saisies

$type : string|array<string|int, mixed>

Type de la saisie, ou tableau de types

$tri : string = 'nom'

tri par défaut des résultats (s'ils ne sont pas deja triés) ('nom')

$avec_conteneur : mixed = false
Tags
example

$saisies_date = saisies_lister_avec_type($saisies, 'date')

Return values
liste

de ces saisies triees par nom

saisies_lister_par_type()

Prend la description complète du contenu d'un formulaire et retourne les saisies "à plat" classées par type de saisie.

saisies_lister_par_type(array<string|int, mixed> $contenu) : array<string|int, mixed>

$saisie['input']['input_1'] = $saisie.

Attention : ne sont retournées que les saisies finales (qui ne contiennent pas de sous-saisies).

Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

Return values
array<string|int, mixed>

Un tableau avec uniquement les saisies

saisies_lister_par_etapes()

Liste les saisies par étapes s'il y en a

saisies_lister_par_etapes(array<string|int, mixed> $saisies[, bool $check_only = false ][, array<string|int, mixed>|null $env = [] ]) : array<string|int, mixed>|bool
Parameters
$saisies : array<string|int, mixed>

Liste des saisies

$check_only : bool = false

= false, si true, se contente de vérifier si on gère les étapes, mais ne construit pas le tableau d'étape

$env : array<string|int, mixed>|null = []
Return values
array<string|int, mixed>|bool

Retourne un tableau associatif par numéro d'étape avec pour chacune leurs saisies (ou bien true si check_only est à true), false si pas d'étapes Retourne un tableau associatif "etape_xxx" => "contenu de l'étape" avec pour chacune leurs saisies, false si pas d'étapes Ajoute si besoin une étape N+1 "Récapitulatif" Les noms des étapes sont automatiquement passés dans _T_ou_typo

saisies_lister_champs()

Prend la description complète du contenu d'un formulaire et retourne une liste des noms des champs du formulaire.

saisies_lister_champs(array<string|int, mixed> $contenu[, bool $avec_conteneur = true ]) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

$avec_conteneur : bool = true

Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values
array<string|int, mixed>

Un tableau listant les noms des champs

saisies_lister_labels()

Prend la description complète du contenu d'un formulaire et retourne une liste des labels humains des vrais champs du formulaire (par nom)

saisies_lister_labels(array<string|int, mixed> $contenu[, bool $avec_conteneur = false ]) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

$avec_conteneur : bool = false

Indique si on renvoie aussi les saisies ayant des enfants, comme les fieldset

Return values
array<string|int, mixed>

Un tableau listant les labels humains des champs

saisies_charger_champs()

A utiliser dans une fonction charger d'un formulaire CVT, cette fonction renvoie le tableau de contexte correspondant de la forme $contexte['nom_champ'] = ''.

saisies_charger_champs(array<string|int, mixed> $contenu) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire (un tableau de saisies)

Return values
array<string|int, mixed>

Un tableau de contexte

saisies_lister_valeurs_defaut()

Prend la description complète du contenu d'un formulaire et retourne une liste des valeurs par défaut des champs du formulaire.

saisies_lister_valeurs_defaut(array<string|int, mixed> $contenu) : array<string|int, mixed>
Parameters
$contenu : array<string|int, mixed>

Le contenu d'un formulaire

Return values
array<string|int, mixed>

Un tableau renvoyant la valeur par défaut de chaque champs

saisies_comparer()

Compare deux tableaux de saisies pour connaitre les différences.

saisies_comparer(array<string|int, mixed> $saisies_anciennes, array<string|int, mixed> $saisies_nouvelles[, bool $avec_conteneur = true ][, string $tri = 'nom' ]) : array<string|int, mixed>
Parameters
$saisies_anciennes : array<string|int, mixed>

Un tableau décrivant des saisies

$saisies_nouvelles : array<string|int, mixed>

Un autre tableau décrivant des saisies

$avec_conteneur : bool = true

Indique si on veut prendre en compte dans la comparaison les conteneurs comme les fieldsets

$tri : string = 'nom'

Comparer selon quel tri ? 'nom' / 'identifiant'

Return values
array<string|int, mixed>

Retourne le tableau des saisies supprimées, ajoutées et modifiées

saisies_comparer_rappel()

Compare deux saisies et indique si elles sont égales ou pas.

saisies_comparer_rappel(array<string|int, mixed> $a, array<string|int, mixed> $b) : int
Parameters
$a : array<string|int, mixed>

Une description de saisie

$b : array<string|int, mixed>

Une autre description de saisie

Return values
int

Retourne 0 si les saisies sont identiques, 1 sinon.

saisies_comparer_par_identifiant()

Compare deux tableaux de saisies pour connaitre les différences en s'appuyant sur les identifiants de saisies.

saisies_comparer_par_identifiant(array<string|int, mixed> $saisies_anciennes, array<string|int, mixed> $saisies_nouvelles[, bool $avec_conteneur = true ]) : array<string|int, mixed>
Parameters
$saisies_anciennes : array<string|int, mixed>

Un tableau décrivant des saisies

$saisies_nouvelles : array<string|int, mixed>

Un autre tableau décrivant des saisies

$avec_conteneur : bool = true

Indique si on veut prendre en compte dans la comparaison les conteneurs comme les fieldsets

Tags
see
saisies_comparer()
Return values
array<string|int, mixed>

Retourne le tableau des saisies supprimées, ajoutées et modifiées

saisies_autonomes()

Quelles sont les saisies qui se débrouillent toutes seules, sans le _base commun.

saisies_autonomes() : array<string|int, mixed>
Return values
array<string|int, mixed>

Retourne un tableau contenant les types de saisies qui ne doivent pas utiliser le _base.html commun

saisies_chercher()

Cherche une saisie par son id, son nom ou son chemin et renvoie soit la saisie, soit son chemin

saisies_chercher(array<string|int, mixed> $saisies, array<string|int, mixed>|string $id_ou_nom_ou_chemin[, bool $retourner_chemin = false ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : array<string|int, mixed>|string

L'identifiant ou le nom de la saisie à chercher ou le chemin sous forme d'une liste de clés

$retourner_chemin : bool = false

Indique si on retourne non pas la saisie mais son chemin

Return values
array<string|int, mixed>

Retourne soit la saisie, soit son chemin, soit null

saisies_lister_champs_par_section()

Prend un tableau de saisie retourne un tableau contenant uniquement les champs de saisie organisé par section (fieldset), avec pour chaque saisie le nom de la saisie en clé

saisies_lister_champs_par_section(array<string|int, mixed> $saisies[, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

le tableau de saisie

$options : array<string|int, mixed> = []

tableau d'options

  • string callback_section nom de la fonction de rappel sur les section, à défaut prend le nom ; exemple : 'saisies_saisie_get_label'
  • string callback_champ nom de la fonction de rappel sur les champ, à défaut renvoie la saisie complète ; exemple : 'saisies_saisie_get_label'
  • int profondeur_max_output indique sur combien de niveau doit être le tableau d'output, si pas défini / <= 0 , va jusqu'au bout de la hiérarchie, sinon ca aplatit les niveaux les plus profonds
  • bool sans_vide: si True, ne pas renvoyer les section vide
  • array|string forcer_type: liste de type à prendre, en excluant les autres
Return values
array<string|int, mixed>

saisies_lister_disponibles()

Liste toutes les saisies configurables (ayant une description).

saisies_lister_disponibles([string $saisies_repertoire = 'saisies' ][, bool $inclure_obsoletes = true ]) : array<string|int, mixed>
Parameters
$saisies_repertoire : string = 'saisies'

le répertoire où trouver les saisies

$inclure_obsoletes : bool = true

: faut-il inclure les saisies obsolètes ?

Return values
array<string|int, mixed>

Un tableau listant des saisies et leurs options

saisies_groupes_lister_disponibles()

Liste tous les groupes de saisies configurables (ayant une description).

saisies_groupes_lister_disponibles([mixed $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>
Parameters
$saisies_repertoire : mixed = 'saisies'
Return values
array<string|int, mixed>

Un tableau listant des saisies et leurs options

saisies_lister_disponibles_sql()

Lister les saisies existantes ayant une définition SQL.

saisies_lister_disponibles_sql([string $saisies_repertoire = 'saisies' ][, bool $inclure_obsoletes = true ]) : array<string|int, mixed>
Parameters
$saisies_repertoire : string = 'saisies'

le répertoire où trouver les saisies

$inclure_obsoletes : bool = true

: faut-il inclure les saisies obsolètes ?

Return values
array<string|int, mixed>

Un tableau listant des saisies et leurs options

saisies_charger_infos()

Charger les informations contenues dans le YAML d'une saisie.

saisies_charger_infos(string $type_saisie[, mixed $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>
Parameters
$type_saisie : string

Le type de la saisie

$saisies_repertoire : mixed = 'saisies'
Return values
array<string|int, mixed>

Un tableau contenant le YAML décodé

saisies_recuperer_heritage()

Permet à une saisie d'hériter des options et valeur par défaut d'une autre saisies

saisies_recuperer_heritage(string $saisie[, string $saisies_repertoire = 'saisies' ]) : array<string|int, mixed>
Parameters
$saisie : string

la saisie

$saisies_repertoire : string = 'saisies'

= 'saisies'

Return values
array<string|int, mixed>

saisies_lister_categories()

Lister les catégories par défaut, puis les envoyer au pipeline

saisies_lister_categories() : array<string|int, mixed>
Return values
array<string|int, mixed>

liste des catégories

saisies_lister_disponibles_par_categories()

Lister les saisies disponibles en les regroupant en catégories

saisies_lister_disponibles_par_categories([array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Parameters
$options : array<string|int, mixed> = []

'saisies_repertoire' => string ('saisies') 'inclure_obsoletes' => bool (false) 'categorie' => string|null|false (false) 'uniquement_sql' => bool (false) pour limiter à celle avec sql

Return values
array<string|int, mixed>

saisies_lister_disponibles_sql_par_categories()

Liste par catégorie les saisies disponibles ayant une définition SQL

saisies_lister_disponibles_sql_par_categories([array<string|int, mixed> $options = [] ]) : mixed
Parameters
$options : array<string|int, mixed> = []

voir saisies_lister_disponibles_par_categories return array

saisies_regrouper_disponibles_par_categories()

Regroupe par categories les saisies

saisies_regrouper_disponibles_par_categories([array<string|int, mixed> $saisies = [] ][, string|null $categorie_demande = null ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed> = []
$categorie_demande : string|null = null

pour ne renvoyer que cette catégorie

Return values
array<string|int, mixed>

saisies_lister_disponibles_par_categories_usort()

Function de comparaison pour trier les saisies disponibles par rang Si pas de rang défini, on met après ceux avec rang Si deux saisies avec le même rang, on se rabat sur l'ordre alpha

saisies_lister_disponibles_par_categories_usort( $saisie1,  $saisie2) : int
Parameters
$saisie1 :
$saisie2 :
Return values
int

saisies_supprimer()

Supprimer une saisie dont on donne l'identifiant, le nom ou le chemin.

saisies_supprimer(array<string|int, mixed> $saisies, string|array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$id_ou_nom_ou_chemin : string|array<string|int, mixed>

L'identifiant unique ou le nom de la saisie à supprimer ou son chemin sous forme d'une liste de clés

Return values
array<string|int, mixed>

Tableau modifié décrivant les saisies

saisies_inserer()

Insère une saisie à une position donnée dans un tableau de donnée - soit en lui passant un chemin - soit en lui passant une saisie devant laquelle se placer

saisies_inserer(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed>|string $id_ou_nom_ou_chemin = [] ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$id_ou_nom_ou_chemin : array<string|int, mixed>|string = []
  • Si array c'est un chemin Position complète où insérer la saisie - Si directement à la racine du tableau : array(<index_où_inserer>) - Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>)
  • Si string
    • Si entre crochets, ca veut dire qu'on insère à la fin d'un fieldset [fieldset]
    • Si entre crochets, suivis d'un entier entre crochet, on insère à une position données dans le fieldset [fieldset][0]
    • Si pas de crochet, on insère avant la saisie saisie
  • En absence, insère la saisie à la fin.
Return values
array<string|int, mixed>

Tableau des saisies complété de la saisie insérée

saisies_inserer_avant()

Insère une saisie avant une autre saisie.

saisies_inserer_avant(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$id_ou_nom_ou_chemin : array<string|int, mixed>

identifiant ou nom ou chemin de la saisie devant laquelle inserer

Return values
array<string|int, mixed>

Tableau des saisies complété de la saisie insérée

saisies_inserer_apres()

Insère une saisie après une autre saisie.

saisies_inserer_apres(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie, array<string|int, mixed> $id_ou_nom_ou_chemin) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$id_ou_nom_ou_chemin : array<string|int, mixed>

identifiant ou nom ou chemin de la saisie devant laquelle inserer

Return values
array<string|int, mixed>

Tableau des saisies complété de la saisie insérée

saisies_inserer_selon_chemin()

Insère une saisie à une position donnée, en lui passant un chemin.

saisies_inserer_selon_chemin(array<string|int, mixed> $saisies, array<string|int, mixed> $saisie[, array<string|int, mixed> $chemin = [] ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau des descriptions de saisies

$saisie : array<string|int, mixed>

Description de la saisie à insérer

$chemin : array<string|int, mixed> = []

Position complète où insérer la saisie

  • Si directement à la racine du tableau : array(<index_où_inserer>)
  • Si au sein d'un fieldset ou assimilé : array(<index_du _fieldset>, 'saisies', <index_où_inserer_au_sein_du_fieldset>) En absence, insère la saisie à la fin.
Return values
array<string|int, mixed>

Tableau des saisies complété de la saisie insérée

saisies_dupliquer()

Duplique une saisie (ou groupe de saisies) en placant la copie à la suite de la saisie d'origine.

saisies_dupliquer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin) : array<string|int, mixed>

Modifie automatiquement les identifiants des saisies.

Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : unknown_type

L'identifiant unique ou le nom ou le chemin de la saisie a dupliquer

Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_deplacer()

Déplace une saisie existante autre part.

saisies_deplacer(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou[, string $avant_ou_apres = 'avant' ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : unknown_type

L'identifiant unique ou le nom ou le chemin de la saisie à déplacer

$ou : string
  • Le nom de la saisie devant laquelle on déplacera
  • OU le nom d'un conteneur entre crochets [conteneur] (et dans ce cas on déplace à la fin de conteneur)
  • OU le nom d'un conteneur entre crochets suivi d'un identifiant numérique entre crochets [conteneur][x] (et dans ce cas on déplace à la position x au sein du conteneur)
$avant_ou_apres : string = 'avant'

(optionel) : valeur possible : 'avant' ou 'apres', pour inserer respectivent avant/après la saisie $ou

Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_deplacer_avant()

Déplacer une saisie existante avant une autre

saisies_deplacer_avant(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : unknown_type

L'identifiant unique ou le nom ou le chemin de la saisie à déplacer

$ou : string

la saisie devant laquelle déplacer

Tags
use

saisie_deplacer()

Return values
array<string|int, mixed>

$string

saisies_deplacer_apres()

Déplacer une saisie existante après une autre

saisies_deplacer_apres(array<string|int, mixed> $saisies, unknown_type $id_ou_nom_ou_chemin, string $ou) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : unknown_type

L'identifiant unique ou le nom ou le chemin de la saisie à déplacer

$ou : string

la saisie devant laquelle déplacer

Tags
use

saisie_deplacer()

Return values
array<string|int, mixed>

$string

saisies_modifier()

Modifie une saisie.

saisies_modifier(array<string|int, mixed> $saisies, array<string|int, mixed>|string $id_ou_nom_ou_chemin, array<string|int, mixed> $modifs[, bool $fusion = false ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$id_ou_nom_ou_chemin : array<string|int, mixed>|string

L'identifiant unique ou le nom ou le chemin de la saisie à modifier

$modifs : array<string|int, mixed>

Le tableau des modifications à apporter à la saisie

$fusion : bool = false

True si on veut simplifier rajouter des choses, sans tout remplacer

Return values
array<string|int, mixed>

Retourne le tableau décrivant les saisies, mais modifié

saisies_transformer_noms()

Transforme tous les noms du formulaire avec un preg_replace.

saisies_transformer_noms(array<string|int, mixed> $saisies, string $masque, string $remplacement) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$masque : string

Ce que l'on doit chercher dans le nom

$remplacement : string

Ce par quoi on doit remplacer

Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_encapsuler_noms()

Transforme tous les noms en les encapsulant avec un préfixe.

saisies_encapsuler_noms(array<string|int, mixed> $saisies, string $prefixe[, bool $recursif = true ]) : array<string|int, mixed>

Cela permet d'avoir toutes les valeurs postées dans un unique tableau. Après transformation, on pourra faire _request(<prefixe>) pour les récupérer.

Utilisation possible : on mélange les saisies de plusieurs formulaires, et on a dans ce cas besoin de cloisonner les valeurs.

Parameters
$saisies : array<string|int, mixed>

Un tableau décrivant les saisies

$prefixe : string

Préfixe

$recursif : bool = true

Pour procéder récursivement dans les fieldsets

Tags
example

Avant/après

  • bidule → prefixe[bidule]
  • machin[chose] → prefixe[machin][chose]
Return values
array<string|int, mixed>

saisies_transformer_option()

Transforme toutes les options textuelles d'un certain nom, avec un preg_replace.

saisies_transformer_option( $saisies,  $option,  $masque,  $remplacement[, bool $recursif = true ]) : array<string|int, mixed>
Parameters
$saisies :

Tableau décrivant les saisies

$option :

Nom de l'option à transformer (par ex "nom", ou "afficher_si"), ou tableau Note : si l'option n'existe pas, elle est automatiquement mise à '' avant toute transformation

$masque :

Ce que l'on doit chercher dans le texte

$remplacement :

Ce par quoi on doit remplacer

$recursif : bool = true
Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_mapper_option()

Modifie toutes les options d'un certain nom, avec une fonction de rappel.

saisies_mapper_option(array<string|int, mixed> $saisies, string|array<string|int, mixed> $options, string $callback[, array<string|int, mixed> $args = [] ][, mixed $recursif = true ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Tableau décrivant les saisies

$options : string|array<string|int, mixed>

Nom de l'option à transformer (par ex "nom", ou "afficher_si") Ou tableau de noms Note : si l'option n'existe pas, elle est automatiquement mise à '' avant toute transformation

$callback : string

Nom de la fonction à appliquer

$args : array<string|int, mixed> = []

Arguments de la fonction de rappel La valeur de l'option est passée automatiquement en premier

$recursif : mixed = true
Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_supprimer_option()

Supprime toutes les options d'un certain nom.

saisies_supprimer_option( $saisies,  $option[, bool $recursif = true ]) : array<string|int, mixed>
Parameters
$saisies :

Tableau décrivant les saisies

$option :

Nom de l'option à supprimer (par ex "nom", ou "afficher_si")

$recursif : bool = true
Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_transformer_noms_auto()

Transforme les noms d'une liste de saisies pour qu'ils soient uniques dans le formulaire donné.

saisies_transformer_noms_auto(array<string|int, mixed> $formulaire, array<string|int, mixed> $saisies) : array<string|int, mixed>
Parameters
$formulaire : array<string|int, mixed>

Le formulaire à analyser

$saisies : array<string|int, mixed>

Un tableau décrivant les saisies.

Return values
array<string|int, mixed>

Retourne le tableau modifié des saisies

saisies_inserer_html()

Insère du HTML au début ou à la fin d'une saisie.

saisies_inserer_html(array<string|int, mixed> $saisie, string $insertion[, string $ou = 'fin' ]) : array<string|int, mixed>
Parameters
$saisie : array<string|int, mixed>

La description d'une seule saisie

$insertion : string

Du code HTML à insérer dans la saisie

$ou : string = 'fin'

L'endroit où insérer le HTML : "debut" ou "fin"

Return values
array<string|int, mixed>

Retourne la description de la saisie modifiée

saisies_fieldsets_en_onglets()

Ajoute l'option onglet aux fieldset de premier niveau dans un tableau de $saisie Ajoute également un identifiant unique, éventuellement préfixé

saisies_fieldsets_en_onglets(array<string|int, mixed> $saisies[, string $identifiant_prefixe = '' ][, bool $vertical = false ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>
$identifiant_prefixe : string = ''
$vertical : bool = false
Return values
array<string|int, mixed>

$saisies modifiées

saisies_supprimer_sans_reponse()

Prend un tableau de saisies Enlève les saisies qui n'ont rien dans _request Ou dont l'ensemble des sous-saisies sont vides

saisies_supprimer_sans_reponse(array<string|int, mixed> $saisies[, optional $tableau = [] ]) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>
$tableau : optional = []

(tableau pour chercher dans request)

Return values
array<string|int, mixed>

saisies_migrer_afficher_si_remplissage()

Parcours un tableau de saisies, regarde si on a un champ afficher_si_remplissage et le transforme en champs afficher_si + afficher_si_remplissage_uniquement

saisies_migrer_afficher_si_remplissage(array<string|int, mixed> $saisies) : array<string|int, mixed>
Parameters
$saisies : array<string|int, mixed>

Les saisies initiales

Return values
array<string|int, mixed>

$saisies Les saisies modifiées

construire_configuration_saisie()

construire_configuration_saisie(mixed $saisie[, mixed $avec_nom = 'non' ]) : mixed
Parameters
$saisie : mixed
$avec_nom : mixed = 'non'

conteneur_inline_est_avec_sous_saisies()

Un conteneur_inline, c'est une saisie contenante

conteneur_inline_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

true

conteneur_inline_est_labelisable()

Un conteneur_inline, ca n'a pas de label

conteneur_inline_est_labelisable(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

false

conteneur_inline_est_champ()

Un conteneur_inline, ca n'est pas un champ

conteneur_inline_est_champ(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

false

explication_est_champ()

Une explication, ca n'est pas un champ

explication_est_champ(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

false

explication_get_label()

Retourne le label de la saisie `explication` Par ordre de priorité le `titre` sinon le `texte`

explication_get_label(array<string|int, mixed> $saisie) : string
Parameters
$saisie : array<string|int, mixed>
Return values
string

fieldset_est_avec_sous_saisies()

Un fieldset, c'est une saisie contenante

fieldset_est_avec_sous_saisies(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

true

fieldset_est_champ()

Un fieldset, ca n'est pas un champ

fieldset_est_champ(array<string|int, mixed> $saisie) : bool
Parameters
$saisie : array<string|int, mixed>
Return values
bool

false

remplir_tableau_mime()

Remplit un tableau de description de types mime Sous la forme type_mime => 'Nom du type (extensions)'

remplir_tableau_mime(array<string|int, mixed> $tableau, string $mime, string $titre, string $extension) : array<string|int, mixed>
Parameters
$tableau : array<string|int, mixed>

le tableau en l'état actuel

$mime : string

le type mime qu'on veut mettre à jour

$titre : string

le titre associé au type mime

$extension : string

une extension associé au type mime

Return values
array<string|int, mixed>

le tableau modifié

verifier_afficher_si_dist()

verifier_afficher_si_dist(string $valeur) : string
Parameters
$valeur : string

La valeur à vérifier.

Return values
string

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.

verifier_saisies_option_data_dist()

Vérifier qu'une saisie est sous forme d'une chaine transformable en tableau de data C'est-à-dire de la forme cle|valeur Et ce en autorisant les sous-groupes (sauf si demande contraire) Mais en refusant les clés construite automatiquement pour des lignes sans pipe.

verifier_saisies_option_data_dist(string $valeur[,  $options = [] ]) : string

On en profite pour vérifier qu'il n'y pas de clé en double. De plus les trim() pertubent les choses.

Parameters
$valeur : string

La valeur à vérifier.

$options : = []

interdire_sous_groupes => True|False verifier_cles => array décrivant une vérification à effectuer

Return values
string

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.

verifier_valeurs_acceptables_dist()

verifier_valeurs_acceptables_dist(string $valeur, array<string|int, mixed> $options) : string
Parameters
$valeur : string

La valeur à vérifier.

$options : array<string|int, mixed>

les options de vérification

Return values
string

Retourne une chaine vide si c'est valide, sinon une chaine expliquant l'erreur.


        
On this page

Search results