Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...

When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store

Example that implements inclued into an application

This example demonstrates the process of implementing inclued into an existing application, and viewing the results.

Example #1 Getting the data within the PHP application itself (function)

// File to store the inclued information
$fp fopen('/tmp/wp.ser''w');
if (
$fp) {
$clue inclued_get_data();
    if (
$clue) {

Now that some data exists, it's time to make sense of it in the form of a graph. The inclued extension includes a PHP file named gengraph.php that creates a dot file that requires the » graphviz library. However, this form is not required.

Example #2 Example use of gengraph.php

This example creates an image named inclued.png that shows the inclued data.

# First, create the dot file
$ php gengraph.php -i /tmp/wp.ser -o

# Next, create the image
$ dot -Tpng -o inclued.png

Example #3 Listing data via inclued dumps (configuration)

When using the inclued.dumpdir directive, files (include clues) are dumped with every request. Here's one way to list those files, and unserialize() them.

if (
$path && is_dir($path)) {

"Path: $path"PHP_EOL;

$inclues = new GlobIterator($path DIRECTORY_SEPARATOR 'inclued*');

    if (
$inclues->count() === 0) {
'No clues today'PHP_EOL;

    foreach (
$inclues as $inclue) {

'Inclued file: '$inclue->getFilename(), PHP_EOL;

$data file_get_contents($inclue->getPathname());
        if (
$data) {
$inc unserialize($data);
' -- filename: '$inc['request']['SCRIPT_FILENAME'], PHP_EOL;
' -- number of includes: 'count($inc['includes']), PHP_EOL;
} else {
'I am totally clueless today.'PHP_EOL;

The above example will output something similar to:

PATH: /tmp/inclued
Inclued file: inclued.56521.1
 -- filename: /Users/philip/test.php
 -- number of includes: 1

Inclued file: inclued.56563.1
 -- filename: /tmp/none.php
 -- number of includes: 0

Inclued file: inclued.56636.1
 -- filename: /tmp/three.php
 -- number of includes: 3

PHP Manual