Yosemite / El Capitan php-gd + mcrypt installation

51
votes

How to install/enable php-gd and mcrypt in Yosemite 10.10 - PHP 5.5.14 build?

note that following steps install newest PHP 5.5.x

To check if you have gd and mcrypt installed use $ php -m to display compiled in modules, continue if you are missing desired modules and please see accepted answer.

GD

So, Apple installed GD (and you're using their build of PHP, which is fine), but did not include support for PNG.

You are definitely missing "full" gd (with png support) module if: imagecreatefrompng() function is missing.

"Call to undefined function imagecreatefrompng()"

enter image description here

Mcrypt

install brew using accepted answer and omit part with gd installation (unless you need it), and use following steps:

  1. do search - $ brew search mcrypt
  2. pick the version of PHP you want
  3. install - $ brew install php55-mcrypt
  4. confirm using $ php -m | grep mcrypt

Want to switch between PHP versions?

Check out brew-php-switcher and follow instructions.

4
phphomebrewosx-yosemiteosx-elcapitanphp-gd
GD should be installed by default with PHP on Yosemite, I believe. Do you have multiple copies of PHP? Can you check with a phpinfo() on your webserver which 'php' is being used and compare it with the output of which php? – ItalyPaleAle
hello, that line outputs /usr/bin/php – Kyslik
So, Apple installed GD (and you're using their build of PHP, which is fine), but did not include support for PNG. Let me see if I can make it work. – ItalyPaleAle
Yes, I am using Apples PHP out of box + installed/compiled in mcrypt using this tutorial coolestguidesontheplanet.com/… – Kyslik
Yes, I was going to propose a similar solution. However, since GD is already builtin you cannot recompile the extension and load it dynamically. I'm afraid you'll have to recompile PHP from source. – ItalyPaleAle

4 Answers

81
votes

You are right, Yosemite's built-in PHP comes without PNG and FreeType support.
Update 2015/10 for El Captian: With OS X 10.11 El Capitan PNG support is back, but FreeType is still missing.

Solution

Use the Homebrew package manager to painlessly build and install a complete PHP and replace it in Apache's config. The whole process only takes about ten minutes if you follow the steps below.

A quick (but complete) walk through

(Note 1: I use Homebrew here, a package management system for OS X. If you are acquainted with MacPorts – another package manager – you can acchieve the same results with that system. It is also possible to use my Homebrew solution in parallel to an existing MacPorts installation on your machine.)
(Note 2: If you want to read all the details about the installation process, have a look at the Homebrew basic installation and the Homebrew PHP installation information. But you really won't need that if you follow these steps.)

Now let's go...

First install Xcode from App Store. If you already have it, check App Store again, to make sure you've got the latest version!

Now you need to install the Xcode Command Line Tools. To do so, open a Terminal and enter:

xcode-select --install

The next command will install the Homebrew package manager system:

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

The script explains what it will do and then pauses before it does it.

The next command to enter is a kind of system status test:

brew doctor

This checks the basics of the Homebrew installation.
I got a warning "You have MacPorts or Fink installed: /opt/local/bin/port ..." which I ignored successfully. ;)

Now setup the homebrew/dupes tap which has dependencies we need:

brew tap homebrew/dupes

Setup the homebrew/versions tap which also has dependencies we need:

brew tap homebrew/versions

Then run the following command:

brew tap homebrew/homebrew-php

Now you are ready to finally build PHP. For a list of available configuration options you may run one of these:

brew options php55
brew options php56

But I was fine just using the defaults.
To do so enter ONE of these two, depending on your needs:

brew install php55
brew install php56

(This takes a while, please be patient!)

while installing php56 (5.6.x) on Yosemite (10.10.5) there is a bug please see this issue on github. use brew install php56 --without-ldap instead.

If you get an error of type "Cannot find OpenSSL's " you have not installed the Xcode Command Line Tools as I told you in the beginning. ;) Go ahead, install them and re-run that last command.

PHP is built now and the script will end with some details about how to use it:

Open httpd.conf (should be located at /private/etc/apache2/httpd.conf) and enable PHP by adding ONE of these two lines, depending on which PHP version you just installed:

LoadModule php5_module /usr/local/opt/php55/libexec/apache2/libphp5.so
LoadModule php5_module /usr/local/opt/php56/libexec/apache2/libphp5.so

Don't forget to comment out any existing LoadModule php5_module... line that might be present from Yosemite's own PHP version!

Restart Apache

sudo apachectl restart

Your new php.ini file can be found in: /usr/local/etc/php/5.5/php.ini

Enjoy!

21
votes

The answer from @Jpsy is good, but there's another option, from the guys from liip, here. This is a PHP package that comes pre-built for Yosemite (older versions works too) but it is just one line of code:

curl -s http://php-osx.liip.ch/install.sh | bash -s 5.5

After that, everything is ready to work as expected. The configuration that cames with that installation is well suited for Symfony 2 development, but it should work just fine with other use cases.

Finally, if you need to use the updated PHP CLI, too, but you don't want to use the PHP version that comes with the OS, then you could also add to your .bash_profile or similar this line of code:

export PATH=/usr/local/php5/bin:$PATH

3
votes

I don't have enough rep to make a comment, but if you're using OS X Server for Yosemite (Version 4 from the App Store) the file to edit is:

/library/server/web/config/apache2/httpd_server_app.conf

mine looks like this now and confirmed it is working after using php 5.6 from homebrew.

#LoadModule php5_module libexec/apache2/libphp5.so
LoadModule php5_module /usr/local/opt/php56/libexec/apache2/libphp5.so
0
votes

Standard Apache coming with Yosemite the file to update after

sudo brew install php55

is in /etc/apache2/httpd.conf

Note that location of php.ini is also changed. The standard one coming with Yosemite is in /etc/php.ini, the one with homebrewed version is in /usr/local/etc/php/5.5/php.ini