PrestaShop

PrestaShop 500 Internal Server Error: Your Ultimate Guide to Diagnosis and Fixes

Few things are as frustrating for an e-commerce store owner as seeing the dreaded "500 Internal Server Error" message. Your PrestaShop store, once a bustling hub of activity, suddenly displays a blank page or a generic error, halting sales and eroding customer trust. This cryptic message offers little immediate insight, leaving you to wonder what went wrong. As experts in PrestaShop migrations and maintenance at Migrate My Shop, we understand the urgency. This guide will demystify the 500 error, helping you diagnose, fix, and prevent it from recurring.

A 500 error isn't a single bug; it's a catch-all message indicating that your server encountered an unexpected condition that prevented it from fulfilling a request. The problem could lie anywhere: within your PrestaShop core files, a faulty module, an incompatible PHP version, database issues, or even misconfigured web server settings (Apache or Nginx). The key to resolution is to stop guessing and start systematically identifying the root cause.

The browser only shows you the generic result. The real reason is always hidden in the error logs.

How a 500 error happens in PrestaShop
How a 500 error happens in PrestaShop

Common Causes of PrestaShop 500 Internal Server Errors

Understanding the typical culprits is the first step towards efficient troubleshooting. Here are the most frequent reasons PrestaShop stores encounter a 500 error:

  • Corrupted .htaccess File: This file controls how your server handles requests, including URL rewrites. Bad rewrite rules, a file copied from a different server environment, or incorrect SEO URL settings can easily trigger a 500 error.
  • PHP Version Mismatch: PrestaShop versions have specific PHP requirements. If your hosting provider upgrades PHP, or your PrestaShop version doesn't support the PHP version in use, you'll likely encounter compatibility issues, leading to a 500 error.
  • Faulty Module or Theme: A newly installed, recently updated, or poorly coded third-party module or theme can introduce conflicts or errors. This is particularly common if the module/theme isn't fully compatible with your PrestaShop version.
  • Low Memory or Time Limits: Intensive operations like large product imports, complex module calculations, or heavy traffic can exceed PHP's memory_limit or max_execution_time, especially on shared hosting environments.
  • Incorrect File Permissions: After restoring a backup, migrating your store, or manual file transfers, file and folder permissions can become incorrect. Critical folders like var/, img/, upload/, and download/ must be writable by the web server.
  • Override Conflicts and Stale Cache: PrestaShop's override system allows customization without modifying core files. However, conflicting files in the /override directory or a corrupted class_index.php (part of the cache) can lead to fatal errors.
  • Database Problems: Incorrect database connection credentials, crashed database tables, or missing columns after an upgrade can prevent PrestaShop from accessing essential data, resulting in a 500 error.

Step-by-Step Debugging for PrestaShop 500 Errors

A systematic approach is crucial for diagnosing and resolving a 500 error. Always remember to back up your files and database before making any changes, and if your shop is live, test fixes on a staging copy first.

Step 1: Read the Server Error Log

This is your most powerful diagnostic tool. The error log will often pinpoint the exact file and line number where the error occurred. Look in these common locations:

  • cPanel: Navigate to the "Errors" section or find the error_log file in your PrestaShop root directory.
  • VPS/Dedicated Server (Apache): Check /var/log/apache2/error.log or /var/log/httpd/error_log.
  • VPS/Dedicated Server (Nginx): Check /var/log/nginx/error.log.
  • PrestaShop's Internal Logs: Also check var/logs/ within your PrestaShop installation for specific PrestaShop-related errors.

Focus on the most recent entries at the bottom of the log file.

Step 2: Turn On PrestaShop Debug Mode

If the server logs are unhelpful or too generic, PrestaShop's debug mode can provide more detailed error messages directly on your screen. To enable it:

  1. Connect to your server via FTP or file manager.
  2. Navigate to the config/ directory.
  3. Open defines.inc.php for editing.
  4. Find the line define('_PS_MODE_DEV_', false);
  5. Change it to:
define('_PS_MODE_DEV_', true);

Reload your PrestaShop page. Instead of a generic 500 error, you should now see a detailed exception message, often with a stack trace, which is invaluable for identifying the problem. Remember to turn debug mode off (`false`) once you've resolved the issue, as it exposes sensitive technical details to visitors.

Step 3: Rule Out the .htaccess File

A common culprit, the .htaccess file can be quickly tested:

  1. Rename your .htaccess file to something like .htaccess_old via FTP.
  2. Reload your shop. If it loads, the .htaccess file was the problem.
  3. To regenerate a fresh .htaccess, go to your PrestaShop back office (if accessible) > Shop Parameters > Traffic & SEO, and simply click the "Save" button without making any changes. This will create a new, clean .htaccess file.

Step 4: Isolate the Module, Theme, or Override

If the error started after a recent installation or update, this step is critical:

  • Modules: If you can't access the back office, rename the suspect module's folder via FTP (e.g., modules/modulename to modules/modulename_off). Start with the most recently installed or updated module.
  • Themes: If your current theme is the issue, you can often switch to the default PrestaShop theme by renaming your current theme's folder in /themes/ or, if the back office is accessible, via Design > Theme & Logo.
  • Overrides: Conflicting files in /override can cause issues. Rename files inside /override one at a time (e.g., override/classes/Product.php to Product.php_off) and then delete the contents of var/cache/ (specifically class_index.php) to clear the cache.

Step 5: Check PHP Version, Extensions, and Limits

Ensure your PHP environment is correctly configured for your PrestaShop version:

  • PHP Version: Confirm your server's PHP version (e.g., via cPanel's PHP Selector or a phpinfo() file) matches what your PrestaShop version officially supports.
  • PHP Extensions: Verify that essential extensions are enabled: curl, gd, intl, mbstring, zip, pdo_mysql. These are typically managed in your hosting control panel or php.ini.
  • PHP Limits: If logs indicate "exhausted memory" or "maximum execution time exceeded," increase these limits in your php.ini file (or via your hosting panel):
    memory_limit = 512M
    max_executi>

Step 6: Fix File Permissions

Incorrect permissions are a common post-migration or backup restoration issue:

  • Folders: Should generally be 755.
  • Files: Should generally be 644.
  • Writable Folders: Ensure var/, img/, upload/, and download/ (and their subfolders) are writable by PHP, often requiring 755 or sometimes 775/777 (use 775 if possible for security).

You can usually change permissions via your FTP client or hosting file manager.

Step 7: Clear the Cache

A stale or corrupted cache can often be the lingering cause of a 500 error, especially after module changes or upgrades. Delete the contents of the var/cache/ folder (but not the folder itself). If your back office is accessible, you can also clear the cache from Advanced Parameters > Performance.

Step 8: Check the Database Connection

Verify your database credentials and integrity:

  • Credentials: Check the database connection details in app/config/parameters.php (for PrestaShop 1.7 and later) or config/settings.inc.php (for PrestaShop 1.6).
  • Crashed Tables: If your error log mentions crashed tables, access phpMyAdmin (or your database management tool) and run a "Repair table" operation on the affected tables.

500 Error After a PrestaShop Upgrade or Migration

This scenario is where 500 errors frequently emerge. Migrating from PrestaShop 1.6 or 1.7 to 8.x, or even between minor 8.x versions, involves significant changes to PHP requirements, theme structure (Smarty templates), and how modules load. The usual culprits are:

  • Third-party modules not updated for the new PrestaShop version.
  • Leftover overrides from the old version that conflict with new core files.
  • An .htaccess file written for the old version, causing rewrite issues.
  • Incompatible PHP versions or missing extensions.

When performing an upgrade or migration, always do so on a staging copy. Disable all third-party modules before starting the process, and re-enable them one at a time after the upgrade to identify any conflicts.

How to Prevent 500 Errors in Your PrestaShop Store

Prevention is always better than cure. Adopt these best practices to minimize the risk of 500 errors:

  • Use a Staging Environment: Always test updates, new modules, or theme changes on a staging shop before deploying to live.
  • Install Modules from Trusted Sources: Only use modules and themes from the official PrestaShop Addons Marketplace or reputable developers.
  • Maintain PHP Compatibility: Regularly check PrestaShop's official documentation for recommended PHP versions and ensure your hosting environment matches.
  • Regular Backups: Implement a robust backup strategy for both your files and database before any significant change.
  • Keep Server Error Logging On: Ensure your server's error logging is always active. This makes diagnosing future problems a matter of minutes, not hours.
  • Monitor Resources: Keep an eye on your server's memory and CPU usage, especially during peak times or after installing new features.

A 500 Internal Server Error can be daunting, but with a systematic approach and the right tools, it's a solvable problem. By following these steps, you can efficiently diagnose and resolve issues, getting your PrestaShop store back online and thriving. If you're facing persistent issues, especially after a migration, don't hesitate to reach out to the PrestaShop migration experts at Migrate My Shop for professional assistance.

Share:

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools