Skip to content

stechstudio/phpinfo

Repository files navigation

Pretty PHP Info

Latest Version on Packagist Total Downloads Software License Tests

A beautiful, searchable replacement for phpinfo(). Query PHP configuration programmatically or browse it in a modern UI with dark mode, instant search, and click-to-copy.

Requirements

  • PHP 8.3+
  • ext-dom

Installation

composer require stechstudio/phpinfo

Quickstart

The simplest way to use this package is the global prettyphpinfo() function — a drop-in replacement for phpinfo():

prettyphpinfo();

That's it. You'll get a pretty, searchable, dark-mode-ready page instead of the default phpinfo() output.

If you're not using a framework with Composer autoloading, you'll need to add require __DIR__ . '/vendor/autoload.php'; first.

phpinfo-screenshot

Just like the native phpinfo(), you can pass INFO_* constants to control which sections are displayed:

// Only show modules (excludes environment variables — useful for security)
prettyphpinfo(INFO_MODULES);

// Only general information
prettyphpinfo(INFO_GENERAL);

// Combine flags
prettyphpinfo(INFO_GENERAL | INFO_MODULES);

You can also use the class-based API directly:

STS\Phpinfo\Info::render();

Interact with phpinfo() configuration

If you're looking to directly inspect and interact with the configuration, capture it first:

use STS\Phpinfo\Info;

$info = Info::capture();

// Or capture a subset
$info = Info::capture(INFO_MODULES);

If you have phpinfo() output that you've saved previously and want to load and parse:

use STS\Phpinfo\Info;

// If you've saved the HTML output from phpinfo()
$info = Info::fromHtml($yourSavedHtmlOutput);

// If you've saved the CLI output from phpinfo()
$info = Info::fromText($yourSavedTextOutput);

// Or if you don't know the format, let the package detect it
$info = Info::detect($yourSavedOutput);

From here you can query base info, modules, and configs:

// Your PHP version
$info->version(); // "8.5.4"

// Check for the presence of a specific module. Name is case-insensitive.
$info->hasModule('redis'); // true

// Check to see if a specific configuration key is present.
$info->hasConfig('ICU version'); // true

// Retrieve the value for a specific configuration key. If there is both
// a local and master value, the local is returned by default.
$info->config('max_file_uploads'); // "20"

// Pass 'master' to get the php.ini default instead of the effective local value.
$info->config('max_file_uploads', 'master'); // "100"
$info->config('BCMath support', 'master'); // null

// Convenience methods for common lookups
$info->os(); // "Linux"
$info->hostname(); // "my-server"

Iterating over data structure

You can iterate over the full data structure to loop over your phpinfo() configuration. All lists (modules(), groups(), configs()) return iterable Items objects with filter(), map(), first(), each(), count(), and more.

// Loop over defined modules
foreach($info->modules() as $module) {
    $module->name(); // "session"
    
    // Configs are grouped the same way phpinfo() groups them by table
    foreach($module->groups() as $group) {
        $group->headings(); // ["Directive", "Local Value", "Master Value"]
        
        foreach($group->configs() as $config) {
            $config->name(); // "session.gc_maxlifetime"
            $config->localValue(); // "1440"
            
            $config->hasMasterValue(); // true
            $config->masterValue(); // "28800"
        }
    }
}

The data structure has four levels:

  1. PhpInfo containing modules()
  2. Modules with name(), containing groups()
  3. Groups containing configs() and optionally headings()
  4. Configs with name(), value()/localValue(), and optionally masterValue()

You can also access configs directly from the Module and PhpInfo levels:

// Flatten grouped configs for a single module
$info->module('session')->configs();

// Flatten ALL configs across all modules
$info->configs();

Modules and Groups

Look up a specific module and inspect it directly:

// Case-insensitive lookup. Returns null if not found.
$module = $info->module('zend opcache');

// Retrieve the name as displayed in phpinfo()
$module->name(); // "Zend OPcache"

// Flatten all configs into one collection
$module->configs()->count(); // 59

// Query a specific config from this module
$module->config('Max keys'); // "16229"
$module->config('opcache.enable_file_override', 'master'); // "Off"

// Access individual groups
$group = $info->module('session')->groups()->first();

Simple example

foreach ($info->modules() as $module) {
    echo '<h2>' . $module->name() . '</h2>';

    echo '<ul>';
    foreach($module->configs() as $config) {
        echo '<li>';
        echo $config->name() . ': ' . $config->value();
        if($config->hasMasterValue()) {
            echo ' (master: ' . $config->masterValue() . ')';
        }
        echo '</li>';
    }
    echo '</ul>';
}

About

Parse, query, and display your PHP configuration with a clean API and a modern, searchable interface. Drop-in replacement for the default phpinfo() page.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors