PHP Classes

PHP OpCache Web Interface: Show the usage of cached PHP scripts with OpCache

Recommend this page to a friend!
  Info   Documentation   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not enough user ratingsTotal: 162 All time: 8,941 This week: 488Up
Version License PHP version Categories
opcache-gui 1.0.0MIT/X Consortium ...5HTML, PHP 5, Cache, Language
Description 

Author

This class can show the usage of cached PHP scripts with OpCache.

It can perform several types of operations to manage the PHP scripts that are in the opcache cache area.

The class can generates HTML based user interface to display details of all files being cached, clean up the whole script files in the cache, as well display the list of relevant PHP options that may affect PHP script caching system.

Innovation Award
PHP Programming Innovation award nominee
May 2018
Number 5
OpCache is an extension built-in PHP since version for caching compiled PHP scripts in memory, so they can execute faster next time a script is executed again.

This class provides a Web based user interface to show how opcache is doing in terms of caching PHP scripts, as well allow to change some caching options or remove the current scripts being cached in memory.

Manuel Lemos
Picture of Andrew Collington
  Performance   Level  
Name: Andrew Collington <contact>
Classes: 16 packages by
Country: United Kingdom
Age: 50
All time rank: 563 in United Kingdom
Week rank: 44 Up3 in United Kingdom Equal
Innovation award
Innovation award
Nominee: 3x

Documentation

opcache-gui

A clean and responsive interface for Zend OPcache information, showing statistics, settings and cached files, and providing a real-time update for the information (using jQuery and React).

Flattr this git repo If you like this software or find it helpful then please consider signing up to Flattr and leaving a micro-donation. If you don't want to do that, I hope you find it useful anyway! :-).

What's new

Version 2.4.0\ Adds cookie store for the real-time state allowing real-time to be activated on load. Cookie name and TTL length can be adjusted in the config

Version 2.3.0\ Adds information for interned strings and PHP 5.4 compatibility

Version 2.2.2\ Brings in optimisations for the file listing when filtering

Version 2.2.1\ Has the gauges now updating with the real-time pulse and a couple rounding issues fixed

Version 2.2.0\ Provides the ability to turn on/off the file list (default is on)

Version 2.1.0\ Now provides a much easier way to configure some options, be it the poll time, toggling the ability to reset the cache, real-time updates, etc. It also allows you to show the big values (memory usage and hit rate) as gauge graphs instead of big numbers.

Version 2.0.0\ Introduces the use of React.js provides the ability to seamlessly update more of the information in real-time (well, every five seconds by default) - so now the files as well as the overview get refreshed. There is an updated look, removing the gradients and going for a flatter feel. And the code in general has had an overhaul.

Overview

The overview will show you all the core information. From here you'll be able to see what host and platform you're running on, what version of OPcache you're using, when it was last reset, the functions that are available, all the directives and all the statistics associated with the OPcache (number of hits, memory used, free and wasted memory, etc.)

Overview

Getting started

There are two ways to getting started using this gui.

  1. Simply to copy/paste or download the index.php to your server.
  2. Install via composer by running the command `composer require amnuts/opcache-gui`

If you want to set the configuration options just alter the array at the top of the script:

$options = [
    'allow_filelist'   => true,  // show/hide the files tab
    'allow_invalidate' => true,  // give a link to invalidate files
    'allow_reset'      => true,  // give option to reset the whole cache
    'allow_realtime'   => true,  // give option to enable/disable real-time updates
    'refresh_time'     => 5,     // how often the data will refresh, in seconds
    'size_precision'   => 2,     // Digits after decimal point
    'size_space'       => false, // have '1MB' or '1 MB' when showing sizes
    'charts'           => true,  // show gauge chart or just big numbers
    'debounce_rate'    => 250    // milliseconds after key press to send keyup event when filtering
];

File usage

All the files currently in the cache are listed here with their associated statistics. You can filter the results very easily to key in on the particular scripts you're looking for, and you can optionally set levels of the path to be hidden (handy if they all share a common root and you don't want that displayed). It will also indicate if the file cache has expired.

If you do not want to show the file list at all then you can use the allow_filelist configuration option; setting it to false will suppress the file list altogether.

File list showing filtered results

Reset cache

You can reset the whole cache as well as force individual files to become invalidated so they will be cached again.

Both reset types can be disabled with the options allow_reset and allow_invalidate.

Real-time updates

The interface can poll every so often to get a fresh look at the opcache. You can change how often this happens with the option refresh_time. The React javascript library is used to handle data refresh so you don't need to keep reloading the page.

Project files

The status.jsx file is provided solely for you to be able to edit the jsx code should you wish. For production purposes it's best to have the jsx code pre-compiled which is what's used in index.php. You do not need to use status.jsx at all in order to use the opcache gui. However, should you wish to compile the jsx code then you'll need to use babel or the react-tools (no longer supported with newer versions of React).

The composer.json file is provided to allow you to deploy the opcache gui a little easier by using composer.

Releases

Releases of the GUI are available at:

https://github.com/amnuts/opcache-gui/releases/

License

MIT: http://acollington.mit-license.org/


  Files folder image Files (4)  
File Role Description
Files folder imagesrc (1 file)
Accessible without login Plain text file composer.json Data Auxiliary data
Plain text file index.php Class Class source
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files (4)  /  src  
File Role Description
  Accessible without login Plain text file status.jsx Data Auxiliary data

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
 Version Control Unique User Downloads Download Rankings  
 100%
Total:162
This week:0
All time:8,941
This week:488Up