Upgrading from 3.0 to 3.1



Upgrading to phpBB 3.1 will render previously installed MODifications and styles unusable.

phpBB 3.1 is not compatible with 3.0 and most of the previous files will need to be removed prior to upgrading to 3.1.

To upgrade, perform the following steps:

  1. Ensure that your server meets the requirements for running phpBB 3.1: Section 1.1, “Requirements”

  2. Make a backup of the original files

  3. Make a backup of the database

  4. Download the phpBB 3.1 Full Package archive

  5. Extract the contents of the archive to your computer and open the phpBB3 directory

  6. Delete the following files from the package:

    • The config.php file

    • The images/ directory

    • The files/ directory

    • The store/ directory

  7. On your website, delete all files from your board EXCEPT for:

    • The config.php file

    • The images/ directory

    • The files/ directory

    • The store/ directory

  8. Upload the contents of the phpBB3 directory from your computer to your forum's directory. You may be prompted to overwrite the remaining files. If prompted to merge or overwrite directories, choose to merge them.

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

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

  10. Delete the install/ directory

Note

Ensure that the root level .htaccess file is included in the upload. Some FTP clients do not show files whose names start with a period and you may need to enable the display of hidden files.

Note

If your board made use of language packs other than British English, you will need to download a version that is compatible with phpBB 3.1 from https://www.phpbb.com/languages/

Important

When uploading the 3.1 files to your server, do NOT overwrite your config.php.

Important

When backing up your files, ensure that your FTP client is in binary mode or transfers files without extensions in binary mode.

For more information, see: Knowledge Base: Transferring attachment files with Filezilla

Article comments are temporarily disabled