cakephp/upgrade

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

维护者

详细信息

github.com/cakephp/upgrade

主页

源代码

问题

安装: 793

依赖: 0

建议者: 0

安全: 0

星标: 110

关注者: 25

分支: 60

开放问题: 7

类型:rector-extension

5.x-dev 2024-09-13 13:32 UTC

Requires

MIT aa8d73e3678ac17783986b4506edf7ab5477a84d

This package is auto-updated.

Last update: 2024-09-13 13:32:48 UTC

README

CI

CakePHP的升级工具，旨在简化在CakePHP 4.x版本之间以及从CakePHP 4.x迁移到CakePHP 5.x的过程。此仓库应作为独立应用程序使用，而非作为插件。

安装

首先克隆此仓库或下载zip压缩包

git clone git://github.com/cakephp/upgrade

然后使用composer安装依赖项

php composer.phar install --no-dev

用法

升级工具提供了一个独立的应用程序，可用于升级其他应用程序或CakePHP插件。每个子命令都接受一个指向您想要升级的应用程序的路径。

CakePHP 4.x版本之间的升级

在升级到CakePHP 4.x版本时，rector命令可以自动化许多弃用警告的更新。要从rector命令中获得最大价值，您应确保添加尽可能多的类型提示或参数文档注释。如果没有这些注释或类型提示，rector将无法像预期那样有效，因为它无法推断类型。

cd /path/to/upgrade

# To apply upgrade rules from 4.3 to 4.4
bin/cake upgrade rector --rules cakephp44 /path/to/your/app/src

包括以下规则：

  • cakephp41
  • cakephp42
  • cakephp43
  • cakephp44

CakePHP 3.x到CakePHP 4.x的升级

升级工具应在您更新应用程序依赖项到4.0之前运行。如果您的应用程序已经将依赖项更新到4.x，基于rector的任务将无法正确运行。

安装升级工具依赖项后，应运行以下命令：

cd /path/to/upgrade

# Run all upgrade tasks at once.
bin/cake upgrade /home/mark/Sites/my-app

# OR run upgrade tasks individually.
# Rename locale files
bin/cake upgrade file_rename locales /home/mark/Sites/my-app

# Rename template files
bin/cake upgrade file_rename templates /home/mark/Sites/my-app

# Run rector rules.
bin/cake upgrade rector /home/mark/Sites/my-app/src
bin/cake upgrade rector /home/mark/Sites/my-app/tests
bin/cake upgrade rector /home/mark/Sites/my-app/config

开发

为了简化安装和用法，此包在composer.json中不使用require-dev，因为已安装的PHPUnit和CakePHP包会与rector任务冲突。

要安装开发依赖项，请使用make install-dev。然后您将能够运行vendor/bin/phpunit。您还可以使用make test安装依赖项并运行测试。