NAME

Maypole::Headers - Convenience wrapper around HTTP::Headers

SYNOPSIS

    use Maypole::Headers;
    $r->headers_out(Maypole::Headers->new); # Note, automatic in Maypole
    $r->headers_out->set('Content-Base' => 'http://localhost/maypole');
    $r->headers_out->push('Set-Cookie' => $cookie->as_string);
    $r->headers_out->push('Set-Cookie' => $cookie2->as_string);
    print $r->headers_out->as_string;

DESCRIPTION

A convenience wrapper around "HTTP::Headers". Additional methods are provided to make the mutators less repetitive and wordy. For example:

    $r->headers_out->header(Content_Base => $r->config->uri_base);

can be written as:

    $r->headers_out->set(Content_Base => $r->config->uri_base);

METHODS

All the standard HTTP::Headers methods, plus the following:

get($header)

Get the value of a header field.

An alias to "HTTP::Headers->header"

set($header ="gt" $value, ...)

Set the value of one or more header fields

An alias to "HTTP::Headers->header"

push($header ="gt" $value)

Add a value to the field named $header. Previous values are maintained.

An alias to "HTTP::Headers->push_header"

add

Alias to "push" - useful for "Apache::Session::Wrapper" support, in CGI mode.

init($header ="gt" $value)

Set the value for the field named $header, but only if that header is currently undefined.

An alias to "HTTP::Headers->init_header"

remove($header, ...)

Remove one of more headers

An alias to "HTTP::Headers->remove_header"

field_names()

Returns a list of distinct header names

An alias to "HTTP::Headers->header_field_names"

SEE ALSO

HTTP::Headers

AUTHOR

Simon Flack