Whenever I set up a new OS X box I drive myself crazy trying to remember which part of the Apache config needs to be tweaked to allow symlinks to arbitrary parts of the file tree from the document root. /private/etc/httpd/httpd.conf includes
Options FollowSymLinks for Directory /, and it’s tempting to think that should take care of it. Then I remember that there are sub config files for each user on the system, in /private/etc/httpd/users/. These do not specify anything for FollowSymLinks, so again, it’s tempting to think that this property will be inherited from Directory /, but then we realize, the Options directive in this file overwrites any previous Options directives.
Anyway, the solution is to tack FollowSymLinks onto the end of Options Indexes MultiViews in your user config file in /private/etc/httpd/users/.
The only other things I need to change from the default OS X configuration is activating php in the main config and commenting out AllowOverride None in the user config.
