- Install Xcode: Grab it from App Store
- Install Command line tools in xcode (open xcode -> Preferences -> Downloads -> Command Line tools)
- Install MacPorts: http://macports.org/install.php.
- Check MacPorts is installed. This will be a good test to see if MacPorts was installed properly:sudo port -v selfupdate.
If you're interested in how MacPorts works, consider reading the documentation for it here: http://guide.macports.org/.
Similar instructions to this can be found on the MacPorts wiki.
Before you install, please ensure that you don't have the binaries of XAMPP or MAMP in your path (go to nano ~/.bash_profile to check). If you do, then the installation won't work.
sudo port install php5 +apache2 +pear +fastcgi mysql5 mysql5-server php5-mysql php5-mssql php5-gd php5-mbstring php5-openssl php5-iconv curl +ssl php5-curl php5-ldap \php5-mcrypt php5-tidy php5-posix php5-soap php5-xcache php5-xdebug
Caution: This will compile everything from source, taking between 30 and 90 minutes depending on your hardware.
A list of all available MacPorts PHP 5 modules is available, should you require additional functionality such as SOAP, or other database support.
You might already have these dependencies, but chances are that the Macports packages have newer versions. This is particularly useful for cutting-edge dependencies like piston, which is quite sensitive to its git version.
sudo port install subversion git-core +bash_completion
sudo /opt/local/apache2/bin/apxs -a -e -n "php5" libphp5.so
sudo nano /opt/local/apache2/conf/httpd.conf
Add this line to the bottom of the httpd.conf file:
Include conf/extra/mod_php.conf
Run the following command:
sudo cp /opt/local/etc/php5/php.ini-development /opt/local/etc/php5/php.ini
Open php.ini and make the following changes
date.timezone = Pacific/Auckland
post_max_size = 32M
upload_max_filesize = 32M
To use mysqlnd with a local MySQL server, edit /opt/local/etc/php5/php.ini, search for each socket and change as below:
mysql.default_socket = /opt/local/var/run/mysql5/mysqld.sock
mysqli.default_socket = /opt/local/var/run/mysql5/mysqld.sock
pdo_mysql.default_socket = /opt/local/var/run/mysql5/mysqld.sock
Make sure you confirm that each file does exist in the above places.
Follow the below commands:
sudo pear update-channels
sudo pear upgrade PEAR
sudo pear config-set auto_discover 1
sudo pear install pear.phpunit.de/PHPUnit
If you get a bunch of 'install ok: channel...' messages then the installation was correct.
sudo port install postgresql91 postgresql91-server php5-postgresql
Set up the initial database structure:
sudo mkdir -p /opt/local/var/db/postgresql91/defaultdb
sudo chown postgres:postgres /opt/local/var/db/postgresql91/defaultdb
sudo su postgres -c '/opt/local/lib/postgresql91/bin/initdb -E utf8 -D /opt/local/var/db/postgresql91/defaultdb'
If the second command above didn't work, try this to force creation of the user:
sudo port destroot postgresql91-server
sudo port install sqlite3 php5-sqlite
sudo nano ~/.profile
Add the following commands to the .profile file:
alias apache2ctl='sudo /opt/local/apache2/bin/apachectl'
alias mysqlstart='sudo /opt/local/bin/mysqld_safe5'
alias mysqlstop='/opt/local/bin/mysqladmin5 -u root -p shutdown'
alias mysqladmin='/opt/local/bin/mysqladmin5'
alias mysql='/opt/local/bin/mysql5'
PostgreSQL:
alias pgstart="sudo su postgres -c '/opt/local/lib/postgresql91/bin/postgres -D /opt/local/var/db/postgresql91/defaultdb'"
alias pgstop="sudo su postgres -c '/opt/local/lib/postgresql91/bin/pg_ctl stop -D /opt/local/var/db/postgresql91/defaultdb'"
Then run the following command to load the above changes from .profile:
source ~/.profile
To avoid conflicts with other installed binaries (e.g. from MAMP or other packages), you'll want to set your shell $PATH properly.
nano ~/.profile
Confirm the following path is added:
PATH=/opt/local/bin:/opt/local/sbin:/opt/local/apache2/bin:/opt/local/lib/postgresql91/bin:$PATH
For lion you might also need to add the following to the profile (if you are getting the "libphp5.so requires version 8.0.0 or later" error):
export DYLD_LIBRARY_PATH=/opt/local/lib
export DYLD_FALLBACK_LIBRARY_PATH=/opt/local/lib:/sw/lib:/usr/lib
Reload your Terminal Session by closing and opening you Terminal. Make sure that the paths are correctly set after reloading your terminal session by running the following tasks in your terminal:
echo $PATH # should include the settings above
which php # should be /opt/local/bin/php
which php5 # should be /opt/local/bin/php
which mysql5 # should be /opt/local/bin/mysql5
sudo nano /opt/local/apache2/conf/httpd.conf
Look for DocumentRoot, and change it to be like the following (changing wrossiter to your username):
DocumentRoot "/Users/wrossiter/Sites"
Delete any directory configuration for "/opt/local/apache/htdocs" and replace it with the following (changing sharvey to your username): The below 'Directory' code is already added into the httpd.conf file, confirm the below (except for the username) is the same:
<Directory "/Users/wrossiter/Sites">
Options All
AllowOverride All
Order allow,deny
Allow from all
</Directory>
Update the 'User' in httpd.conf if you run httpd as a different user then the default 'www' on your computer Make sure ErrorLog is uncommented so you can see apache errors easily in the logs/error_log file
Set up the initial database structure by running:
sudo -u _mysql mysql_install_db5
Then verify that it’s ok by running the following command
ps -ax | grep mysql
Set the MySQL root password (it’s currently empty) - Do not use special characters:
mysqladmin5 -u root password <new-password>
Test everything by logging in to the server.
mysql5 -u root -p
The following commands are useful from a maintenance perspective.
sudo port selfupdate
sudo port sync
sudo port upgrade installed
sudo port outdated
sudo port upgrade outdated
sudo port -v uninstall inactive
sudo port clean --all installed