I’ve had a love/hate relationship with MAMP for the last few years – mostly love, but there are a few things about it that have turned my hair grey. One of these things is the packaged PEAR library. I have been wanting to install PHPUnit for quite some time now and have gotten close, but was never able to actually get it running from within the MAMP environment. Well today I set forth to change this…
My goal was to leave any default system libraries untouched while at the same time being able to use the MAMP versions directly from the terminal (without having to type those long directory paths). First off make sure you have the latest version of MAMP. At the time I am writing this post the latest version is 2.1.4. I upgraded to the Pro version and I would highly recommend that you do the same. I wish there was an easier way to upgrade, hopefully in the future… for now, just rename your current install to “MAMP_OLD” and “MAMP PRO_OLD” then install in the normal manner. Once everything is installed move your htdocs & db folders from your old version to your new version. Start it up and hopefully all is well. Once that is in place you can trash the old versions.
The first step was to update my bash profile, so that I do not need to type the direct path to the MAMP version of php & pear. Go ahead and open up the Terminal App. It is in Applications/Utilities. Make sure you are in your user directory. To make sure just type “cd”. Now we want to edit our bash profile so type the following command:
open -e .bash_profile
This will open your default text editor so that you can make edits. Add a new line at the end and add the following:
export PATH=/Applications/MAMP/bin/php/php5.3.20/bin:$PATH
This is assuming that you are using PHP 5.3.20. You may need to modify this to php5.4.10 for example. Save the file, and now back in Terminal enter the following:
source ~/.bash_profile
This will refresh your terminal session, so that the settings you just made will take effect. To test it out, try the which command:
which php which pear
It should now output the MAMP locations:
/Applications/MAMP/bin/php/php5.3.20/bin/php
/Applications/MAMP/bin/php/php5.3.20/bin/pear
We should now take a look at PEAR’s configuration.
pear config-show
What we want to do is change the locations so that everything resides within MAMP rather than using the system defaults. Here is a list the configuration we will be looking at: auto_discover, bin_dir, doc_dir, php_dir, cache_dir, cfg_dir, data_dir, download_dir, php_bin, temp_dir, test_dir, and www_dir. We will set these to the following.
sudo pear config-set auto_discover 1 sudo pear config-set bin_dir /Applications/MAMP/bin/php/php5.3.20/bin sudo pear config-set doc_dir /Applications/MAMP/bin/php/php5.3.20/lib/php/doc sudo pear config-set php_dir /Applications/MAMP/bin/php/php5.3.20/lib/php sudo pear config-set cache_dir /Applications/MAMP/tmp/pear/cache sudo pear config-set cfg_dir /Applications/MAMP/bin/php/php5.3.20/lib/php/cfg sudo pear config-set data_dir /Applications/MAMP/bin/php/php5.3.20/lib/php/data sudo pear config-set download_dir /Applications/MAMP/tmp/pear/install sudo pear config-set php_bin /Applications/MAMP/bin/php/php5.3.20/bin/php sudo pear config-set temp_dir /Applications/MAMP/tmp/pear/install sudo pear config-set test_dir /Applications/MAMP/bin/php/php5.3.20/lib/php/test sudo pear config-set www_dir /Applications/MAMP/bin/php/php5.3.20/lib/php/www
The first time you issue the sudo command it will prompt you for your user password. I had to create new folders for the cache_dir, cfg_dir, download_dir/temp_dir, and www_dir. You can either create the folders in Finder or Terminal. In terminal you would type:
sudo mkdir /Applications/MAMP/tmp/pear sudo mkdir /Applications/MAMP/tmp/pear/cache sudo mkdir /Applications/MAMP/bin/php/php5.3.20/lib/php/cfg sudo mkdir /Applications/MAMP/tmp/pear/install sudo mkdir /Applications/MAMP/bin/php/php5.3.20/lib/php/www
Since PEAR needs to be able to write to the cache and install directory we need to change the permissions. In Finder you type CMD + i to bring up the inspector. Under the Sharing & Permissions section you will need to change the Privilege to Read & Write for each of the settings or in terminal you can do this:
sudo chmod 777 /Applications/MAMP/tmp/pear/cache /Applications/MAMP/tmp/pear/install
Wow, that was a lot. Now we don’t need to use sudo anymore and we can you start using PEAR. To make sure you have the latest version…
pear upgrade
Now finally, install PHPUnit!
pear install --alldeps pear.phpunit.de/PHPUnit
PHPUnit is now ready to go.
phpunit --version
PHPUnit 3.7.21 by Sebastian Bergmann.
Success!!!