{"id":13684331,"url":"https://github.com/dereuromark/upgrade","last_synced_at":"2025-04-30T20:33:50.646Z","repository":{"id":25103872,"uuid":"28525136","full_name":"dereuromark/upgrade","owner":"dereuromark","description":"Upgrade tools for CakePHP meant to facilitate migrating from one version of the framework to another","archived":false,"fork":true,"pushed_at":"2024-10-15T22:27:41.000Z","size":650,"stargazers_count":24,"open_issues_count":1,"forks_count":5,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-12T05:37:19.213Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"cakephp/upgrade","license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dereuromark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-12-27T00:51:13.000Z","updated_at":"2024-10-15T22:27:45.000Z","dependencies_parsed_at":"2023-02-15T07:20:49.535Z","dependency_job_id":null,"html_url":"https://github.com/dereuromark/upgrade","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fupgrade","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fupgrade/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fupgrade/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dereuromark%2Fupgrade/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dereuromark","download_url":"https://codeload.github.com/dereuromark/upgrade/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251777758,"owners_count":21642219,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T14:00:32.296Z","updated_at":"2025-04-30T20:33:50.340Z","avatar_url":"https://github.com/dereuromark.png","language":"PHP","funding_links":[],"categories":["Migration","Plugins"],"sub_categories":["Migration"],"readme":"# CakePHP Upgrade tool\n[![CI](https://github.com/dereuromark/upgrade/actions/workflows/ci.yml/badge.svg)](https://github.com/dereuromark/upgrade/actions/workflows/ci.yml)\n[![Minimum PHP Version](https://img.shields.io/badge/php-%3E%3D%208.1-8892BF.svg)](https://php.net/)\n[![PHPStan](https://img.shields.io/badge/PHPStan-level%207-brightgreen.svg?style=flat)](https://phpstan.org/)\n[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](LICENSE)\n\n\nUpgrade tool as standalone application for CakePHP meant to facilitate migrating\n- ~~from CakePHP 2.x to 3.x.~~ [EOL]\n- ~~supports the minor upgrades in 3.x - up until currently 3.8+.~~ [EOL]\n- ~~supports basic stuff for 4.x~~ [See cake4 branch]\n- supports basic stuff for 5.x + extension development possible\n\n**Warning** This tool is still under development and doesn't handle all aspects of migrating.\n\n---\n\n### CakePHP 5\n\nThe brand new upgrade command of this tool provides a configurable approach.\nDefine sets/levels and run it over your app or plugin:\n\n```\nbin/cake upgrade files /path/to/repo -v -d\n```\nKeep verbose and dry-run for checking if it works as expected, then apply your changes for real.\n\nThis tool works best in combination with the official [upgrade](https://github.com/cakephp/upgrade/) tool and its rector based approaches.\n- dereuromark/upgrade handles basic cases and non-PHP files\n- cakephp/upgrade handles PHP class files via rector (requires valid PHP files)\n\nIf rector fails or cannot handle your app, you can try to use this tool completely by defining more regex\nbased rules for example.\n\nYou can check active vs available tasks using `--help` together with `-v`.\nIt will list all available ones, active ones are in green.\n\nFor docs on this check [here](docs/Upgrade.md).\n\n---\n\n## Installation\n\nThis plugin is standalone. Do not try to mix this with your existing app. Instead, put it somewhere completely separate from it.\nBest to clone it (git clone ....).\n\nAfter downloading/cloning the upgrade tool, you need to install dependencies with `composer`\n\n```bash\ncomposer install\n```\n\nOnce dependencies are installed you can start using the `upgrade` shell.\n\nNote: If you want to get the latest master, you can run `composer update` at your own risk.\nIt will download also all recent changes done.\nAlternatively, you can lock it down to a stable version and then update.\n\n## IMPORTANT NOTICE\n\nThis tool is an add-on to original CakePHP upgrade tool and provides additional fixers:\n- Skeleton\n\nThe FileUpgrade tool also:\n- see `src/Task/?` (tons of custom fixes)\n\nFeel free to manually port those things back into the core one.\n\n## Usage\n\n### Upgrade command\nImportant upgrade steps:\n- Skeleton upgrade (all skeleton files)\n\n```bash\nbin/cake upgrade /home/mark/Sites/my-app\n```\n\n### Upgrade files\nSee above `bin/cake upgrade files` docs.\n\n### Upgrade legacy shell\nSee cake4 branch.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdereuromark%2Fupgrade","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdereuromark%2Fupgrade","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdereuromark%2Fupgrade/lists"}