Craft's install documentation assumes but doesn't explain several prerequisites (like setting up my MySQL) and The Absolute Beginners Guide to Setting Up Craft on Mac (sounded perfect) was directionally helpful but had some errors and, at the end of the day, simply didn't work for me. For the longest time, I could not get Craft to connect to MySQL, even though it was installed correctly and running.
These are the perquisite steps, assuming you aren't already running Apache and MySQL:
- Step P1: Download and install MAMP -- This sets up a Macintosh, Apache, MySQL, and PHP solution stack and gives you a simple management interface to start and stop the servers.
- Step P2: Download and install Sequel Pro -- This gives you a simple tool to manage your MySQL databases.
- Step P3: Open MAMP (not MAMP Pro), and click "Start Servers" -- This starts the Apache Web server and the MySQL database engine.
- Step P4: In MAMP, click "Open WebStart page," if MAMP didn't already open one in your browser automatically.
- Step P5: Open Sequel Pro, and use the parameters on MAMP's WebStart page to create a connection -- I could not create a Standard connection using '127.0.0.1'. I had to create a Socket connection, using 'localhost'. This is the scenario that the Craft installation instructions don't anticipate.
- Step P6: Click the control in the upper lefthand of Sequel Pro, and choose "Add Database ..." to create a database, e.g.. 'crafted'. Choose UTF-8 for “Database Encoding."
These steps track those in Craft's installation instructions but with some additional explanation. Read them together:
- Step C1: Upload the files -- You're uploading the files, because you're pushing them to your Apache Web server on your Macbook.
- Download Craft -- It will end up in your Downloads folder. There are two folders craft/ and public/ in the downloaded 'Craft-2' folder.
- Copy the craft/ folder to /Applications/MAMP, i.e., above the webfoot (htdocs/).
- Copy the files htaccess, index.php, and robots.txt from public/ to the htdocs/ folder.
- Rename htaccess to .htaccess -- Open Terminal and run the following commands:
- "cd /Applications/MAMP/htdocs" -- go to where htaccess lives
- "defaults write com.apple.finder AppleShowAllFiles -bool true" -- show hidden files
- [Relaunch the Finder] -- hold down control-Alt while you click on Finder in the dock and then choose Relaunch
- "mv htaccess .htaccess" -- rename htaccess
- "defaults write com.apple.finder AppleShowAllFiles -bool false" -- hide hidden files
- [Relaunch the Finder again]
- Step C2: Set the permissions
- Open Terminal and run the following commands:
- "cd /Applications/MAMP/craft" -- go to the craft/ directory
- "chmod -R 744 app"
- "chmod -R 744 config"
- "chmod -R 744 storage"
- Step C3: Create your database
- Nothing to do here -- You already did this in Step P6 above.
- Step C4: Tell Craft how to connect to your database
- Copy the default settings in "craft/app/etc/config/defaults/db.php" into "craft/config/db.php"
- Update the parameters
- Set 'unixSocket' to the Socket value on your MAMP WebStart page (e.g., "/Applications/MAMP/tmp/mysql/mysql.sock").
- Step C5: Run the installer!
- The URL is "localhost:8888/admin"
- Follow the installation screens
I'm guessing that if you are setting up Craft in a production environment on a production Mac you might want to do somethings a little different, but this will get you a sandbox to play in. Enjoy!