Forgot Password
 Register
View: 3|Reply: 0

Notes on Upgrading Discuz! X3.5 to X5.0

[Copy Link]
Posted on yesterday 16:59 | Show all floors |Read Mode
Before downloading, installing, or upgrading to X5.0, please read this article first. There's quite a bit of content, but if you take the time to read it carefully, you'll definitely find it valuable.
【Environment Requirements】
Starting from X5.0, the minimum PHP requirement has been raised to PHP 8.0. If your PHP environment does not meet this requirement, please upgrade to PHP 8.0 first.
If you are using an older version of Discuz! with a community version lower than X3.5, please upgrade to X3.5 first. For sites already on X3.5, you can upgrade directly through the normal installation process. Additionally, the installer includes a built-in toolkit, so experienced webmasters who are familiar with the system don't need to ask why the utility directory has disappeared.
For details, please read: "Discuz! X5 Installer Optimizations"
【About Upgrading】
Below is the original text regarding the upgrade method from the installer, provided for reference for webmasters who have not yet started the upgrade:
1. Ensure that your old version of Discuz! is exactly X3.5. If it does not meet the version requirement, please upgrade to this version first.
2. Ensure that UCenter and Discuz! are deployed in the same database.
3. Ensure that you have backed up the database and program files, and move the old version program files to another directory.
4. Copy the configuration files `config/config_global.php` and `config/config_ucenter.php` from the old version to the `config/` directory of the new version.
5. Click "Next" to begin the upgrade.
6. After the upgrade is complete, selectively copy plugin files from the `source/plugin/` directory of the old version to the corresponding directory of the new version, and selectively copy template files from the `template/` directory of the old version to the corresponding directory of the new version (do not copy the `template/default/` directory).
7. After the upgrade is complete, copy the `data/attachment/` directory and other directories under the `data/` directory as appropriate. If the old version involves files in other directories, consult the relevant developers for copying instructions.

【Plugin and Template Compatibility】

1. **Plugins:** Officially, the X3.5 version already mandated full compatibility with PHP 8.0. If the plugins you are using are already compatible, congratulations—you can use them directly in X5.0. Otherwise, it means those plugins have fallen behind by two major version iterations. Please urge the plugin developers to quickly adapt to PHP 8.0.

2. **Templates:** Strictly speaking, X5.0 templates cannot be 100% compatible with X3.5 templates, but they should not be completely unusable either. However, you may encounter issues when using certain new features. Therefore, please also urge template developers to quickly adapt to X5.0.

【Upgrade Patches】

Starting from X5.0, the official team will no longer release separate upgrade patch packages when new versions are published, because X5.0 will provide its own patching mechanism. When a new version is released, you can use the "Upgrade Patch" feature in the Admin Center to download the patch files and then upload and overwrite them. To use this feature, please ensure that your PHP installation includes the zip extension. If you are unable to use X5.0's built-in patch download feature properly, you can simply download the full official release package and overwrite your existing files.

Friendly Reminder: The official release packages will be updated on a tri-monthly schedule—specifically, on the 1st, 10th, and 20th of each month. If there are only a few changed files or no significant updates, the release may be skipped. Webmasters are encouraged to check back regularly.

Reply

Use Props Report

You need to log in before you can reply Login | Register

Forum Credit Rules

Close

Editors SelectedPrevious /2 Next

Archiver|Mobile|Darkroom|Privacy|DSC

GMT+7, 2026-04-10 04:06 , Processed in 0.011100 second(s), 22 queries .

Powered by Discuz! X3.5

© 2001-2026 Discuz! Team.

Quick Reply Back to Top Return to List