As popular and awesome as CakePHP is, there just isn’t enough documentation on it. I guarantee many hours or days learning to wrangle with it.
Using Eclipse to maintain CakePHP projects is even worse. Precisely one tutorial exists, and it just doesn’t, um, cut the cake. It left me more confused than before I started.
After spending an hour on IRC’s #cakephp, one very patient user guided me through the process. By the end of the session, all I really needed was a visualisation of the setup. He took a desktop snap and sent it to me. Bam! Eclipse and CakePHP were together in five minutes.
In the interest of aiding visual learners out there and filling in the gaps left by the CakePHP/Eclipse tutorial, I pass this image on to you.
As the tutorial mentions, you will be creating two separate Eclipse projects: one for Cake core, and another for your project. Select everything inside /cake/cake and copy it into the core project; using /cake/cake as an include path works too. ((My biggest criticism yet of CakePHP: the developers didn’t spend any time thinking of the repercussions from naming a directory and its child the same thing.))
In your other project, use the core as an included project (right-click or whatever on Include Paths > Configure Include Path). Finally, select everything inside /cake/app and copy it into your project (again, including /cake/app is also valid).
That should work. If it doesn’t, feel free to comment below, though I’m likely to be of insufficient help. Otherwise, hum to yourself as you happily code away:
This was a triumph
I’m making a note here: ‘HUGE SUCCESS’…
Responses to comments after the jump…
(more…)

