Documentation du code de SPIP et de ses plugins

Big Upload

Files
in package
uses LogTrait

Gestion des relations avec `$_FILES`

Tags
plugin

Bigup

copyright

2016

author

marcimat

licence

GNU/GPL

Table of Contents

Methods

contient()  : bool
Indique si ce chemin de fichier est présent pour ce champ dans $_FILES
contient_arborescence()  : bool
Recherche dans une arborescence de tableau (si elle existe) la valeur indiquée.
debug()  : mixed
error()  : mixed
extraire_fichiers_valides()  : array<string|int, mixed>
Extrait et enlève de `$_FILES` les fichiers reçus sans erreur et crée un tableau avec pour clé le champ d'origine du fichier
extraire_sous_chemins_fichiers()  : array<string|int, mixed>
Retourne l'écriture plate de l'arborescence d'un tableau
info()  : mixed
integrer_fichier()  : array<string|int, mixed>
Intégrer le fichier indiqué dans `$FILES`
lister_fichiers_par_champs()  : array<string|int, mixed>
Retourne un tableau avec pour clé le champ d'origine du fichier à partir des éléments présents dans $_FILES
log()  : mixed
Des logs
unset_table_valeur()  : mixed

Methods

contient()

Indique si ce chemin de fichier est présent pour ce champ dans $_FILES

public static contient(string $champ, string $chemin) : bool
Parameters
$champ : string

Valeur de l'attribut name du champ.

$chemin : string

Chemin du fichier dans le cache

Return values
bool

true si le fichier est présent, false sinon.

contient_arborescence()

Recherche dans une arborescence de tableau (si elle existe) la valeur indiquée.

public static contient_arborescence(array<string|int, mixed> $arborescence, string $tableau, string $valeur) : bool

Notamment peut servir à rechercher un chemin de fichier dans une sous clé de $_FILES lorsque [] était présent dans le nom du champ.

Les chaines vides dans le tableau d'arborescence transmis sont considérées comme pouvant être n'importe quel entier dans le tableau. Ie: si on a '', on recherchera dans $tableau[0] ou $tableau[1], etc. s'ils existent.

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

Tableau ['', 'truc'] si recherche du champ '[][truc]'

$tableau : string

Le tableau de recherche

$valeur : string

La valeur cherchée

Return values
bool

debug()

public static debug(mixed $quoi) : mixed
Parameters
$quoi : mixed

error()

public static error(mixed $quoi) : mixed
Parameters
$quoi : mixed

extraire_fichiers_valides()

Extrait et enlève de `$_FILES` les fichiers reçus sans erreur et crée un tableau avec pour clé le champ d'origine du fichier

public static extraire_fichiers_valides() : array<string|int, mixed>
Return values
array<string|int, mixed>

Tableau (champ => [description])

extraire_sous_chemins_fichiers()

Retourne l'écriture plate de l'arborescence d'un tableau

public static extraire_sous_chemins_fichiers(mixed $tableau) : array<string|int, mixed>
  • Phps a toutes les arborescences en conservant les index numériques autoincrémentés et en mettant les autres index entre guillements
  • Reels a toutes les arborescences en conservant les index numériques autoincrémentés
  • Names a les arborescences sans les index numériques
Parameters
$tableau : mixed
Return values
array<string|int, mixed>

Tableau [ phps => [], reels => [], names => []]

info()

public static info(mixed $quoi) : mixed
Parameters
$quoi : mixed

integrer_fichier()

Intégrer le fichier indiqué dans `$FILES`

public static integrer_fichier(string $champ, array<string|int, mixed> $description) : array<string|int, mixed>

Tout dépend de l'attribut name qui avait été posté.

Cette info doit se trouver dans le tableau reçu dans la clé 'champ'.

Avec i le nième fichier posté dans le champ, voici un exemple de ce qu'on peut obtenir. Noter la position de l'incrément i qui se trouve dans le premier crochet vide du name.

  • name='a' : FILES[a][name] = 'x'
  • name='a[]' : FILES[a][name][i] = 'x'
  • name='a[b]' : FILES[a][name][b] = 'x'
  • name='a[b][]' : FILES[a][name][b][i] = 'x'
  • name='a[][b][]' : FILES[a][i][name][b][0] = 'x'
Parameters
$champ : string

Valeur de l'attribut name du champ.

$description : array<string|int, mixed>

Description d'un fichier

Return values
array<string|int, mixed>

Description du fichier

lister_fichiers_par_champs()

Retourne un tableau avec pour clé le champ d'origine du fichier à partir des éléments présents dans $_FILES

public static lister_fichiers_par_champs() : array<string|int, mixed>
Return values
array<string|int, mixed>

Tableau (champ => [description])

log()

Des logs

public static log(mixed $quoi[, int $gravite = _LOG_INFO_IMPORTANTE ]) : mixed
Parameters
$quoi : mixed
$gravite : int = _LOG_INFO_IMPORTANTE

unset_table_valeur()

public static unset_table_valeur(mixed &$table, mixed $chemin) : mixed
Parameters
$table : mixed
$chemin : mixed

        
On this page

Search results