Prerequisite¶

Frontend bugs¶

Frontend bugs are JavaScript or display related issues.

What to do?

• Use your browser buit-in developer tools to get more precise error messages and to debug javascript code step by step.
• A frontend error can occur because the backend encountered an error, use the network tab of the developer tools to see if it’s the case or not.
• The PIM can send many types of AJAX requests (GET, POST, PUT, DELETE...), make sure the server is configured to accept all of them.

Backend bugs¶

Backend bugs are issues which occur on the server side (PHP/Symfony code, database...).

What to do?

• Use the Symfony buit-in developer tools (the debug toolbar and the profiler).
• Use the Symfony and PIM built-in debug commands (to see them, use the command php bin/console without any arguments).
• Use the tools of your integrated development environment to debug the code step by step.
• Analyze the error messages provided in the Symfony’s log files /path/to/your/pim/var/logs/prod.log or /path/to/your/pim/var/logs/dev.log
• Take a look at the PHP error log file.

Tasks bugs¶

Tasks bugs are issues which occur when running the PIM jobs, like mass edit, import, export... (The way to qualify could be a bit different than pure backend bugs).

What to do?

• Analyze the error messages provided in the following file /path/to/your/pim/var/logs/batch_execute.log
• Launch the command out of the PIM with the tools of your integrated development environment php bin/console akeneo:batch:job <batch_name> <additional_params>
• Check the to do list of the “Backend bugs” section.

Performances issues¶

When you notice slownesses, displaying pages and/or during import/exports, you are probably experiencing a performance issue.

What to do?

• Use the Symfony’s profiler timeline tab to identify what part of the execution takes most of the time.
• Use blackfire.io in order to profile the requests which take too much time.
• Use MySQL built in “SHOW PROCESSLIST” query to identify queries which take too long to run (See: MySQL documentation: SHOW PROCESSLIST Syntax).
• Use MEMINFO to analyse memory leak issues (See: MEMINFO GitHub repository).

Reporting the bug¶

With the information you have gathered, you can now Report a bug.