\filestorage_filesystem

Définition de la classe 'filestorage_filesystem'.

Cette classe est une classe de stockage spécifique aussi appelée plugin de stockage pour le système d'abstraction de stockage des fichiers. Le principe de ce plugin est de stocker tous les fichiers en renommant le fichier avec un UUID (identifiant unique) et en créant une arborescence à deux niveaux. Le premier est composé des deux premiers caractères de l'UUID du fichier et le second niveau des quatre premiers caractères de l'UUID du fichier. Un fichier avec l'extension .info permet de stocker les informations de base du fichier ainsi que des métadonnées.

Summary

Methods
Properties
Constants
create()
delete()
update()
update_metadata()
get()
create_temporary()
delete_temporary()
get_temporary()
getFilename_temporary()
getPath_temporary()
lock()
unlock()
getFilename()
getMimetype()
getPath()
getSize()
getInfo()
__construct()
$NO_UID
$NO_FILE
$NO_METADATA
$NO_FILEDATA
$NO_WRITE_RIGHT
$NO_ROOT_DIR
$SIZE_MISMATCH
$RAW_DATA_WRITE_ERR
$METADATA_WRITE_ERR
$SUCCESS
$MKDIR_ERR
$METADATA_MISSING
$ILLEGAL_CHANGE
$NO_CHANGE
$LOCK_FAILURE
$FILE_HANDLE_ERR
No constants found
getContent()
No protected properties found
N/A
addToLog()
getDirPathForUid()
getMetadata()
getMetadataStr()
rmdirLevel()
writeFile()
arraysEqual()
generate_uuid()
No private properties found
N/A

Properties

$NO_UID

$NO_UID : string

Message à destination des logs.

Type

string

$NO_FILE

$NO_FILE : string

Message à destination des logs.

Type

string

$NO_METADATA

$NO_METADATA : string

Message à destination des logs.

Type

string

$NO_FILEDATA

$NO_FILEDATA : string

Message à destination des logs.

Type

string

$NO_WRITE_RIGHT

$NO_WRITE_RIGHT : string

Message à destination des logs.

Type

string

$NO_ROOT_DIR

$NO_ROOT_DIR : string

Message à destination des logs.

Type

string

$SIZE_MISMATCH

$SIZE_MISMATCH : string

Message à destination des logs.

Type

string

$RAW_DATA_WRITE_ERR

$RAW_DATA_WRITE_ERR : string

Message à destination des logs.

Type

string

$METADATA_WRITE_ERR

$METADATA_WRITE_ERR : string

Message à destination des logs.

Type

string

$SUCCESS

$SUCCESS : string

Message à destination des logs.

Type

string

$MKDIR_ERR

$MKDIR_ERR : string

Message à destination des logs.

Type

string

$METADATA_MISSING

$METADATA_MISSING : string

Message à destination des logs.

Type

string

$ILLEGAL_CHANGE

$ILLEGAL_CHANGE : string

Message à destination des logs.

Type

string

$NO_CHANGE

$NO_CHANGE : string

Message à destination des logs.

Type

string

$LOCK_FAILURE

$LOCK_FAILURE : string

Message à destination des logs.

Type

string

$FILE_HANDLE_ERR

$FILE_HANDLE_ERR : string

Message à destination des logs.

Type

string

Methods

create()

create(string  $data, mixed  $metadata, string  $mode = "from_content") : string

Cette fonction permet de sauvegarder le fichier contenant les donnees, ainsi que le fichier contenant les métadonnées du fichier precedement cité.

Parameters

string $data

Le contenu de fichier

mixed $metadata

Les metadata du fichier à sauvegarder

string $mode

origine des données (content/temporary/path)

Returns

string —

En cas de succès on retourne l'uid du fichier. En cas d'erreur on retourne OP_FAILURE

delete()

delete(string  $uid) : string

Cette fonction permet de supprimer un ficher sauvegardé sur le filesystem.

Parameters

string $uid

L'identifiant du fichier

Returns

string —

En cas de succès on retourne l'identifiant du fichier qui était supprimé. Autrement on retourne OP_FAILURE

update()

update(string  $uid, string  $data, mixed  $metadata, string  $mode = "from_content") : \En

Cette fonction permet de modifier les données d'un fichier (données brutes et métadonnées).

Parameters

string $uid

L'identifiant du fichier a récupérer

string $data

Les données brutes.

mixed $metadata

Tableau contenant les métadonnées du fichier

string $mode

origine des données (content/temporary/path)

Returns

\En —

cas de succès on retourne l'uid du fichier. En cas d'échec on retourne OP_FAILURE

update_metadata()

update_metadata(string  $uid, array  $metadata) : mixed

Cette fonction permet de modifier les métadonnées d'un fichier.

Parameters

string $uid

Identifiant du fichier dans le filestorage.

array $metadata

Liste des métadonnées à mettre à jour.

Returns

mixed —

Identifiant du fichier ou OP_FAILURE.

get()

get(string  $uid) : \En

Cette fonction permet de récupérer les données d'un fichier (données brutes et métadonnées).

Parameters

string $uid

L'identifiant du fichier a récupérer

Returns

\En —

cas de succès on retourne les donnes du fichier. En cas d'échec on retourne null

create_temporary()

create_temporary(\[string]  $data, \[mixed]  $metadata, string  $mode) : \[string]

Créer un fichier temporaire sur le filesystem

Parameters

\[string] $data

contenu du fichier

\[mixed] $metadata

[tableau de méta données]

string $mode

origine des données (content/temporary/path)

Returns

\[string] —

uid

delete_temporary()

delete_temporary(\[string]  $uid) : \uid

Créer un fichier temporaire sur le filesystem

Parameters

\[string] $uid

uid du fichier

Returns

\uid

get_temporary()

get_temporary(\[string]  $uid) : null

Son but est de permettre l'extraction d'un fichier contenant les données, ainsi que l'extraction de contenu du fichier contenant les métadonnées

Parameters

\[string] $uid

uid du fichier

Returns

null

getFilename_temporary()

getFilename_temporary(string  $uid) : null

Cette fonction doit être implémente par des classes dérivées. Son but est de retourner le nom du fichier temporaire identifié par l'uid passe en paramétré.

Parameters

string $uid

L'identifiant du fichier

Returns

null

getPath_temporary()

getPath_temporary(string  $uid) : null

Cette fonction doit être implémente par des classes dérivées. Son but est de retourner le path du fichier temporaire identifié par l'uid passe en paramétré.

Parameters

string $uid

L'identifiant du fichier

Returns

null

lock()

lock(string  $uid) : string

Cette fonction permet de faire un lock sur un fichier. On peut créer le lock seulement si il n'y a aucun lock existant.

Parameters

string $uid

L'identifiant du fichier

Returns

string —

En cas de succès on retourne true. Autrement on retourne false.

unlock()

unlock(string  $uid) 

Cette fonction permet de lâcher le lock sur un fichier.

Parameters

string $uid

L'identifiant du fichier

getFilename()

getFilename(string  $uid) : \Le

Cette fonction retourne le nom de fichier qui est stocké sous l'uid passé en paramètre.

Parameters

string $uid

L'identifiant de fichier

Returns

\Le —

nom de fichier, si le fichier est trouvé, sinon on retourne null.

getMimetype()

getMimetype(string  $uid) : \Le

Cette fonction retourne le mime type de fichier qui est stocké sous l'uid passé en paramètre.

Parameters

string $uid

L'identifiant de fichier

Returns

\Le —

mime type de fichier, si le fichier est trouvé, sinon on retourne null.

getPath()

getPath(string  $uid) : \Le

Cette fonction retourne le path du fichier

Parameters

string $uid

L'identifiant du fichier

Returns

\Le —

path du fichier

getSize()

getSize(string  $uid) : \La

Cette fonction retourne la taille de fichier qui est stocké sous l'uid passé en paramètre.

Parameters

string $uid

L'identifiant de fichier

Returns

\La —

taille de fichier, si le fichier est trouvé, sinon on retourne null.

getInfo()

getInfo(string  $uid) : \La

Cette fonction retourne un tableau associatif qui contient le nom, le mime type et la taille de fichier qui est stocké sous l'uid passé en paramètre.

Parameters

string $uid

L'identifiant de fichier

Returns

\La —

taille de fichier, si le fichier est trouvé, ou OP_FAILURE si la classe de sauvegarde n'était pas instanciée

__construct()

__construct(array  $conf) : void

Constructeur.

Initialise le chemin racine de stockage des fichiers et le cré si il n'existe pas.

Parameters

array $conf

Tableau de configuration du storage : $conf = array( "path" => "../var/storage/", );

getContent()

getContent(string  $data, string  $mode) : mixed

Permet de recupérer le contenu et les métadonnées d'un fichier en fonction du mode passé en paramètre qui définira le type de la donnée.

Parameters

string $data

handle du fichier

string $mode

origine des données (content/temporary/path)

Returns

mixed —

Contenu du fichier

addToLog()

addToLog(string  $file, string  $msg, string  $func = "", string  $mode = EXTRA_VERBOSE_MODE) 

Cette fonction ajoute dans le log.

Parameters

string $file

Le nom de fichier, ou l'identifiant du fichier

string $msg

Le message a logger

string $func

Le nom de la fonction

string $mode

Mode du log.

getDirPathForUid()

getDirPathForUid(string  $uid) : \Le

Cette fonction retourne le répertoire qui stocke le fichier avec les données brutes, et le fichier avec les métadonnées. Quand un fichier qui sert comme lock est créé il est placé dans ce même répertoire

Parameters

string $uid

L'identifiant du fichier

Returns

\Le —

répertoire qui contient les fichiers. Si le chemin de racine de sauvegarde des fichiers n'est pas set, on retourne null.

getMetadata()

getMetadata(string  $uid) : mixed|null

Cette fonction extraire les métadonnées d'un fichier sauvegarde.

Parameters

string $uid

L'identifiant du fichier

Returns

mixed|null —

En cas de succès on retourne le tableau contenant les méthadones. En cas d'échec, on retourne null.

getMetadataStr()

getMetadataStr(  $metadata) : \La

Cette fonction retourne les metadonees représentées dans le format d'une chaîne des caractères.

Parameters

$metadata

Returns

\La —

chaîne des caractères contenant les métadonnées, ou null si les métadonnées n'existent pas.

rmdirLevel()

rmdirLevel(string  $path, string  $filename, integer  $level = 2) 

Cette fonction supprime les repertoires donne le numero des niveaux a supprimer.

Parameters

string $path

Le chemin a supprimer, entierement, ou subpartie

string $filename

L'identifiant du fichier à supprimer

integer $level

Le nombre des niveaux à supprimer

writeFile()

writeFile(string  $path, string  $filename, string  $file_content,   $size, boolean  $delete_on_error = true) 

Cette fonction permet d'ecrire un fichier.

Parameters

string $path

Le repertoire (chemin absolue) qui va contenir le fichier

string $filename

Le nom du fichier

string $file_content

Le contenu du fichier

$size
boolean $delete_on_error

Marqueur de suppression sur erreur.

arraysEqual()

arraysEqual(mixed  $arr0, mixed  $arr1) : \Si

Cette fonction compare deux tableaux pour vérifier s'ils contenait les données identiques

Parameters

mixed $arr0

Premier tableau a comparer

mixed $arr1

Deuxième tableau a comparer

Returns

\Si —

les tableau sont identiques on retourne true, autrement on retourne false

generate_uuid()

generate_uuid(string  $prefix = "") : \L'identifiant

Cette fonction génère l'identifiant unique utilisé dans la sauvegarde d'un fichier.

Parameters

string $prefix

La chaîne des caractères à utiliser pour générer l'identifiant

Returns

\L'identifiant —

du fichier