alsvanzelf / debby
Debby会检查您的项目依赖项,并告诉您何时更新。
Requires
- php: >=5.5
Suggests
- swiftmailer/swiftmailer: Required for sending updates via email
README
此包已不再维护。作为替代,您可以使用dependabot和GitHub钩子来获取通知。
Debby - 保持对依赖项的控制
Debby会检查您的Composer & npm依赖项,并告诉您何时更新。
- 始终运行最新版本
- 选择您是否对更新感兴趣
- 能够及时修复安全漏洞
最终,您会感到更舒适地升级,因为更新可以频繁且小规模地进行。
超快速设置 🚀
composer require alsvanzelf/debby crontab -l | { cat; echo "0 8 * * * php /www/vendor/alsvanzelf/debby/notify.php repo token"; } | crontab -
将 repo
替换为GitHub上您的仓库路径(organization/project
),将 token
替换为个人访问令牌。这将使Debby每天早上8点运行,并在发现更新时创建问题。
以常规速度设置,附带更多说明
- 通过Composer安装Debby
- 配置通知到GitHub、Trello、Slack、电子邮件
- 设置cronjob(还有其他方法,见下文)
也可以查看Debby经常被问到的问题。或者查看📘 文档。
1. 安装
使用Composer安装Debby。使用require获取最新稳定版本
composer require alsvanzelf/debby
2. 配置通知
Debby可以与 GitHub问题、
Trello、
Slack以及
电子邮件进行通信。
选择您想要接收通知的渠道,创建一个包含这些渠道访问详情的debby.json
配置文件,并将其放置在项目根目录中。
例如,对于通知 GitHub 问题,请使用以下方法:
{ "notify_github": { "repository": "example/project", "token": "personal access token" } }
请参阅📘 wiki 以了解具体的配置信息。
3. 启动
设置一个 cronjob 来运行内置的通知脚本,并将您的配置文件传递给它。
运行 crontab -e
并添加以下内容:
0 8 * * * php /var/www/vendor/alsvanzelf/debby/notify.php /var/www/debby.json
👍
休息一下,放松一下。喝一杯☕️或🍵或🍺
常见问题解答(FAQ)
能否不使用 cronjob 运行它?
您可以从 PHP 调用 Debby 并执行您想要的任何操作。
$options = [ 'notify_github' => [ 'repository' => 'example/project', 'token' => 'personal access token', ], ]; $debby = new debby\debby($options); $packages = $debby->check(); $debby->notify($packages);
请参阅 example/custom.php 以获取完整的示例。
我不想在生产环境中运行 Debby
您不信任她?要知道,她是开源的。无论如何,Debby 在测试环境中运行得很好。没有恶意。❤️ 只要注意,Debby 在回滚旧提交时也会运行得很好,并会通知您从那时起的所有更新。另外,请注意,Debby 缓存了之前通知的包,这可能在向后切换分支时引起麻烦。
Debby 不能确定管理路径?
或者
我能否将 composer.json 放在项目根目录之外?
或者
我不想检查 [Composer|npm|...]?
默认情况下,Debby 会检查它能够找到的所有包管理器。在某些情况下,这可能不起作用。例如:
- Debby 不是通过 Composer 安装的。
- 包管理器 json 文件位于自定义位置。
- 您有一个您不希望检查的包管理器。
- 您使用看起来像来自包管理器的文件(例如,当您不使用 npm 时使用 package.json)。
那么您需要调整配置以指定您想要检查的管理器以及它们的位置。
例如,为了检查 Composer,请将以下内容添加到您的 debby.json
文件中:
"check_composer": { "path": "/path/to/composerjson/" }
请参阅📘 wiki 了解具体的配置信息。
为什么 Debby 告诉我更新高于 composer 限制?
当您需要 ^1.5
时,Debby 会告诉您有关更新(例如 2.0
)。如果您自己运行 composer update
,则该更新不会显示。然而,新版本可能包含影响您旧版本的安全更新。目前,Debby 默认会告诉您所有这些更新。欢迎您帮助 Debby 在此方面变得更智能,例如检查安全更新。
贡献
欢迎 Pull Requests 或 issues!
许可
👧
顺便说一句,当 Debby 需要更新时,她会告诉您。您不需要做任何事情。✨