PHPackages                             dereuromark/upgrade-cakephp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI &amp; Console](/categories/cli)
4. /
5. dereuromark/upgrade-cakephp

Abandoned → [dereuromark/cakephp-upgrade](/?search=dereuromark%2Fcakephp-upgrade)Library[CLI &amp; Console](/categories/cli)

dereuromark/upgrade-cakephp
===========================

Command line tool for updating CakePHP applications and plugins.

231715[1 issues](https://github.com/dereuromark/upgrade/issues)PHP

Since Aug 30Pushed 5mo ago3 watchersCompare

[ Source](https://github.com/dereuromark/upgrade)[ Packagist](https://packagist.org/packages/dereuromark/upgrade-cakephp)[ RSS](/packages/dereuromark-upgrade-cakephp/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

CakePHP Upgrade tool
====================

[](#cakephp-upgrade-tool)

[![CI](https://github.com/dereuromark/upgrade/actions/workflows/ci.yml/badge.svg)](https://github.com/dereuromark/upgrade/actions/workflows/ci.yml)[![Minimum PHP Version](https://camo.githubusercontent.com/183804d09fec16ca7b6209b007250b7d8db1b915042feb093a9f20e6e1f25359/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344253230382e312d3838393242462e737667)](https://php.net/)[![PHPStan](https://camo.githubusercontent.com/ff9142aa79e58bd482fac3aff00d4bea75e9b4a0e2f4908bb26d1b7f5df3a5ab/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048505374616e2d6c6576656c253230372d627269676874677265656e2e7376673f7374796c653d666c6174)](https://phpstan.org/)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Upgrade tool as standalone application for CakePHP meant to facilitate migrating

- from CakePHP 2.x to 3.x. \[EOL\]
- supports the minor upgrades in 3.x - up until currently 3.8+. \[EOL\]
- supports basic stuff for 4.x \[See cake4 branch\]
- supports basic stuff for 5.x + extension development possible

**Warning** This tool is still under development and doesn't handle all aspects of migrating.

---

### CakePHP 5

[](#cakephp-5)

The brand new upgrade command of this tool provides a configurable approach. Define sets/levels and run it over your app or plugin:

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

```

Keep verbose and dry-run for checking if it works as expected, then apply your changes for real.

This tool works best in combination with the official [upgrade](https://github.com/cakephp/upgrade/) tool and its rector based approaches.

- dereuromark/upgrade handles basic cases and non-PHP files
- cakephp/upgrade handles PHP class files via rector (requires valid PHP files)

If rector fails or cannot handle your app, you can try to use this tool completely by defining more regex based rules for example.

You can check active vs available tasks using `--help` together with `-v`. It will list all available ones, active ones are in green.

For docs on this check [here](docs/Upgrade.md).

---

Installation
------------

[](#installation)

This plugin is standalone. Do not try to mix this with your existing app. Instead, put it somewhere completely separate from it. Best to clone it (git clone ....).

After downloading/cloning the upgrade tool, you need to install dependencies with `composer`

```
composer install
```

Once dependencies are installed you can start using the `upgrade` shell.

Note: If you want to get the latest master, you can run `composer update` at your own risk. It will download also all recent changes done. Alternatively, you can lock it down to a stable version and then update.

IMPORTANT NOTICE
----------------

[](#important-notice)

This tool is an add-on to original CakePHP upgrade tool and provides additional fixers:

- Skeleton

The FileUpgrade tool also:

- see `src/Task/?` (tons of custom fixes)

Feel free to manually port those things back into the core one.

Usage
-----

[](#usage)

### Upgrade command

[](#upgrade-command)

Important upgrade steps:

- Skeleton upgrade (all skeleton files)

```
bin/cake upgrade /home/mark/Sites/my-app
```

### Upgrade files

[](#upgrade-files)

See above `bin/cake upgrade files` docs.

### Upgrade legacy shell

[](#upgrade-legacy-shell)

See cake4 branch.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance48

Moderate activity, may be stable

Popularity22

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/39854?v=4)[Mark Scherer](/maintainers/dereuromark)[@dereuromark](https://github.com/dereuromark)

---

Top Contributors

[![dereuromark](https://avatars.githubusercontent.com/u/39854?v=4)](https://github.com/dereuromark "dereuromark (94 commits)")[![markstory](https://avatars.githubusercontent.com/u/24086?v=4)](https://github.com/markstory "markstory (56 commits)")[![AD7six](https://avatars.githubusercontent.com/u/33387?v=4)](https://github.com/AD7six "AD7six (23 commits)")[![ADmad](https://avatars.githubusercontent.com/u/142658?v=4)](https://github.com/ADmad "ADmad (13 commits)")[![lorenzo](https://avatars.githubusercontent.com/u/37621?v=4)](https://github.com/lorenzo "lorenzo (9 commits)")[![ceeram](https://avatars.githubusercontent.com/u/111448?v=4)](https://github.com/ceeram "ceeram (7 commits)")[![antograssiot](https://avatars.githubusercontent.com/u/4977112?v=4)](https://github.com/antograssiot "antograssiot (3 commits)")[![hmic](https://avatars.githubusercontent.com/u/876917?v=4)](https://github.com/hmic "hmic (2 commits)")[![bcrowe](https://avatars.githubusercontent.com/u/752603?v=4)](https://github.com/bcrowe "bcrowe (2 commits)")[![renan](https://avatars.githubusercontent.com/u/28046?v=4)](https://github.com/renan "renan (2 commits)")[![jadb](https://avatars.githubusercontent.com/u/33527?v=4)](https://github.com/jadb "jadb (1 commits)")[![aloross](https://avatars.githubusercontent.com/u/3404824?v=4)](https://github.com/aloross "aloross (1 commits)")[![rikvdh](https://avatars.githubusercontent.com/u/1267617?v=4)](https://github.com/rikvdh "rikvdh (1 commits)")[![jrbasso](https://avatars.githubusercontent.com/u/26548?v=4)](https://github.com/jrbasso "jrbasso (1 commits)")

### Embed Badge

![Health badge](/badges/dereuromark-upgrade-cakephp/health.svg)

```
[![Health](https://phpackages.com/badges/dereuromark-upgrade-cakephp/health.svg)](https://phpackages.com/packages/dereuromark-upgrade-cakephp)
```

###  Alternatives

[wp-cli/wp-cli

WP-CLI framework

5.0k17.2M319](/packages/wp-cli-wp-cli)[consolidation/annotated-command

Initialize Symfony Console commands from annotated command class methods.

22569.8M18](/packages/consolidation-annotated-command)[chi-teck/drupal-code-generator

Drupal code generator

26947.8M5](/packages/chi-teck-drupal-code-generator)[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24725.8M17](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

12944.1M5.1k](/packages/illuminate-console)[php-tui/php-tui

Comprehensive TUI library heavily influenced by Ratatui

589747.0k6](/packages/php-tui-php-tui)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
