Rob Allen's DevNotes

In the vein of some of Lorna's articles, this is more a note for myself than anything else. Not everything is explained in detail as it assumes you know how to use a command line...

These are the steps I take to get the Apple supplied PHP working with GD, PDO_MySQL and Xdebug working on OS X 10.5.

/usr/local

Ensure that the following directories exist:

    sudo mkdir /usr/local/include
    sudo mkdir /usr/local/bin
    sudo mkdir /usr/local/lib
    sudo mkdir -p /usr/local/man/man1

Run Apache in 32 bit mode

This saves us having to compile our own MySQL as MySQL doesn't offer a "fat" binary

1. cd /System/Library/LaunchDaemons
2. sudo vim org.apache.httpd.plist
3. Immediately after the line containing <array> add:

       <string>arch</string>
       <string>-i386</string>
   

4. Reboot

MySQL

1. Download the 32bit version of MySQL 5.0.x for OS X 10.5 from mysql.com and install the pkg, the startup item and the pref pane.
2. Add /usr/local/mysql/bin to the path: vim ~/.bash_profile and add:

       export PATH=~/bin:/usr/local/bin:/usr/local/sbin:/usr/local/mysql/bin:$PATH
       export EDITOR=vim
   

   at top of file. (Note that we set EDITOR whilst we are here so that svn is happy!)

3. Set up MySQL root password:

       mysqladmin -u root password {new-password}
       mysqladmin -u root -p{new-password} -h localhost password {new-password}
       mysqladmin -u root -p reload
   

   Quit Terminal to flush the history to file. Restart Terminal and remove the history file: rm .bash_history so that {new-password} isn't in plain text on the disk.

4. Set the correct socket information for PHP. Ensure MySQL is running via the System Preferences panel then:

       sudo mkdir /var/mysql
       sudo ln -s /tmp/mysql.sock /var/mysql/mysql.sock
   

Rest of Apache setup

1. cd /etc/apache2
2. sudo vim httpd.conf
3. Find #LoadModule php5_module libexec/apache2/libphp5.so and remove the leading #
4. Find AllowOverride None within the <Directory "/Library/WebServer/Documents">section and change toAllowOverride All so that .htaccess files will work.
5. Restart Apache: sudo apachectl restart
6. Open Finder and navigate to /Library/WebServer/Documents/
7. Create a new folder called "orig" and place all files currently in the Documents folder into it.
8. Create a new file called info.php with <?php phpinfo(); inside it.
9. Use Safari to navigate to http://localhost/info.php and check that the PHP version is displayed (5.2.6 at the time of writing).

php.ini

1. cd /etc
2. sudo cp php.ini.default php.ini
3. sudo chmod ug+w php.ini
4. sudo chgrp admin php.ini
5. vim php.ini (assuming your user is a member of the admin group) and change settings appropriately. Change:

       error_reporting  =  E_ALL | E_STRICT
       extension_dir = "/usr/lib/php/extensions/no-debug-non-zts-20060613"
   

   You must set the extension dir correctly. (Commenting the line out also works...)

PHP extensions

The supplied PHP doesn't come with pdo_mysql, pear or gd, so fix it.

1. Download the correct version of PHP from http://www.php.net/releases/. (5.2.6 at time of writing)
2. Create a directory called src in your home directory and unpack the PHP source. This creates /Users/rob/src/php-5.2.6/ in my case.

pdo_mysql

1. cd ~/src/php-5.2.6/ext/pdo_mysql.
2. phpize
3. MACOSX_DEPLOYMENT_TARGET=10.5 \
   CFLAGS='-O3 -fno-common -arch i386' \
   LDFLAGS='-O3 -arch i386' \
   CXXFLAGS='-O3 -fno-common -arch i386' \
   ./configure --prefix=/usr --with-pdo-mysql=/usr/local/mysql
4. make
5. sudo make install
6. Edit /etc/php.ini and find the extension_dir line and add after it:

       extension=mysql.so

7. Restart apache: sudo apachectl restart and check in the phpinfo that pdo_mysql is now loaded.

GD

Installing GD onto the stock PHP install that is supplied with OS X is slightly more complicated than you'd expect because you need to install libjpeg first.

Libjpeg

Libjpeg is available from the Independent JPEG Group.

1. Download the source code: http://www.ijg.org/files/jpegsrc.v6b.tar.gz
2. extract to ~/src
3. cd ~/src/jpeg-6b
4. cp /usr/share/libtool/config.* .
5. ./configure --enable-shared
6. sudo make install
7. Libjpeg is now installed in /usr/local/lib

GD extension

1. cd ~/src/php-5.2.6/ext/gd
2. phpize
3. MACOSX_DEPLOYMENT_TARGET=10.5 \
   CFLAGS='-O3 -fno-common -arch i386' \
   LDFLAGS='-O3 -arch i386' \
   CXXFLAGS='-O3 -fno-common -arch i386' \
   ./configure --with-zlib-dir=/usr --with-jpeg-dir=/usr/local/lib --with-png-dir=/usr/X11R6 --with-freetype-dir=/usr/X11R6 --with-xpm-dir=/usr/X11R6
4. make
5. sudo make install
6. Edit /etc/php.ini and find the extension_dir line and add after it:

       extension=gd.so

7. Restart apache: sudo apachectl restart and check in the phpinfo that GD is now loaded.

PEAR

1. cd ~/src/.
2. curl http://pear.php.net/go-pear > go-pear.php
3. Accept defaults, except for installation prefix (1) should be /usr/local
4. Check that the include_path in /etc/php.ini is correct and includes the PEAR directory (/usr/local/PEAR).

Xdebug

Can't have a PHP development environment without xdebug!

1. sudo pecl install xdebug
2. Edit /etc/php.ini and add

       zend_extension="/usr/lib/php/extensions/no-debug-non-zts-20060613/xdebug.so"

   after the other extension lines.

3. Restart apache: sudo apachectl restart and check in the phpinfo that xdebug is now loaded.

PHPUnit

1. sudo pear channel-discover pear.phpunit.de
2. sudo pear install phpunit/PHPUnit

It all works on this machines, anyway :)

Updatesee Marc Liyanage's PHP5 packages

This entry was posted on Thursday, 5th March 2009 at 22:07 and is filed under PHP.