README

Yii 2 项目自更新扩展

此扩展允许在项目源代码通过版本控制系统（如GIT或Mercurial）维护的情况下自动更新项目。此类更新包括以下步骤

• 检查VCS远程仓库是否有任何更改
• 在项目更新运行时，将Web服务器的Web目录链接到占位符
• 应用远程VCS更改
• 通过Composer更新'vendor'目录
• 清除应用程序缓存和临时目录
• 执行附加操作，如应用数据库迁移
• 在更新完成后，将Web服务器Web目录链接到项目Web目录
• 通过电子邮件通知开发人员更新结果

注意：此解决方案非常基础，可能不适用于复杂的项目更新工作流程。您可以考虑使用更复杂的工具，如Phing。然而，此扩展可以作为此类解决方案的一部分使用。

有关许可证信息，请参阅LICENSE文件。

要求

此扩展需要Linux操作系统。

安装

安装此扩展的首选方法是使用composer。

运行以下命令：

php composer.phar require --prefer-dist yii2tech/selfupdate

或者将以下内容添加到您的composer.json文件的require部分：

"yii2tech/selfupdate": "*"

使用

此扩展提供特殊的控制台控制器 [[yii2tech\selfupdate\SelfUpdateController]]，允许在源代码通过版本控制系统维护的情况下自动更新项目。要启用此控制器，您应在配置文件中将它添加到您的控制台应用程序的controllerMap

return [
    'controllerMap' => [
        'self-update' => 'yii2tech\selfupdate\SelfUpdateController'
    ],
    // ...
];

现在您应该能够通过控制台使用“self-update”命令

yii self-update

项目准备

为了使用“self-update”命令，您应在项目中进行一些准备，以便在非交互式（无用户提示）模式下执行某些shell命令。

首先，您应该从版本控制系统克隆（检出）您的项目，并将项目工作副本切换到特定服务器应使用的分支。使用GIT，可以通过以下命令执行这些操作：

cd /path/to/my/project
git clone git@my-git-server.com/myproject.git
git checkout production

注意：您需要以与远程仓库交互不要求用户提示的方式配置您的VCS（或者至少您的项目工作副本），例如输入用户名或密码！这可以通过使用身份验证密钥或“记住密码”功能来实现。

然后，您应该执行所有必要的操作以使项目可用，例如运行'composer install'、创建必要的目录等。

使用自更新命令

一旦项目设置完成，您需要为其更新创建一个配置。这可以通过使用'self-update/config'命令来完成。

yii self-update/config @app/config/self-update.php

这将生成配置文件，根据特定的项目结构和服务器环境，可能手动调整。对于常见项目，此类配置文件可能如下所示

<?php

return [
    // list of email addresses, which should be used to send execution reports
    'emails' => [
        'developer@domain.com',
    ],
    // Mailer component to be used
    'mailer' => 'mailer',
    // Mutex component to be used
    'mutex' => 'mutex',
    // path to project root directory (VCS root directory)
    'projectRootPath' => '@app',
    // web path stubs configuration
    'webPaths' => [
        [
            'path' => '@app/web',
            'link' => '@app/httpdocs',
            'stub' => '@app/webstub',
        ],
    ],
    // cache components to be flushed
    'cache' => [
        'cache'
    ],
    // temporary directories, which should be cleared after project update
    'tmpDirectories' => [
        '@app/web/assets',
        '@runtime/URI',
        '@runtime/HTML',
        '@runtime/debug',
    ],
    // list of shell commands, which should be executed after project update
    'afterUpdateCommands' => [
        'php ' . escapeshellarg($_SERVER['SCRIPT_FILENAME']) . ' migrate/up --interactive=0',
    ],
];

请参阅[[\yii2tech\selfupdate\SelfUpdateController]]以获取特定选项信息。

一旦您在配置文件中完成所有必要的调整，您可以使用它运行'self-update/perform'命令。

yii self-update @app/config/self-update.php

您可以通过在controllerMap规范内部设置默认配置文件名来设置[[yii2tech\selfupdate\SelfUpdateController::$configFile]]

return [
    'controllerMap' => [
        'self-update' => [
            'class' => 'yii2tech\selfupdate\SelfUpdateController',
            'configFile' => '@app/config/self-update.php',
        ]
    ],
    // ...
];

然后，调用自更新命令将更加清晰。

yii self-update

注意：没有必要创建单独的配置文件：您可以在controllerMap规范内部配置[[yii2tech\selfupdate\SelfUpdateController]]的所有必要字段，但这种方法不建议使用。

自更新工作流程

在运行时，[[yii2tech\selfupdate\SelfUpdateController]]执行以下步骤

• 检查VCS远程仓库是否有任何更改
• 在项目更新运行时，将Web服务器的Web目录链接到占位符
• 应用远程VCS更改
• 通过Composer更新'vendor'目录
• 清除应用程序缓存和临时目录
• 执行附加操作，如应用数据库迁移
• 在更新完成后，将Web服务器Web目录链接到项目Web目录
• 通过电子邮件通知开发人员更新结果

在第一阶段，会检查远程仓库中是否有任何更改。如果没有在远程仓库中对当前项目VCS工作副本分支进行更改，则不会执行任何进一步操作！

如果检测到远程更改，指向项目'@web'目录的符号链接将切换到另一个目录，该目录应包含一个'stub' - 一些静态HTML页面，其中说明“应用程序正在维护中，请稍后再试”。虽然，是否使用此类stub由您决定，但建议这样做，因为实际的项目更新可能需要很长时间才能完成。在所有更新操作完成后，将链接回项目Web目录而不是stub。

在更新过程中，VCS远程更改会被应用，通过Composer更新vendor目录，指定的临时目录将被清除，缓存将被刷新。

注意：为了使Composer能够应用必要的更改，'composer.lock'文件应该由版本控制系统跟踪！