larger smaller normal text version of this page
Translations: es

phpList Documentation

Upgrading phpList

Short instructions

Upgrading phpList in a few steps:
  1. BACKUP your database!
  2. BACKUP your old config.php file, or optionally backup your whole phpList so you can rollback if something would go wrong.
  3. Replace your old phpList with the new version.
  4. Copy your configuration files to lists/config or re-edit the new config file.
  5. Go to http://yourdomain/lists/admin/ and choose the Upgrade link in the System Functions section.
  6. Click the link in this page.

Longer version

  1. If you're using phpMyAdmin you can follow these steps to make a full backup of your database:
  2. Copy your old configured files to a safe place.
    • These files are:
      • lists/config/config.php
      • lists/texts/, or any other file if you have customized these
      • lists/.htaccess, if you have customized it and want to keep it for reference.
      • any plugins you may have been using
If you want to be on the safe side, we recommend you download the contents of the phpList directory from your web server to your hard disk. Should things go wrong, you can simply restore these files to the server.
  1. Now you can delete your old phpList installation and replace it with the new version
    • Download the latest phpList release marked as stable from the phpList website
    • The file is a either a .zip or .tar.gz archive, which means you need to unpack it with a program like Winzip, 7zip or Winrar. Make sure you let it re-create (sub)directories.
    • Delete all from your online phpList folder (make sure you stored your config.php file, and your customized or files).
    • Upload the contents of the phpList directory (i.e. the "lists" directory) to your online phpList folder.
  2. Then adapt your config.php file. You could overwrite the config file with the config file you stored earlier, but it is strongly recommended to use the new config.php file and re-adapt it to your situation by using the settings specified in your old config file, because new features may have have been added.
  3. Finally point your browser to your phpList admin directory and login. You'll be notified that your database is out of date (i.e.: "Your database is out of date, please make sure to upgrade"). Just click on the upgrade link in the System Functions block.
  4. When you made sure you have a database backup, click the link in the next page to start the upgrade process of your database tables.

Your phpList is now upgraded.

Note: Everything you need to be aware of between upgrades of different versions can be found in the release notes and change log.

Tip: If you are in doubt whether new phpList features are compatible with your specific server setup, it is recommended to create a separate test installation of phplist and run some tests, prior to actually upgrading your production install.

Page was generated in 0.2060 seconds