Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages
Catalyst::Plugin::Params::Nested(3) User Contributed Perl Documentation Catalyst::Plugin::Params::Nested(3)

Catalyst::Plugin::Params::Nested - Nested form parameters (ala Ruby on Rails).

    use Catalyst qw/Params::Nested/;

    # using this html

    <form ...>
        <!-- can be with either subscripted or dot notation -->
        <input name="foo[bar]" ... />
        <input name="foo.gorch" ... />

    # turns params into hashrefs:


        # extra params
        foo => {
            bar => ...,
            gorch => ...

        # original params untouched
        'foo[bar]' => ...,
        'foo.gorch' => ...,

Ruby on Rails has a nice feature to create nested parameters that help with the organization of data in a form - parameters can be an arbitrarily deep nested structure.

The way this structure is denoted is that when you construct a form the field names have a special syntax which is parsed.

This plugin supports two syntaxes:

dot notation
    <input name="" />
subscript notation
    <input name="foo[bar][gorch]" />

When reading query parameters from "$c->req" you can now access the all the items starting with "foo" as one entity using "$c->req->param('foo');". Each subitem, denoted by either the dot or the square brackets, will be returned as a further deeper hashref.

Overrides "prepare_uploads" in Catalyst to expand the parameter data structure post factum.

No attempt is made to merge data intelligently. If you do this:

    <input name="foo" />
    <input name="" />

the "foo" parameter will stay untouched, and you'll have to access "" using its full string name:


Yuval Kogman, ""

Jess Robinson

        Copyright (c) 2005 the aforementioned authors. All rights
        reserved. This program is free software; you can redistribute
        it and/or modify it under the same terms as Perl itself.

2011-11-24 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.