Switching to PHP 5.4 on OS X

I like using OS X’s built-in packages where possible, but unfortunately Apple is way behind with their PHP package, having it locked on 5.3.15. In the past I’ve seen people use tools like Mamp, or Xampp to provide this for them, but frankly I’m not a big fan of these tools.

Homebrew provides a solution. Homebrew is OS X missing package manager, and it’s an absolute great tool to work with. Getting started with it is a bit harder, as there’s a few bigger dependencies you need, such as an up-to-date XCode installation. Once you’ve installed homebrew, it’s a matter of running the following commands:

brew tap homebrew/dupes
brew tap josegonzalez/homebrew-php
brew install php54 --with-mysql
brew install php54-memcached
brew install php54-xdebug

After that, open /etc/apache2/httpd.conf, and look for this line:

LoadModule php5_module libexec/apache2/

Comment that out (with #) and add the following line:

LoadModule php5_module /usr/local/Cellar/php54/5.4.12/libexec/apache2/

Hint: Check your php version (php -v) and adjust the version number if necessary.

After that, restart apache and things should just work. For more detailed instructions, take a look at the documentation for homebrew-php.

Edit: On one Mac I had to first run “brew unlink libiconv” for PHP compilation to complete.

Web mentions


  • Vladimir

    I'm not a big fan of homebrew. I use this:
    Works like a charm :)

  • Pei Wu

    This is very helpful, thank you

  • Magento Developer

    How would you switch in case of nginx + php-fpm?