Apache2::FilterRec - Perl API for manipulating the Apache filter record

  use Apache2::Filter ();
  use Apache2::FilterRec ();

  my $frec = $filter->frec;
  print "filter name is:", $frec->name;

Apache2::FilterRec provides an access to the filter record structure.

The Apache2::FilterRec object is retrieved by calling frec() (C_frec_ in docs::2.0::api::Apache2::Filter):

  $frec = $filter->frec;

Apache2::FilterRec provides the following functions and/or methods:

The registered name for this filter

  $name = $frec->name();

obj: $frec ( Apache2::FilterRec object (docs::2.0::api::Apache2::FilterRec) )

ret: $name (string)

since: 2.0.00

mod_perl filters have four names:

  modperl_request_output
  modperl_request_input
  modperl_connection_output
  modperl_connection_input

You can see the names of the non-mod_perl filters as well. By calling $filter->next->frec->name (C_next_ in docs::2.0::api::Apache2::Filter) you can get the name of the next filter in the chain.

Example:

Let's print the name of the current and the filter that follows it:

  use Apache2::Filter ();
  use Apache2::FilterRec ();
  for my $frec ($filter->frec, $filter->next->frec) {
      print "Name: ", $frec->name;
  }

mod_perl 2.0 documentation (docs::2.0::index).

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.

The mod_perl development team and numerous contributors (about::contributors::people).