Upgrading your store

Upgrading - Reference Guide

Summary of Key Points For Upgrading

Why should I upgrade?

About upgrading and why it’s part of running Zen Cart

Standard Upgrade - Recommended Procedure

Upgrading Step By Step – and still keep my live store running in the meantime

Database-Only Upgrade Instructions

Lower cost quickie upgrading

Character Sets

Representing characters outside US ASCII

Checking available PHP Versions

Seeing which PHP versions are available

Configuration Parameter Name Changes

Changes to the names of configuration parameters

Converting from iso-8859-1 to utf8 or utf8mb4

Modern sites should use UTF8 or UTF8MB4

Could not upgrade to version X

Troubleshooting a failed database upgrade

Date standardization

Getting custom date fields set correctly

Fixing broken tables

Common MySQL table issues

Installer does not show an Upgrade button

I only see the Clean Install button

JavaScript Libraries

Keeping your JavaScript libraries current

Language Files - Shortcut

Simplifying your 1.5.8 Language file updates

Mixed Collation Errors

How to handle “Illegal mix of collations” after upgrade

Multiple PHP Versions

Running more than one version of PHP

Old database convertions script (deprecated)

Notes on utf8mb4-conversion.php

PHP Errors, Warnings and Deprecated messages after upgrading

How to fix the most common PHP7+ messages

PHP Version and Configuration

Changing PHP version or PHP Settings

Release Specific Upgrade Considerations

Watch for these changes if you are upgrading and preserving customizations

The PHP Lifecycle

How PHP evolves

Unknown column error after upgrade

Post-upgrade blank screen when adding a record

Updating your PHP Version

Moving to a higher PHP version after an upgrade

Upgrading and Templates

What to do with your template during an upgrade

Do you have a suggestion for a FAQ? Please post it to General Questions on the support forum.
Last modified August 31, 2020 by Scott C Wilson (ecbf3b5).