perl-LWP-MediaTypes

Ce module fournit des fonctions pour gérer les types de médias (également connus sous le nom de MIME) et les encodages. La correspondance des extensions de fichier vers les types de médias est définie par le fichier _media.types_. Si le fichier _~/.media.types_ existe, il est utilisé à la place. Pour la rétrocompatibilité, nous chercherons également _~/.mime.types_. Les fonctions suivantes sont exportées par défaut : * guess_media_type( $filename ) * guess_media_type( $uri ) * guess_media_type( $filename_or_object, $header_to_modify ) Cette fonction essaie de deviner le type de média et l'encodage d'un fichier ou d'objets qui prennent en charge une méthode 'path' ou 'filename', par ex. des objets URI ou File::Temp. Lorsqu'un objet ne prend en charge aucune des deux méthodes, il sera converti en chaîne pour déterminer le nom de fichier. Elle renvoie le content type, qui est une chaîne comme '"text/html"'. En contexte de tableau, elle renvoie également tous les content encodings appliqués (dans l'ordre utilisé pour encoder le fichier). Vous pouvez passer une référence d'objet URI au lieu du nom de fichier. Si le type ne peut pas être déduit en regardant le nom de fichier, alors guess_media_type() laissera l'opérateur Perl '-T' y jeter un œil. Si cela fonctionne (et que '-T' renvoie une valeur TRUE), nous renvoyons _text/plain_ comme type, sinon nous renvoyons _application/octet-stream_ comme type. Le second argument optionnel doit être une référence à un objet HTTP::Headers ou tout objet qui implémente la méthode $obj->header de manière similaire. Lorsqu'il est présent, les valeurs de 'Content-Type' et 'Content-Encoding' seront définies pour cet en-tête. * media_suffix( $type, ... ) Cette fonction renverra tous les suffixes qui peuvent être utilisés pour désigner le(s) type(s) de média spécifié(s). Les types génériques peuvent être utilisés. En contexte scalaire, elle renverra le premier suffixe trouvé. Exemples : @suffixes = media_suffix('image/*', 'audio/basic'); $suffix = media_suffix('text/html'); Les fonctions suivantes ne sont exportées que sur demande explicite : * add_type( $type, @exts ) Associe une liste d'extensions de fichier au type de média donné. Exemple : add_type("x-world/x-vrml" => qw(wrl vrml)); * add_encoding( $type, @ext ) Associe une liste d'extensions de fichier à un type d'encodage. Exemple : add_encoding("x-gzip" => "gz"); * read_media_types( @files ) Analyse des fichiers de types de médias et ajoute les correspondances de types trouvées. Exemple : read_media_types("conf/mime.types");