Documentation du code de SPIP et de ses plugins

CVT Upload

cvtupload.php

Table of Contents

Constants

_CVTUPLOAD_AGE_MAX  = 6 * 3600
_CVTUPLOAD_MAX_FILES  = 200

Functions

cvtupload_formulaire_id()  : string
Calculer un uniqid du formulaire et de ses args pour ne pas se melanger les pinceaux entre plusieurs formulaires
cvtupload_chercher_fichiers()  : array<string|int, mixed>
Chercher si des champs fichiers ont été déclarés dans le fichier formulaires/xxx.php Sert de condition preliminaire pour les pipelines formulaire_charger, formulaire_verifier et formulaire_fond du plugin
cvtupload_generer_html()  : array<string|int, mixed>
Génére le HTML de chaque fichier déjà uploadé
cvtupload_generer_hidden()  : string
Return le hidden de chaque fichier déjà uploadé
cvtupload_deplacer_fichier()  : array<string|int, mixed>
Déplace un fichier uploadé dans un endroit temporaire et retourne des informations dessus.
cvtupload_modifier_files()  : void
Modifier $_FILES pour que le nom et le chemin du fichier temporaire correspondent à ceux qu'on a défini dans cvtupload_deplacer_fichier().
cvtupload_nettoyer_files_selon_erreurs()  : void
Nettoyer $_FILES pour effacer les entrées dont on a vérifié qu'elle ne répondaient pas à certains critères
cvt_upload_determiner_mime()  : string
Détermine un MIME lorsque les informations de PHP sont imprécises.
cvtupload_nettoyer_repertoire()  : void
Nettoyer un répertoire suivant l'age et le nombre de ses fichiers
cvtupload_vue_from_FILES()  : array<string|int, mixed>
Regarde le tableau des _FILES sous sa forme 'fichiers_1' => array( 'name' => array(0 =>), 'error' => array(0 =>), et renvoie une version utilisable pour afficher une vue 'fichiers_array( 0 => array( 'nom' => , 'extension' =>, 'vignette' =>, 'taille' => 'mime' => )

Constants

Functions

cvtupload_formulaire_id()

Calculer un uniqid du formulaire et de ses args pour ne pas se melanger les pinceaux entre plusieurs formulaires

cvtupload_formulaire_id( $form,  $args) : string
Parameters
$form :
$args :
Return values
string

cvtupload_chercher_fichiers()

Chercher si des champs fichiers ont été déclarés dans le fichier formulaires/xxx.php Sert de condition preliminaire pour les pipelines formulaire_charger, formulaire_verifier et formulaire_fond du plugin

cvtupload_chercher_fichiers(string $form, array<string|int, mixed> $args) : array<string|int, mixed>
Parameters
$form : string

le nom du formulaire

$args : array<string|int, mixed>
  • l'id de l'objet
Return values
array<string|int, mixed>

valeur(s) de l'attribut 'name' du ou des input de type file dans formulaires/xxx.html

cvtupload_generer_html()

Génére le HTML de chaque fichier déjà uploadé

cvtupload_generer_html([array<string|int, mixed> $infos_fichiers = null ]) : array<string|int, mixed>
Parameters
$infos_fichiers : array<string|int, mixed> = null

Tableau contenant les informations pour chaque champ de fichier

Return values
array<string|int, mixed>

Retourne un tableau avec pour chaque champ une clé contenant le HTML

cvtupload_generer_hidden()

Return le hidden de chaque fichier déjà uploadé

cvtupload_generer_hidden([array<string|int, mixed> $infos_fichiers = null ]) : string
Parameters
$infos_fichiers : array<string|int, mixed> = null

Tableau contenant les informations pour chaque champ de fichier

Return values
string

Retourne un tableau avec pour chaque champ une clé contenant le HTML

cvtupload_deplacer_fichier()

Déplace un fichier uploadé dans un endroit temporaire et retourne des informations dessus.

cvtupload_deplacer_fichier(array<string|int, mixed> $fichier, string $repertoire, string $form[, bool $deplacer = true ]) : array<string|int, mixed>
Parameters
$fichier : array<string|int, mixed>

Le morceau de $_FILES concernant le ou les fichiers

$repertoire : string

Chemin de destination des fichiers

$form : string

Formulaire d'où ça vient

$deplacer : bool = true

Mettre a False pour se contenter de copier

Return values
array<string|int, mixed>

Retourne un tableau d'informations sur le fichier ou un tableau de tableaux si plusieurs fichiers. Ce tableau est compatible avec l'action "ajouter_un_fichier" de SPIP.

cvtupload_modifier_files()

Modifier $_FILES pour que le nom et le chemin du fichier temporaire correspondent à ceux qu'on a défini dans cvtupload_deplacer_fichier().

cvtupload_modifier_files( $infos_fichiers) : void

Cela permet aux traitements ultérieurs de ne pas avoir à se préoccuper de l'emploi ou non de cvtupload.

Parameters
$infos_fichiers :

Information sur les fichiers tels que déplacés par cvtupload_deplacer_fichier()

cvtupload_nettoyer_files_selon_erreurs()

Nettoyer $_FILES pour effacer les entrées dont on a vérifié qu'elle ne répondaient pas à certains critères

cvtupload_nettoyer_files_selon_erreurs(string $champ, array<string|int, string>|string $erreurs) : void
Parameters
$champ : string

Le nom du champ concerné dans $_FILES

$erreurs : array<string|int, string>|string

Si un upload multiple, un tableau des $erreurs avec comme clés les numéros des fichiers à supprimer dans $_FILES[$champ] Si un upload unique, une chaîne, qui si non vide, indique qu'il faut effacer le $_FILE[$champ]

cvt_upload_determiner_mime()

Détermine un MIME lorsque les informations de PHP sont imprécises.

cvt_upload_determiner_mime(string $mime_suppose, string $extension) : string

Par exemple PHP considère qu'un fichier .tex est de MIME application/octet-stream Ce qui n'est absolument pas utilse

Parameters
$mime_suppose : string
$extension : string
Return values
string

$mime_trouve

cvtupload_nettoyer_repertoire()

Nettoyer un répertoire suivant l'age et le nombre de ses fichiers

cvtupload_nettoyer_repertoire(string $repertoire[, int $age_max = _CVTUPLOAD_AGE_MAX ][, int $max_files = _CVTUPLOAD_MAX_FILES ]) : void
Parameters
$repertoire : string

Répertoire à nettoyer

$age_max : int = _CVTUPLOAD_AGE_MAX

Age maxium des fichiers en seconde

$max_files : int = _CVTUPLOAD_MAX_FILES

Nombre maximum de fichiers dans le dossier

cvtupload_vue_from_FILES()

Regarde le tableau des _FILES sous sa forme 'fichiers_1' => array( 'name' => array(0 =>), 'error' => array(0 =>), et renvoie une version utilisable pour afficher une vue 'fichiers_array( 0 => array( 'nom' => , 'extension' =>, 'vignette' =>, 'taille' => 'mime' => )

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

        
On this page

Search results