Bernhard Graf > Mojolicious-Plugin-MethodOverride > Mojolicious::Plugin::MethodOverride

Download:
Mojolicious-Plugin-MethodOverride-0.070.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.070   Source  

NAME ^

Mojolicious::Plugin::MethodOverride - Simulate HTTP Verbs

VERSION ^

Version 0.070

SYNOPSIS ^

  package My::App;
  use Mojo::Base 'Mojolicious';

  sub startup {
    my $self = shift;

    $self->plugin(
      MethodOverride => {header => 'X-Tunneled-Method'}
    );

    ...
  }

  1;

DESCRIPTION ^

This plugin can simulate any HTTP verb (a.k.a. HTTP method) in environments where HTTP verbs other than GET and POST are not available. It uses the same approach as in many other restful web frameworks, where it replaces the HTTP POST method with a method given by an HTTP header.

Any token built of US-ASCII letters is accepted as a valid value for the HTTP verb.

Starting with v6.03 Mojolicious has a builtin parameter _method to override the HTTP method. Unfortunately there is neither a way to specify another name, nor to disable that feature.

CONFIGURATION ^

The default HTTP header to override the HTTP POST method is "X-HTTP-Method-Override".

These settings can be changed in the plugin method call as demonstrated in the examples below:

  # Mojolicious
  $self->plugin(MethodOverride => {header => 'X-Tunneled-Method'});

  # Mojolicious::Lite
  plugin 'MethodOverride', {header => 'X-HTTP-Method'};

Mojolicious < 6.03

Mojolicious Versions before 6.03 (down to Mojolicious 2.48) are supported by Mojolicious::Plugin::MethodOverride version 0.060.

AUTHOR ^

Bernhard Graf <graf at cpan.org>

BUGS ^

Please report any bugs or feature requests at https://github.com/augensalat/mojolicious-plugin-methodoverride/issues.

SEE ALSO ^

Plack::Middleware::MethodOverride, Catalyst::TraitFor::Request::REST::ForBrowsers, HTTP::Engine::Middleware::MethodOverride, http://code.google.com/apis/gdata/docs/2.0/basics.html

LICENSE AND COPYRIGHT ^

Copyright (C) 2012 - 2016 Bernhard Graf.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://dev.perl.org/licenses/ for more information.

syntax highlighting: