---
name: "HTML::Mason::PSGIHandler"
section: "3pm"
platform: "linux"
package: "libhtml-mason-psgihandler-perl"
version: "0.53-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Mason::PSGIHandler"
---

# HTML::Mason::PSGIHandler(3pm)

PSGI handler for HTML::Mason

## NAME

HTML::Mason::PSGIHandler - PSGI handler for HTML::Mason

## SYNOPSIS

```
  # app.psgi
  use HTML::Mason::PSGIHandler;
  my $h = HTML::Mason::PSGIHandler->new(
      comp_root => "/path/to/doc_root", # required
  );
  my $handler = sub {
      my $env = shift;
      $h->handle_psgi($env);
  };
```

## DESCRIPTION

HTML::Mason::PSGIHandler is a PSGI handler for HTML::Mason. It's based on HTML::Mason::CGIHandler and allows you to process Mason templates on any web servers that support PSGI.

## METHODS

## as\_psgi

This method returns a subroutine to be used as a PSGI application.

In other words, these are equivalent:

```
  my $app = sub {
    my $env = shift;
    $h->handle_psgi($env);
  };
  my $app = $h->as_psgi;
```

### new\_psgi

```
  mount '/foo' => HTML::Mason::PSGIHandler->new_psgi( ... );
```

This method combines `"new"` and `"as_psgi"` to immediately return a subroutine that can be used as a PSGI application.  It's useful for using inline with Plack::Builder.

## SUPPORT

- •

  Git Repository

  The latest code is available from the git repository at \<http://github.com/abh/HTML-Mason-PSGIHandler\>.

  To send patches, make a fork on github and send a pull request.

- •

  Bugs

  Please report bugs at \<http://github.com/abh/HTML-Mason-PSGIHandler/issues\>.

## AUTHORS

Ask Bjørn Hansen \<miyagawa@bulknews.net\>, Ricardo Signes \<rjbs@cpan.org\>, Tatsuhiko Miyagawa \<miyagawa@bulknews.net\>, Ruslan Zakirov \<ruz@bestpractical.com\>.

## LICENSE

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

## SEE ALSO

CGI::PSGI Plack PSGI HTML::Mason::CGIHandler