Installing Mongo and Mongo-PHP on Mac OSX Mavericks with MAMP
<tl;dr> A brief and thoroughly geeky blog post. If you’re not tinkering with Mongo on a Mac, best click away now </tl;dr>
Are you wanting to tinker with the fancy schmancy NoSQL database Mongo and you’re running MAMP on your Mac? Should be a doddle to install, right? Erm, not so much.
Step 1 – Install Mongo
brew install mongodb
Easy, peasy. Let’s not get ahead of ourselves, this is where it gets tricky. Thanks to Daniel Farrelly for the pointers in his blog post.
Step 2 – Install Autconf & Grab Xcode
brew install autoconf
We’ll need this later on. I’m pretty sure you’ll need Xcode, too. It’s a free download, fire up the App Store, search for Xcode and install it. Bit of a beast, so time to grab a brew (caffeinated or alcoholic, your choice).
Step 3 – Download and Install PHP Source
I’m using PHP 5.5.3. How’d I find out? Easy. Start your MAMP application, click on Preferences and select the PHP tab. You’ll see which version you’re running. It’ll look something like this image.
You’ll need the PHP source in order to compile the mongo-php database driver. The sources used to be available from the MAMP website, but I couldn’t find them anywhere.
Find the correct source from http://www.php.net/releases/, in this case I’m after 5.5.3, so let’s download it:
Unzip the file and you’ll get a new folder php-5.5.3. Move the contents of this folder – brace yourselves – into the correct folder in the MAMP directory. You’re looking for the correct version number, in this instance it’s:
cd /Applications/MAMP/bin/php/php5.5.3/ mkdir include cd include mkdir php
Now copy the contents of the unzipped file into this new folder /Applications/MAMP/bin/php/php5.5.3/include/php. The install process requires header files, so you need to run:
cd /Applications/MAMP/bin/php/php5.5.3/include/php ./configure
Thanks to Sven Loth for his comment on this post that highlighted this step.
Step 4 – Build & Install mongo-php Driver
Yeah, let’s build this sucker. This needs to be done with the right version of pecl for the version of PHP you’re using with MAMP. Again, I’m using 5.5.3, but change the version number for your version and it should work.
cd /Applications/MAMP/bin/php/php5.5.3/bin sudo pecl install mongo-php
This’ll take a few minutes, but fingers crossed, it should work.
Additional step: if PHP isn’t included in your PATH, you might need to add it. Thanks to Pascal Rieger for pinging this info over:
Step 5 – Add mongo.so Extension to php.ini
Another gotcha here. MAMP has a whole bunch of php.ini files, one for each version of php. Some are used, some are overwritten. Thanks to this forum post, we know which one to use: /Applications/MAMP/conf/php5.5.3.
In the php.ini file, look for the extensions, the section will start with ; Extensions – at the end of the section add:
Step 6 – Restart MAMP
Yup, do that to load up the new extension and test it’s working, this’ll do the job:
<?php phpinfo(); ?>
Scroll down the page and you should see a mongo section, something like this:
and that, should be that. Hope it works. Any tips, problems, etc, stick ’em in the comments.