# 常规部署方式升级

# 概述

本文档将指导您如何升级使用常规部署方式的 Discuz! Q 。

TIP

常规部署方式升级，适用于：基于手动配置的环境、基于宝塔、基于镜像部署方式。

# 前提条件

已使用基于手动配置的环境、基于宝塔、基于镜像部署方式部署 Discuz! Q。

# 操作指南

常规部署方式支持以下两种升级方式，您可以根据您的具体需求进行选择。

# 使用 dl.php 自动升级方式（推荐）

使用浏览器访问 http(s)://<已安装部署成功的网址>/dl.php ,如官网 https://discuz.vip 则为 https://discuz.vip/dl.php 。如下图所示：

TIP

如果左上角 Logo 处没有版本号信息，请下载并替换最新版本的安装工具 (opens new window)，将下载的 dl.php 文件放置于 public 目录下。
为了安全，dl.php 每次运行完成后，会在其所在目录下生成 dl.php.lock 锁文件，升级前请先删除此文件。dl.php.lock位于public目录下。

单击【下一步】，Discuz! Q 将会对升级进行检查，检查成功后，在计划安装版本页面，选择需要升级的版本。如下图所示：

TIP

选择下载的版本号必须大于当前安装版本号，否则无法继续。
默认勾选【升级前删除原来的静态文件目录】，可根据实际需求进行选择。

单击【下一步】, Discuz! Q 将会自动执行升级。升级成功将会提示以下信息。如下图所示：

单击下一步完成升级。

# 手动升级方式

手动升级版本方式请根据您的现有版本与所需升级到的版本进行选择：

TIP

以下操作以使用 Nginx 服务为例。如您使用其他 Web 服务，建议您使用自动升级方式，或参考以下操作进行升级。
以下升级命令需按从上至下依次执行，否则将可能导致升级失败。

# 升级到v3.0.210926

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco init:activity

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210917

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:issue_at

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210902

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:removeNicknameBlank

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210819

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:addVotePermission

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210729

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:nicknameDuplicateRemoval

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210715

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco notifications:migration

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210713

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:stopWordsNicknameSet

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210706

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco postForeignKey:update

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210628

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:addUnpaidPermission

重启 Nignx 服务即可完成升级。

# 升级到v3.0.210609

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force
php disco upgrade:upgradeOldPermissionData
php disco upgrade:nicknameSet
php disco upgrade:bindType
php disco upgrade:questionMigration
php disco upgrade:noticeAdd
php disco thread:migration

修改您的网站主目录配置文件 config.php, 查找字段 'disks' =>的配置项添加如下内容：

 'background' =>[
                    'driver'    =>  'local',
                    'root'    =>  storage_path('app/public/background'),
                    'url'    =>  'background',
                    'visibility'    =>  'public',
                ],
'background_cos' => [
                    'driver' => 'cos',
                    'root' => storage_path('app/public/background'),
                    'url' => 'background',
                    'visibility' => 'public',
                ]

重启 Nignx 服务即可完成升级。

# 升级到v2.3.210528

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:noticeAdd

重启 Nignx 服务即可完成升级。

# 升级到v2.3.210412

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:noticeAdd
php disco upgrade:noticeIteration

重启 Nignx 服务即可完成升级。

# 升级到v2.3.210207

在终端中，进入您的 discuz 的主目录并运行以下命令即可完成升级。

php disco migrate --force
php disco upgrade:notice
php disco upgrade:notice-iteration
php disco upgrade:groupPermissionAdd
php disco upgrade:settingAdd

TIP

升级成功前如您已设置为红色主题，升级成功后将默认回退为蓝色主题，您需在 Discuz! Q 管理后台重新设置为红色主题。

# 升级到v2.3.210202

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:notice
php disco upgrade:notice-iteration
php disco upgrade:groupPermissionAdd
php disco upgrade:settingAdd

重启 Nignx 服务即可完成升级。

# 升级到v2.1.201113

在终端中，进入您的 discuz 的主目录并运行以下命令。

php disco migrate --force
php disco upgrade:split-permissions
php disco site:switch

修改您的 Nginx 配置文件 nginx.conf 的 index 配置项，修改为以下参数。

index index.php index.html;

重启 Nignx 服务即可完成升级。

# 升级到v2.1.201029

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force
php disco upgrade:notice

修改网站主目录下的 config.php 配置文件, 查找字段 'providers' =>的配置修改为以下内容：

 'providers' => [
        App\Formatter\FormatterServiceProvider::class,
        App\Passport\Oauth2ServiceProvider::class,
        App\Providers\AppServiceProvider::class,
        App\Providers\AttachmentServiceProvider::class,
        App\Providers\CategoryServiceProvider::class,
        App\Providers\EventServiceProvider::class,
        App\Providers\OrderServiceProvider::class,
        App\Providers\PostServiceProvider::class,
        App\Providers\SettingsServiceProvider::class,
        App\Providers\ThreadServiceProvider::class,
        App\Providers\UserServiceProvider::class,
        App\Providers\DialogMessageServiceProvider::class,
        App\Providers\QuestionServiceProvider::class,
    ],

重启 Nignx 服务即可完成升级。

# 升级到v2.0.201001、v1.0.200911、v1.0.200821、v1.0.200806、v1.0.200723、v1.0.200715、v1.0.200707、v1.0.200705、v0.5.200522、v0.5.200424

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force

重启 Nignx 服务即可完成升级。

# 升级到v1.0.200710

1.需配置PHP，启用 exif 扩展。

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force

重启 Nignx 服务即可完成升级。

# 升级到v1.0.200703

修改 Web 服务配置，修改内容请查看：Ngnix服务。
在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force
php disco upgrade:category-permission 
php disco upgrade:videoSize
php disco upgrade:notice

修改网站主目录下的 config.php 配置文件，将字段 'providers' => 的配置项修改为以下内容：

'providers' => [
    App\Formatter\FormatterServiceProvider::class,
    App\Passport\Oauth2ServiceProvider::class,
    App\Providers\AppServiceProvider::class,
    App\Providers\AttachmentServiceProvider::class,
    App\Providers\CategoryServiceProvider::class,
    App\Providers\EventServiceProvider::class,
    App\Providers\OrderServiceProvider::class,
    App\Providers\PostServiceProvider::class,
    App\Providers\SettingsServiceProvider::class,
    App\Providers\ThreadServiceProvider::class,
    App\Providers\UserServiceProvider::class,
    App\Providers\DialogMessageServiceProvider::class,
],

重启 Nignx 服务即可完成升级。

# 升级到v0.5.200508

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force

重启 Nignx 服务即可完成升级。

TIP

如果运行以上脚本时出现错误，请下载此文件 (opens new window)，替换 discuz 主目录下的 database/migrations 目录下的同名文件，然后再次执行 php disco migrate --force.

# 升级到v0.5.200410

附件图片统一接入对象存储服务后，需要重新配置”后台-全局-腾讯云设置-对象存储“中的“访问域名”。访问域名获取方式为：“腾讯云-对象存储-存储桶列表-配置管理-基本配置”中的“访问域名”（详见使用手册 (opens new window)“2.2.7.6对象存储”部分说明）。
修改网站主目录下的 config.php 配置文件，将字段 attachment 修改为以下配置：

'attachment' => [

修改为：

'attachment_cos' => [

并在此配置之前加入以下配置：

'attachment' => [
    'driver' => 'local',
    'root'   => storage_path('app'),
    'url'    => 'attachment'
],

最终配置如下所示：

'attachment' => [
    'driver' => 'local',
    'root'   => storage_path('app'),
    'url'    => 'attachment'
],
'attachment_cos' => [
    'driver' => 'cos',
    'root'   => storage_path('app/public/attachment'),
    'url'    => 'attachment'
],

重启 Nignx 服务即可完成升级。

# 升级到v0.4.200331

按 v0.4.200331 升级的要求完成数据库升级和配置文件修改即可完成升级。

# 从任意版本升级到 v0.4.200331

在终端中，进入您的 discuz 的主目录并运行以下命令:

php disco migrate --force

修改网站主目录下的 config.php 配置文件，在attachment字段之前，加入以下配置：

'avatar_cos' => [
  'driver' => 'cos',
  'root' => storage_path('app/public/avatars'),
  'url' => 'avatar',
  'visibility' => 'public',
],

# 从任意版本升级到 v0.4.200327

需要在完成以上步骤后，在终端中，进入您的 discuz 的主目录并运行以下命令:、

php disco migrate --force

重启 Nignx 服务即可完成升级。

← 其他服务设置 Docker容器部署方式升级 →