---
name: "Apache::Include"
section: "3pm"
platform: "linux"
package: "libapache-mod-perl"
version: "1.29.0.4-4.1+etch1"
release: "Debian 4.0 (Etch)"
platforms: ["linux"]
url: "https://new.carta.tech/Apache::Include"
---

# Apache::Include(3pm)

Utilities for mod\_perl/mod\_include integration

## NAME

Apache::Include - Utilities for mod\_perl/mod\_include integration

## SYNOPSIS

```
 <!--#perl sub="Apache::Include" arg="/perl/ssi.pl" -->
```

## DESCRIPTION

The **Apache::Include** module provides a handler, making it simple to include Apache::Registry scripts with the mod\_include perl directive.

Apache::Registry scripts can also be used in mod\_include parsed documents using 'virtual include'.

## METHODS

- Apache::Include-\>virtual($uri)

  The `"virtual"` method may be called to include the output of a given uri in your Perl scripts.  Example:

  ```
   use Apache::Include ();
  ```

  ```
   print "Content-type: text/html\n\n";
  ```

  ```
   print "before include\n";
  ```

  ```
   my $uri = "/perl/env.pl";
  ```

  ```
   Apache::Include->virtual($uri);
  ```

  ```
   print "after include\n";
  ```

## SEE ALSO

[*perl*(1)](/perl/1.md), *mod\_perl*(3), mod\_include

## AUTHOR

Doug MacEachern