We’ve all seen it. As common as it is infamous, the dreaded HTTP 500-Internal Server Error will turn an online-store owner’s smile to a confused frown with one click. The harbinger of lost sales, it stonewalls your customers’ ability to browse your store and purchase products. For web-developers, this error is a nightmare, creating a frenzied scurry to get your store back online. As horrific as it sounds, it’s not all that scary. I’ll explain the Error and provide troubleshooting ideas for your PrestaShop store. The next time you see this error, instead of hiding under your blanket, you’ll be prepared to act fast, fix the issue and continue to make sales.
How to recognize the Error 500
First, we need to go over the different ways you might see this error message on your computer. There are different forms of this message because each host/server is allowed to customize the way it's displayed. Here are some common ways you might see this error.
- "500 Internal Server Error"
- "HTTP 500 - Internal Server Error"
- "Internal Server Error"
- "HTTP 500 Internal Error"
- "500 Error"
- "HTTP Error 500"
Most times you will see this message accompanied by various forms of this classic ambiguous line "The server encountered an unexpected condition that prevented it from fulfilling the request by the client" It’s important to note that this error can be shown on any browser and any operating system (sorry, but switching to the new Mac Pro will not solve this problem) Here is a screenshot of one of the ways this error might be displayed on your browser.
What is the 500 Error?
Put simply, the 500 error is the Web servers way of saying “Something went wrong but I can’t tell you what, sorry.” This is what we call a “server-side” error. That means that there is something wrong with the server who is hosting the website. It is an extremely general error usually caused by configuration issues with the websites programming, PHP or system permissions.
How Can I Troubleshoot?
Don’t fret; although this error message is absurdly vague, you still have ways to find more information. Web servers are almost always configured to hide specific error messages. If your PrestaShop store is suffering from this debilitating error, you can turn on PrestaShop’s Error Reporting from FTP or your hosting’s CPanel to get more details. There are two ways to turn on Error Reporting in PrestaShop depending on what version you have. For PrestaShop v1.4 through v1.5.2
- Open config/config.inc.php
- On or around line 29 you will find this line
- Change that line to read
For PrestaShop v1.5.3+
- Open config/defines.inc.php
- On or around line 28 you will find this line
- Change that line to read
Once you enable error reporting through your FTP or CPanel, you can navigate back to your PrestaShop’s front or back office and reproduce the error or issue you are having. For example, if you are not able to access your website because of the 500 error, you will need to turn on error reporting and refresh the page(s) that had the error. There will be additional information that you can use to investigate the problem.
Investigating the Error
Once you have the additional information, there are some standard ways to further investigate the error. First, let’s go over some the most common ways this problem is caused. Once we find the cause of this error, it is much easier to solve. Permissions: Many times you will find that the permission setting on one of your folders is set incorrectly. It could be a simple fix as switching a file/folder permission from 777 to 755 or vice versa. In most cases permission sets of 777 are extremely unsafe and can allow even an amateur hacker to access your files and put malicious code in it. Make sure to check with your hosting provider for specific information about permissions set as some servers have different regulations. Incorrectly configured .htaccess: Oftentimes you will receive an internal server error when the htaccess file is configured incorrectly. For PrestaShop purposes, the main culprits of the htaccess errors are "URL Rewrite" settings or Friendly URL enabling. The htaccess syntax is very strict so even one wrong character or command will cause the server to return an Internal Error 500. Make a backup of your htaccess and regenerate the htaccess file either through the back office or by toggling the Enable Friendly URL option. Server timeout: Every server has their own timeout setting, which sets the time that any given script can run. If the function or script crosses that limit, you will receive an error 500. The most common scripts in PrestaShop that can take too long to load are CSV Imports, backups, translation loading, import/exports and thumbnail regeneration. Many times the server limit is 30 seconds, which is not long enough to run these scripts. You should contact your hosting provider and inquire about changing the limit, at least temporarily. Now, if the problem is not solved by investigating these common causes, you should also take a look at the Apache and PHP Error logs. These are provided by your hosting provider but sometimes you will need to contact them directly in order to have access to these log files.
Piecing the Puzzle
As cliché as it sounds, once you get the error information from PrestaShop and/or the Error log, search for it using Google (add the word PrestaShop to your search and hone-in on the problem) You will find a plethora of information and tutorials about your error. Without a doubt you will find some PrestaShop Forum threads with the [SOLVED] tag by them. Make sure to take the time to read those first. If you cannot solve the problem after reading this post, researching on the internet and working with your Webmaster/hosting provider, you should definitely take the time to register and post on the PrestaShop Forums. With over 500,000 Community members, we will make sure that the problem is [SOLVED]. You can Private Message (username: “Benjamin Utterback”) me on the forum with the link to your forum thread and I’ll be sure to take a look and facilitate answers from our expert team of Community Mangers and Moderators. I told you the 500 Internal Server Error is not as scary as it seems. Now you are well prepared with the knowledge to navigate and solve one of the most feared internet errors. Get your PrestaShop store online and continue to make sales! UPDATED 3/31/2016: We hope this article helps you address your issue. For answers to individual questions, you can post your question for free on our forum (www.prestashop.com/forums/) or contact us (www.prestashop.com/en/contact-us) and a representative will contact you with details on how you can get the help you need.