Provides an easy, automated, web-based update mechanism for phpList installations.
The new phpList updater gives you an easy way to upgrade your installation via web. In four steps you can update your installation to the latest release.
The Updater is available in phpList 3.3.7+.
The automatic updater requires the following PHP extensions: curl, zip and pdo.
The updater is currently performing the following steps. If one of those steps fail, you will have the possibility to correct the error and retry from the current step.
- Check if the user is authenticated (Only superadmins can update phpList)
- Check if there is an update available
- Check for write permissions
- Check whether all required phpList files are in place
- Ask the user if they want a backup of the software:
- Yes: ask the user for the location
- If no: continue to the next step.
- Download new version to a temporary folder
- Add maintenance mode
- Replace PHP entry points with "Update in progress" message
- Delete old files except config, updater and temporary directory
- Move new files in place
- Move new PHP entry points in place
- Move updater to a temporary directory
- Delete temporary files
- Remove maintenance mode
- Move new updater in place
- Deauthenticate updater session
- Redirect to the phpList dashboard
The whole phpList directory and the files within it must be writable by the HTTP user under which your web server is running as. If there is no match between the owner of your phpList files and the user under which your web server is running, you won’t be able to update. The ownership can be changed in a Linux terminal using this command:
chown -R user:group /path/to/phpList-directory
For instance:
chown -R www-data:www-data /var/www/lists
Change directory and file permissions:
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
Permissions vary from host to host. To find the HTTP user check the Apache Server configuration files. You can view a file's ownership, permissions, and other important information with the ls command, using the -la option:
ls -la file.php
The default Apache user and group for some Linux distributions are:
- Debian/Ubuntu: www-data
- Arch Linux: http
- Fedora/CentOS: apache
- openSUSE: user is wwwrun and the group is www
After you change the permissions, you can try again the update. After a successful update, please consider to re-apply any hardened directory permissions.
The updater is at the moment solely focused on replacing the files of the core installation. It does neither:
- Upgrade the database (this uses the existing database migration code)
- Upgrade the plugins (this uses the existing plugin updater)
- The updater stops when it finds unexpected files (not from phpList default installation) and lists them. To continue, you should delete these files or move them outside lists directory.
- It is possible to override the backup checks by reloading the page when the backup check fails. Do not reload the page unless you wish to proceed without a backup in this case.
- When the update process fails you should manually remove actions.txt file inside the config folder in order to reset the process and be able to try again.
- The config directory is required to be writable because the "current step" of the automatic updater is saved inside it.
At the moment only our current stable release, phpList 3, is supported by the updater. We’ll work on adding support to our upcoming phpList 4 release.