Skip to main content

Install the PHP / Magento / OroCommerce Profiler

The DEM PHP module comes as a PHP extension that allows you to collect detailed information about the execution time of each part of your CMS.

Prerequisites​

The profiler requires the installation of the system agent. Refer to the dedicated page to install the agent.

Compatibility​

DistributionOS VersionPHP VersionDEM PHP Module
DebianBuster (10)7.3/7.4/8.0/8.1/8.2/8.31.3.4
DebianBullseye (11)7.3/7.4/8.0/8.1/8.2/8.31.3.4
DebianBookworm (12)7.4/8.0/8.1/8.2/8.31.3.4
UbuntuJammy (22.04)7.3/7.4/8.0/8.1/8.2/8.31.3.4
UbuntuKinetic (22.10)7.3/7.4/8.0/8.1/8.2/8.31.3.4
UbuntuLunar (23.04)7.3/7.4/8.0/8.1/8.2/8.31.3.4
CentOS77.3/7.41.3.3 (beta repo)

Installation​

The PHP module must be installed on every server running your PHP application.

Install the DEM PHP Module for Debian / Ubuntu​

You must have added the DEM repositories, which you should already have done during the system agent installation.

Depending on your PHP version, install the corresponding package. Here are a few examples:

  • For PHP 7.3:

    apt install php73-quanta-mon

  • For PHP 7.4:

    apt install php74-quanta-mon

  • For PHP 8.0:

    apt install php80-quanta-mon

  • For PHP 8.1:

    apt install php81-quanta-mon

  • For PHP 8.2:

    apt install php82-quanta-mon

Then, enable the extension with the following command:

phpenmod quanta_mon

Install the DEM PHP Module for CentOS / RedHat​

You must have added the DEM repositories, which you should already have done during the system agent installation.

Depending on your PHP version, install the corresponding package, for example:

  • For PHP 7.2:

    yum install php72-quanta-mon

  • For PHP 7.3:

    yum install php73-quanta-mon

  • For PHP 7.4:

    yum install php74-quanta-mon

Then, enable the extension with the following command:

phpenmod quanta_mon

Install the PHP Module for Other OSs​

We do not officially support packages for other operating systems. However, you can compile the module yourself, as the source code is available on GitHub.

Configure Your Backoffice URL if You Use Magento​

If you use Magento and a custom URL is used to access the Magento backoffice (i.e., a URL that does not start with "/admin/"), you must modify the module configuration so that Magento-type events are correctly reported in DEM.

This file is usually located here for Debian/Ubuntu:

/etc/php<VERSION>/mods-available/quanta_mon.ini

and here for CentOS:

/etc/php.d/quanta_mon.ini

However, this may vary depending on your PHP installation.

For example, if your backoffice URL is "http://admin.mysite.com/admin_123456/", you must enter the following parameter:

quanta_mon.admin_url="/admin_123456/"

Restarting the Web Server​

After installing the module, you must restart your web service so that the PHP extension is loaded and activated.

  • For example, if you use Apache on Debian:

    systemctl restart apache2

  • If you use PHP-FPM, the command would be for example:

    systemctl restart php8.2-fpm

Checking That Everything Works​

Once everything is installed and the web scenario has been created in DEM, go to the Web Scenario menu, then click “+ details” in the legend of one of the pages requiring PHP execution (for example: a Cart page, which is usually never cached).

You should then see an “Application” tab (otherwise this tab is grayed out) with information about the time spent in PHP.

In the case of a Magento (v1 or 2) CMS or the OroCommerce platform, the color coding differs: it is orange for Magento and yellow for OroCommerce.

Advanced metrics (Apache, MySQL, Redis, etc.) must be installed separately. Refer to the dedicated page.