UPDATE.md

How to update your Thelia ?

If you have already installed Thelia but a new version is available, you can update easily.

Before proceeding to the update, it's strongly recommended to backup your website (files and database). You can backup your database with tools such as phpmyadmin or mysqldump.

1. Update files

• Download the latest version of Thelia : http://thelia.net/download/thelia.zip
• Extract the zip in a temporary directory
• Then you should replace (not only copy) all the files from the new Thelia version :
  • all files from root directory
  • bin (optional)
  • core (mandatory)
  • setup (mandatory)
• Then, you have to merge (copy in your existent directories) these other directories. Normally, you haven't modify files inside these directories (just created new ones - like your frontOffice template). But If you have modified files, you should proceed carefully and try to report all your changes.
  • local/config
  • local/modules
  • templates
  • web

2. Update database

Then you have 2 different ways to proceed. In each method, a backup of your database can be automatically performed if you want to. If an error is encountered, then your database will be restored.
But if your database is quite large, it's better to make a backup manually.

2.1. use the update script

In a command shell, go to the root directory of your installation, run and follow instructions :

php setup/update.php

2.2. use the update wizard

An update wizard is available in the web/install directory. It's the same directory used by the install wizard.

You have to protect the web folder if your site is public (htaccess, List of allowed IP, ...).

The update wizard in accessible with your favorite browser :

http://yourdomain.tld/[/subdomain_if_needed]/install

Note:

• the wizard is available only if your Thelia is not already in the latest version.
• at the end of the process, the install directory will be removed.

3. Clear cache

Once the update is done successfully, you have to clear all caches :

• clear all caches in all environment :
  • php Thelia cache:clear
  • php Thelia cache:clear --env=prod

If the command fails, you can do it manually. Just delete the content of the cache and web/cache directories.