Informations sur un fichier

Cet article est incomplet. Son contenu est donc à considérer avec précaution. Voir la liste des articles incomplets

Pour obtenir des informations sur un fichiers, le format des informations remontées respectent le plus possible les recommandations de freedesktop.org

Le chemin complet de la fonctionnalité FileInfos Documentation du parent Pas de parent Module LibFileManagement version du module 0.2.3

Voir toutes les fonctionnalités

getDescription

Méthode commune à toutes les librairies pour obtenir la description de l'objet partagé.

$instance = bab_functionality::get('FileInfos');

$description = $instance->getDescription();

getMimeTypeFromFile

Cette méthode essai d'évaluer le type mime d'un fichier en utilisant l'extension php fileinfo ou la commande file du système, si aucune de ces deux méthode n'est disponible, le type mime sera évalué a partir de l'extension du fichier.

Si le fichier est en lecture seule la méthode retourne false

getMimeTypeFromExtension

Cette méthode essai d'évaluer le type mime à partir de l'extension. La liste des types mime utilisée est celle du noyau d'Ovidentia

getFileTypeFromMimeType

Cette méthode retourne une description du type de fichier en fonction du type mime.

Les langues supportées sont :

• Anglais
• Français

getMetadata

Obtenir les métadonnés d'un fichier.

la méthode retourne un tableau contenant les métadonnés en respectant les recommandations : [1]

types de fichiers supportés

• Document HTML
• Document PDF (avec l'exécutable pdfinfo)
• Document ODT
• Image jpeg (avec le module de php exif)
• Fichier mp3 (avec le module de php id3)
• Vidéo WMV, AVI, MPG, MOV, MP4 (avec le module de php ffmpeg)

Objets

Container des espaces de noms

La méthode getMetadata() retourne un objet lfm_MetaNamespaces qui permet d'obtenir les espaces de noms utilisables pour le fichier passé en paramètre à getMetadata().

Les méthodes utilisables sur cet objet sont :

• getAllNs() retourne un tableau contenant les espaces de noms
• getFilePath() retourne l'emplacement du fichier

Les propriétés utilisables sur cet objet sont les espaces de noms autorisés sur le fichier, par exemple Doc, Audio, Image, File.

Exceptions

Lorsque une métadonné n'est pas supporté car le type de fichier est incompatible ou que l'outil externe nécessaire n'est pas présent, une exception lfm_MetadataException est levée.

Exemples

Obtenir le titre d'un document :

<source lang="php"> $meta = $fileinfo->getMetadata('fichier'); try { echo $meta->Doc->Title; } catch(lfm_MetadataException $e) { echo 'non supporté par le système'; } </source>

Obtenir toutes les metadonnés d'un fichier :

<source lang="php">

$m = $fileinfo->getMetadata('fichier');

foreach($m->getAllNs() as $ns) {

$meta = $m->$ns; foreach($meta->getAllMeta() as $name) {

echo $meta->getTitle($name); echo $meta->$name; } }

</source>

getGenericClassName

Obtenir un nom de classe générique pour un fichier. Un de ces noms sera retourné, il pourra être utilisé pour afficher une icône pour le fichier

1. mimetype-audio-x-generic
2. mimetype-image-x-generic
3. mimetype-package-x-generic
4. mimetype-text-x-generic
5. mimetype-video-x-generic
6. mimetype-x-office-document
7. mimetype-x-office-presentation
8. mimetype-x-office-spreadsheet
9. mimetype-unknown

Spécification des icones