11:28am Upon first arrival at the website, I'm happy. I see a nice lookin' cake and a colorful layout that's easy to grok.

I haven't read any docs. I just going for the latest stable release: PHP Cake ver 1.1.19.6305

18:30:55 (~):$ cd php.robnugen.com/
18:31:00 (~/php.robnugen.com):$ mkdir cake_2008feb22,_1.1.19.6305        
18:31:37 (~/php.robnugen.com):$ cd cake_2008feb22,_1.1.19.6305/
18:31:47 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ wget http://cakeforge.org/frs/download.php/591/cake_1.1.19.6305.tar.bz2              
--18:32:07--  http://cakeforge.org/frs/download.php/591/cake_1.1.19.6305.tar.bz2
           => `cake_1.1.19.6305.tar.bz2'
Resolving cakeforge.org... 70.86.161.58
Connecting to cakeforge.org[70.86.161.58]:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 6,602 [text/html]

100%[===============================================================>] 6,602         --.--K/s             

18:32:08 (174.11 KB/s) - `cake_1.1.19.6305.tar.bz2' saved [6602/6602]

18:32:08 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ tar -xfk cake_1.1.19.6305.tar.bz2 
tar: k: Cannot open: No such file or directory
tar: Error is not recoverable: exiting now
18:32:36 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ tar -xjf cake_1.1.19.6305.tar.bz2 
bzip2: (stdin) is not a bzip2 file.
tar: Child returned status 2
tar: Error exit delayed from previous errors
18:32:46 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ tar -xf cake_1.1.19.6305.tar.bz2 
tar: Read 6602 bytes from cake_1.1.19.6305.tar.bz2
tar: This does not look like a tar archive
tar: Skipping to next header
tar: Error exit delayed from previous errors
18:32:57 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$        

Okay, the clock is still ticking, but at the moment, I don't think it's Cake's fault. I need to see the man page for tar to unzip this. (There are other versions I could download, but I'm not going back now.)

Okay, my command line was correct. I'm blaming cake. I deleted the file and will try again with this one:

11:44am JST Friday 22 February 2008 (day 13848)

Oh fuck me. The files I've been wgetting are HTML pleas for money.

Trying again.

18:48:48 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ ls
18:48:49 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ wget http://cakeforge.org/frs/download.php/591/cake_1.1.19.6305.tar.bz2/donation=complete
--18:48:53--  http://cakeforge.org/frs/download.php/591/cake_1.1.19.6305.tar.bz2/donation=complete
           => `donation=complete'
Resolving cakeforge.org... 70.86.161.58
Connecting to cakeforge.org[70.86.161.58]:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 161,671 [application/binary]

100%[======================================================================>] 161,671      858.90K/s             

18:48:53 (857.64 KB/s) - `donation=complete' saved [161671/161671]

18:48:53 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ ls
donation=complete
18:48:55 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ mv donation\=complete cake_1.1.19.6305.bz2
18:49:02 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ tar -xjf cake_1.1.19.6305.bz2 
18:49:13 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ ls
cake_1.1.19.6305  cake_1.1.19.6305.bz2
18:49:18 (~/php.robnugen.com/cake_2008feb22,_1.1.19.6305):$ 

11:53am JST

Okay, I still haven't read any docs; I'm going to hit the index and see what happens.

Ooops. a bunch of words that I'll have to read for them to be helpful. The first words I note are Your database configuration file is not present. but no indication on how to create it.

I clicked the first link. Nothing good.

12:01pm JST

Now I'm reading the cake manual, which was the second link.

Remember, my goal here is just to set it up (specifically the DB)

Okay, I just clicked on installing, and scanned through a bunch of stuff about directories to find

Alright, lets[sic] see this baby in action. Depending on which setup you used, you should point your
browser to http://www.example.com or http://www.example.com/cake. At this point, you'll be presented
with CakePHP's default home, and a message that tells you the status of your current database
connection.

Yes, and the status is worthless.

12:05pm JST

Okay, I found the database setup instructions. Now we are back on track.

12:09pm JST

Okay, so it looks like Cake will provide useful and flexible DB access, if I create tables according to their suggestions, stuff will work automagically (created / updated columns; foreign keys; etc)

12:10pm JST

Now I'm going to create a DB for use with cake. brb

12:17pm JST

Okay, I made the DB and when trying to set the params in database.php, I found insufficient instructions on the parameters:

The 'connect' key in the $default connection allows you to specify whether or not the database
connection will be treated as persistent or not. Read the comments in the database.php.default file
for help on specifying connection types for your database setup.

But in the comments it just says

 * connect =>
 * MySQL set the connect to either mysql_pconnect of[sic] mysql_connect

But no explanation of what they mean.

I'm going with the default: mysql_connect

12:20pm JST

Okay, time so far: 52 minutes, and that includes writing the above comments. At this point I've only

  1. downloaded and unzipped the archive (not the HTML plea for money!)

  2. copied the database.php.default to database.php

  3. In that file, I set the host, login, password, and database fields. I've left prefix blank because the DB will only be used for cake.

Your database configuration file is present.

Cake is able to connect to the database.

Sweet.

But, I'm not sure where I can go from here. No example tables were created; I don't see any Hello World toots. Looks like I'd have to read through lots of docs to find how to get started for anything more than cosmetic HTML changes.

Now, strictly speaking, there were instructions on this page, and several links to documentation,....

BUT, when I create this page as per the instructions, the instructions and helpful links vanish. How useful is that??

PS: I didn't write "CakePHP Rapid Development" at the top of this page, nor the cake button on the bottom left. No indication has been given to get rid of them.