Troubleshoot Common PHP Website Errors

A PHP site may show a blank page, an HTTP 500 error, a warning, or only part of the expected content. Work through these checks one at a time and keep detailed errors private; displaying them to every visitor can reveal file paths, configuration, or other sensitive information.

1. Record the exact page and error

Note the full URL, the action that caused the problem, the time it occurred, and any error reference shown by the application. Check whether the issue affects one page or the whole site.

2. Review the most recent change

If the error started after an update, configuration edit, or file upload, identify that change first. Restore a known-good backup if needed. Avoid repeating an update until you have a restorable copy of the site files and database.

3. Check PHP compatibility and extensions

Compare the application's requirements with the PHP version assigned to the domain and the extensions available to the account. A version change can affect older code, so test compatibility and make a backup before changing it. See how to check PHP extensions.

4. Check files and configuration

• Confirm the domain points to the folder containing the application's index file.
• Look for a missing include, typo, or incomplete upload in the files changed most recently.
• Verify the application configuration refers to the correct database without posting credentials publicly.
• Do not set broad permissions such as 777 to try to fix an error. Use the application's recommended permissions or ask support.

5. Review the error log safely

If your control panel provides an error log or an Errors page, check the entry at the time of the failure. Keep debug output disabled on a public production site. If you need temporary diagnostic logging, protect the output and remove it as soon as the issue is resolved.

When to contact support

Contact hosting support if the error appears related to the server, account configuration, or a resource limit. Include the affected domain, URL, approximate time, and exact error text. Remove passwords, API keys, database credentials, and private customer data from screenshots or messages.

If you are still setting up the site, see how to place a PHP website in its document root.