nativeInstallerpimcore

Debug Pimcore errors

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

Approach A: Bitnami installations using system packages

The Pimcore log files are at installdir/pimcore/var/logs/.

It is possible to enable the debug mode by following these steps:

  • Edit the installdir/pimcore/var/config/debug-mode.php file as below:

      ...
      "active" => TRUE,
    
  • Edit the installdir/php/etc/php-fpm.d/pimcore.conf file and replace the line below:

      env[PIMCORE_ENVIRONMENT] = prod
    

    With this:

      env[PIMCORE_ENVIRONMENT] = dev
    
  • Edit the apache/conf/vhosts/pimcore-vhost.conf and apache/conf/vhosts/pimcore-https-vhost.conf files and replace the line below:

      SetEnv PIMCORE_ENVIRONMENT prod
    

    With this:

      SetEnv PIMCORE_ENVIRONMENT dev
    
  • Restart Apache and PHP-FPM:

      $ sudo installdir/ctlscript.sh restart apache
      $ sudo installdir/ctlscript.sh restart php-fpm
    

The above steps will also make the Symfony toolbar visible at the bottom right corner of each page.

To disable the debug mode, revert the changes made to the above files and restart Apache and PHP-FPM.

Approach B: Self-contained Bitnami installations

The Pimcore log files are at installdir/apps/pimcore/htdocs/var/logs/.

It is possible to enable the debug mode by editing installdir/apps/pimcore/htdocs/var/config/debug-mode.php file as below:

...
"active" => TRUE,

Also, the Symfony toolbar can be shown by setting the toolbar parameter to true in installdir/apps/pimcore/htdocs/vendor/pimcore/pimcore/bundles/CoreBundle/Resources/config/pimcore/dev.yml file:

...
toolbar: true
Last modification June 16, 2021