CakePHP 3 manual installation

Question

Currently I use CakePHP 2.6.8. I want to migrate to CakePHP 3. Intallation guide recommends to use Composer. But composer doesn't make all jobs done, and documentation isn't clear. So I need a step by step guide.

Current input is 2.x directory structure:
https://github.com/cakephp/cakephp/tree/2.6.8

Basicly which files and folders should be changed for version 3 ?
For example lib/Cake files here and here. How can we join them ? https://github.com/cakephp/cakephp/tree/3.0.3
https://github.com/cakephp/app/tree/3.0.3

cakephp/upgrade tools makes most of the namespace work and change deprecated class and methods. But it doesn't put proper folders to new locations. There is a folder structure here but it's unclear that where is lib/Cake and app folders. For example does old lib/Cake folder moved to Vendors/cakephp folder.

Please include other steps for file and folder changes in migration guide and upgrade tool.

All installation process should be documented. Composer can be used to convert old controller, view etc. files. But you know, upgrade tool doesn't make all necessary steps. (For example https://github.com/cakephp/upgrade/issues/83) user should change some folder structure manually)

Answer 1

Cakephp 3.0 uses composer whereas earlier versions did not. Please familiarize yourself with composer before continuing - composer is not the migration tool it is a dependency manager (the defacto standard used in most PHP projects), the migration tool is simply a plugin, an optional dependency.

Please do read the migration guide, you may also find tutorials such as this one useful. You may also find it useful to create a new project to familiarize yourself with how CakePHP 3.0 works (such as, by following the blog tutorial) before attempting to migrate an existing project.