dereuromark/upgrade-cakephp

此软件包已被废弃且不再维护。作者建议使用 dereuromark/cakephp-upgrade 软件包代替。

用于更新 CakePHP 应用程序和插件的命令行工具。

dev-master 2023-12-02 21:47 UTC

This package is auto-updated.

Last update: 2024-06-03 20:29:48 UTC


README

CI Minimum PHP Version PHPStan Software License

作为 CakePHP 的独立应用程序的升级工具,旨在简化迁移过程

  • 从 CakePHP 2.x 升级到 3.x。 [已停止开发]
  • 支持 3.x 的次要升级 - 目前支持到 3.8+。 [已停止开发]
  • 支持 4.x 的一些基本功能 [查看 cake4 分支]
  • 支持 5.x 及扩展开发

警告 此工具仍在开发中,无法处理迁移的所有方面。

CakePHP 5

此工具的新升级命令提供了一个可配置的方法。定义集/级别,并在您的应用程序或插件上运行它

bin/cake upgrade files /path/to/repo -v -d

为了检查是否按预期工作,请保持详细和模拟运行,然后应用实际更改。

此工具与官方 upgrade 工具及其基于 rector 的方法结合使用最佳。

  • dereuromark/upgrade 处理基本情况和非 PHP 文件
  • cakephp/upgrade 通过 rector 处理 PHP 类文件(需要有效的 PHP 文件)

如果 rector 失败或无法处理您的应用程序,您可以通过定义更多基于正则表达式的规则来完全使用此工具。

您可以使用 --help-v 检查活动任务与可用任务。它将列出所有可用任务,活动任务以绿色显示。

有关此方面的文档请参阅 此处

安装

此插件是独立的。不要将其与现有的应用程序混合使用。相反,将其放在完全独立的位置。最好克隆它(git clone ....)。

下载/克隆升级工具后,您需要使用 composer 安装依赖项。

composer install

依赖项安装完成后,您就可以开始使用 upgrade shell 了。

注意:如果您想获取最新的 master,可以运行 composer update,但请自行承担风险。这将下载所有最近所做的更改。或者,您可以将它锁定在稳定版本,然后更新。

重要通知

此工具是原始 CakePHP 升级工具的附加组件,并提供了额外的修正程序

  • 骨架

FileUpgrade 工具也

  • 查看 src/Task/?(大量自定义修正)

您可以将这些内容手动移植回核心。

用法

升级命令

重要的升级步骤

  • 骨架升级(所有骨架文件)
bin/cake upgrade /home/mark/Sites/my-app

升级文件

请参阅上述 bin/cake upgrade files 文档。

升级旧版 shell

请参阅 cake4 分支。