How can we resolve the white page error when accessing Prestashop administration?
In this article, we will explain how you can resolve the white page error when accessing PrestaShop administration.
White Page Issue in PrestaShop
One of the common problems encountered after installing a PrestaShop application is the display of a white page when accessing the administration address, for example: domain.tld/administrator (the address may vary depending on the customizations made during installation).
Cause of the problem
In general, this error is caused by the fact that the PHP directives opcache.save_comments and opcache.load_comments are not enabled. This issue is highlighted in the error_log file in the administration directory. An example from the error log looks like this:
PHP Fatal error: Uncaught exception 'Doctrine\Common\Annotations\AnnotationException'with message 'You have to enable opcache.save_comments=1 or zend_optimizerplus.save_comments=1.'in /home/USERNAME/public_html/PrestaShop/vendor/doctrine/annotations/lib/Doctrine/Common/Annotations/AnnotationException.php:183Problem Solving
To activate the necessary PHP directives, follow the steps below:
- Access cPanel.
- Open Select PHP Version.
- Click on Switch to PHP Options.
- Enable the opcache.save_comments and opcache.load_comments directives by setting them to On.
- Press the Save button at the bottom of the page.
Additional Information
More details about modifying PHP directives are available in the tutorials:
Conclusion
After activating the directives opcache.save_comments and opcache.load_comments, the administration part of the PrestaShop application should become accessible.
