NAME¶

INHERITANCE¶

 MojoX::MIME::Types
   is a Mojo::Base

SYNOPSIS¶

  use MojoX::MIME::Types;
  # set in Mojolicious as default
  $app->types(MojoX::MIME::Types->new);
  app->types(MojoX::MIME::Types->new);   # ::Lite
  # basic interface translated into pure MIME::Types
  $types->type(foo => 'text/foo');
  say $types->type('foo');

DESCRIPTION¶

METHODS¶

Constructors¶

MojoX::MIME::Types->new(%options)

Create the 'type' handler for Mojolicious. When you do not specify your own MIME::Type object ($mime_type), it will be instantanted for you. You create one yourself when you would like to pass some parameter to the object constructor.

 -Option    --Default
  mime_types  <created internally>
  types       undef
    

  $app->types(MojoX::MIME::Types->new);
  # when you need to pass options to MIME::Types->new
  my $mt    = MIME::Types->new(%opts);
  my $types = MojoX::MIME::Types->new(mime_types => $mt);
  $app->types($types);

Attributes¶

$obj->mimeTypes()

Returns the internal mime types object.

$obj->types( [\%table] )

In Mojolicious::Types, this attribute exposes the internal administration of types, offering to change it with using a clean abstract interface. That interface mistake bites now we have more complex internals.

Avoid this method! The returned HASH is expensive to construct, changes passed via %table are ignored: MIME::Types is very complete!

Actions¶

$obj->detect( $accept, [$prio] )

Returns a list of filename extensions. The $accept header in HTTP can contain multiple types, with a priority indication ('q' attributes). The returned list contains a list with extensions, the extensions related to the highest priority type first. The $prio-flag is ignored. See MIME::Types::httpAccept().

This detect() function is not the correct approach for the Accept header: the "Accept" may contain wildcards ('*') in types for globbing, which does not produce extensions. Better use MIME::Types::httpAcceptBest() or MIME::Types::httpAcceptSelect().

example:

  my $exts = $types->detect('application/json;q=9');
  my $exts = $types->detect('text/html, application/json;q=9');
    

$obj->type( $ext, [$type|\@types] )

Returns the first type name for an extension $ext, unless you specify type names.

When a single $type or an ARRAY of @types are specified, the $self object is returned. Nothing is done with the provided info.

DETAILS¶

Why?¶

How to use with Mojolicious¶

  package MyApp;
  use Mojo::Base 'Mojolicious';
  sub startup {
     my $self = shift;
     ...
     $self->types(MojoX::MIME::Types->new);
  }

  my $mt    = MIME::Types->new(%opts);
  my $types = MojoX::MIME::Types->new(mime_types => $mt);
  $self->types($types);

  my $mt    = $app->types->mimeTypes;
  my $mime  = $mt->mimeTypeOf($filename);

How to use with Mojolicious::Lite¶

  app->types(MojoX::MIME::Types->new);
  my $types = app->types;

Differences with Mojolicious::Types¶

•

the tables maintained by MIME::Types are complete. So: there shouldn't be a need to add your own types, not via types(), not via type(). All attempts to add types are ignored; better remove them from your code.

•

This plugin understands the experimental flag 'x-' in types and handles casing issues.

•

Updates to the internal hash via types() are simply ignored, because it is expensive to implement (and won't add something new).

•

The detect() is implemented in a compatible way, but does not understand wildcards ('*'). You should use MIME::Types::httpAcceptBest() or MIME::Types::httpAcceptSelect() to replace this broken function.

SEE ALSO¶

LICENSE¶