Advanced Update (Expert users)



This update method should only be used for installations with modifications to core phpBB files. If you simply use Extensions or custom Styles and have not modified core files, please use the Full Package update.

This update was renamed from Automatic Update to Advanced Update to more clearly state that it should only be used by advanced users.

This package detects changed files and merges in changes if needed. Since this type of update has a potential to cause issues while upgrading, it is not recommended being used for updates and/or upgrades.

A number of advanced update files are available, and you should choose the one that corresponds to the version of the board that you are currently running. For example, if your current version is 3.3.0 and you are updating to 3.3.1, you need the phpBB-3.3.0_to_3.3.1.zip/tar.bz2 file.

  1. Make a backup of the original files

  2. Make a backup of the database

  3. Locally, perform for the following steps:

    1. Download the phpBB 3.3 Advanced Update archive

    2. Extract the install/ directory

    3. Extract the vendor/ directory

  4. On your web server, delete the vendor/ directory

  5. Upload the install/ directory

  6. Upload the vendor/ directory

  7. Run the updater:

    Tip

    For large boards, you may wish to update the database via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode

    1. Using your web browser, visit /install in your board's root (e.g. http://www.example.com/yourforum/install).

    2. Click the Update tab

    3. Click Update

    4. Select "Update filesystem and database" and click Submit

    5. Depending on file ownership, there are several options available to perform this update:

      • Download modified files in an archive: This will generate an archive containing all of the updated files. After downloading it, you upload its contents to the server.

      • Update files via FTP (Automatic): You provide FTP credentials and file paths so that the server may FTP the files in place.

      • Update files via direct access (Automatic): If the web server has write permissions, the updater can write the changes directly to the files

      If there are conflicts, you will be prompted to resolve them.

    6. Click Update Files

    7. Click "Continue Update Process" to update the database

  8. Delete the install/ directory on the server