{"id":9092,"date":"2026-05-17T21:55:38","date_gmt":"2026-05-17T16:25:38","guid":{"rendered":"https:\/\/www.veeble.com\/kb\/?p=9092"},"modified":"2026-05-17T21:55:38","modified_gmt":"2026-05-17T16:25:38","slug":"website-broke-after-php-upgrade","status":"publish","type":"post","link":"https:\/\/www.veeble.com\/kb\/website-broke-after-php-upgrade\/","title":{"rendered":"Why Your Website Broke After a PHP Upgrade and How to Fix It"},"content":{"rendered":"\n

PHP 8 introduced stricter syntax enforcement that silently breaks code written for PHP 7.4. Things the older interpreter accepted without complaint, like unquoted constant names, bare array keys, and unquoted format strings, now throw fatal errors and take your site down. This guide covers the most common causes and how to fix them.<\/p>\n\n\n

How to Know If PHP Is the Cause<\/h2>\n\n\n

Your site may show a blank page, load only partially, or show a server error. If the timing lines up with a server migration or a PHP version change, that’s your first clue.<\/p>\n\n\n\n

Check your PHP error log from the site folder. If you see lines like these, PHP version is the cause:<\/p>\n\n\n\n

PHP Fatal error: Uncaught Error: Undefined constant \"SCRIPT_ROOT\"\nPHP Fatal error: Uncaught Error: Undefined constant \"Y\"\nPHP Fatal error: Uncaught Error: Undefined constant \"email\"<\/code><\/pre>\n\n\n\n
These all point to the same type of issue: code that worked fine on PHP 7.4 but fails on PHP 8.<\/p>\n\n\n
The Most Common Breaking Changes<\/h2>\n\n
Unquoted Constant Names in define()<\/h3>\n\n\n
This is probably the most common one. In PHP 7, you could write this, and it would work:<\/p>\n\n\n\n
\/\/ \u274c Broken on PHP 8\ndefine(SCRIPT_ROOT, \"https:\/\/yoursite.com\/\");<\/code><\/pre>\n\n\n\n
PHP 8 throws a fatal error because SCRIPT_ROOT<\/code> is not a quoted string. It tries to find a constant called SCRIPT_ROOT<\/code> before it has been defined.<\/p>\n\n\n\n
The fix is simple, just add quotes around the constant name:<\/p>\n\n\n\n
\/\/ \u2705 Works on both PHP 7 and PHP 8\ndefine('SCRIPT_ROOT', \"https:\/\/yoursite.com\/\");<\/code><\/pre>\n\n\n\n
Same rule applies everywhere you use define()<\/code>. The first argument must always be a quoted string.<\/p>\n\n\n
2. Unquoted Array Keys<\/h3>\n\n\n
In PHP 7, using bare words as array keys was allowed:<\/p>\n\n\n\n
\/\/ \u274c Broken on PHP 8\n$_SESSION[email]\n$_COOKIE[username]\n$_POST[phone]<\/code><\/pre>\n\n\n\n
PHP 8 treats email, username, and phone as constants, and since they are not defined, it throws a fatal error.<\/p>\n\n\n\n
Always quote your array keys:<\/p>\n\n\n\n
\/\/ \u2705 Correct\n$_SESSION['email']\n$_COOKIE['username']\n$_POST['phone']<\/code><\/pre>\n\n\n
3. Unquoted Strings in date () Calls<\/h3>\n\n\n
This one shows up as Undefined constant \"Y\"<\/code> in your error log. It happens when the date format string is passed without quotes:<\/p>\n\n\n\n
\/\/ \u274c Broken on PHP 8\necho date(Y);\necho date(Y-m-d);<\/code><\/pre>\n\n\n\n
Again, PHP 8 tries to look up Y<\/code> as a constant and fails. The fix:<\/p>\n\n\n\n
\/\/ \u2705 Correct\necho date('Y');\necho date('Y-m-d');<\/code><\/pre>\n\n\n
Quick Reference Table<\/h2>\n\n\n
Error in Log<\/th>What It Means<\/th>Fix<\/th><\/tr><\/thead>
Undefined constant \"SCRIPT_ROOT\"<\/code><\/td>Unquoted name in define()<\/code><\/td>Add quotes: define('SCRIPT_ROOT', ...)<\/code><\/td><\/tr>
Undefined constant \"Y\"<\/code><\/td>Unquoted string in date()<\/code><\/td>Add quotes: date('Y')<\/code><\/td><\/tr>
Undefined constant \"email\"<\/code><\/td>Unquoted array key<\/td>Add quotes: $_SESSION['email']<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n
Two Ways to Handle This<\/h2>\n\n
Option 1: Roll Back to PHP 7.4 (Quick Fix)<\/h3>\n\n\n
If your site just broke and you need it live immediately, rolling back the PHP version is the fastest option. On cPanel with CloudLinux:<\/p>\n\n\n\n
    \n
  1. Log in to cPanel<\/strong><\/li>\n\n\n\n
  2. Go to MultiPHP Manager<\/strong><\/li>\n\n\n\n
  3. Find your domain<\/li>\n\n\n\n
  4. Select PHP 7.4<\/strong> from the dropdown<\/li>\n\n\n\n
  5. Click Apply<\/strong><\/li>\n<\/ol>\n\n\n\n
    Your site will be back up within seconds. Keep in mind that PHP 7.4 is end-of-life and no longer receives security updates. This should be a temporary fix, not a permanent one.<\/p>\n\n\n
    Option 2: Fix the Code (Proper Fix)<\/h3>\n\n\n
    The right long-term solution is to update the code to be PHP 8 compatible. The fixes are small. It is mostly a matter of adding missing quotes in the right places.<\/p>\n\n\n\n
    If you’re on shared hosting and have SSH or cPanel Terminal access, you can find all affected files quickly:<\/p>\n\n\n\n
    # Find unquoted date() calls\ngrep -rn \"date(Y\" \/home\/username\/public_html\/ --include=\"*.php\"\n\n# Find unquoted array keys with 'email'\ngrep -rn '\\[email\\]' \/home\/username\/public_html\/ --include=\"*.php\"<\/code><\/pre>\n\n\n\n
    Once you know which files are affected, you or your developer can fix them one by one.<\/p>\n\n\n
    Before Your Next Migration, A Short Checklist<\/h2>\n\n\n