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



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 the HTTP::Headers manpage 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

the HTTP::Headers manpage


AUTHOR

Simon Flack

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