Upgrading to Perch 3
Perch 3 is a new major version of Perch with some big interface changes. A lot of the underlying structure is backwards compatible, so upgrading to Perch 3 is not complex.
Before you start
Follow these instructions to help make your upgrade as smooth as possible.
1. Check the requirements
Perch 3 requires a newer version of PHP. We recommend PHP 7, but the very minimum is PHP 5.4. The download page has the current requirements listed.
2. Make a backup
Before making any changes, make a backup of your files and your database. This means that come what may, you can always revert to your current position without doing any damage.
3. Work on your dev or staging site
We don’t recommend upgrading a live site in-place. Not because the upgrade process is risky, but because that’s not the most sensible way to work for any website updates. Get your staging or dev site up to date (perhaps using the backup of the live site you’ve just made) and try the upgrade there first. If all is well, you can deploy those changes to the live site without worrying and with minimal disruption.
With that done, we should be ready to begin.
1. Replace Perch core
Download the latest version of Perch and copy the new
perch/core folder over your old
2. Check your apps file
If you have a very old install to upgrade, your
perch/config/config.apps file might contain lots of
include() statements. You need to update it or you’ll get errors. A basic starting point
apps.php file looks like this:
<?php $apps_list = [ ];
You don’t need the Content or Categories apps listed like in the past. Just add an entry to the list for any add-ons you need installed. For example, an install with Blog and Twitter apps would have:
<?php $apps_list = [ 'perch_blog', 'perch_twitter', ];
3. Remove unnecessary add-ons
Perch 3 contains the MarkItUp and Redactor edits as part of core, so you can remove:
4. Update your apps
Changes in Perch 3 mean that your Perch 2 apps won’t work without being updated. Therefore you need to download the latest versions of your apps from the new add-ons site.
5. Log in
When you log in to the control panel, the updater will run as usual and you should be all set to go.