This tutorial will show you how you can easily set up new virtual hosts on the stock Mac Apache install, perfect for testing and developing small PHP projects. Once you have done this, new projects can be set up by just creating new directories — no adding hosts to /etc/hosts or adding new Apache configuration will be required.

We are going to use ~/Sites/ as the base directory, and we’ll be able to dynamically serve from any directories under this. The name of the directory that you use will form part of the URL that you will use.

So, for example, if you created the following under ~/Sites/

mkdir -p ~/Sites/siteone/htdocs
mkdir -p ~/Sites/sitetwo/htdocs
mkdir -p ~/Sites/anothersite/htdocs

Then you will be able to access content from htdocs under the following URL’s

• http://siteone.localhost/
• http://sitetwo.localhost/
• http://anothersite.localhost/

Notice how we are using the .localhost TLD for this. RFC 2606 specifies that .localhost is reserved for local testing purposes.

So, how do we get to this setup? There are two parts:

1. Set up .localhost proxying

First of all, we need to make sure that any requests to a .localhost domain are routed to the local loopback device. For this, we will use the Automatic Proxy Configuration facilities of OS X.

We need to create the following Proxy Configuration File:

function FindProxyForURL(url, host)
{
	if (dnsDomainIs(host, ".localhost")) {
		return "PROXY localhost";
	}
 
	return "DIRECT";
}

Save the file as localhost.pac and place it in your ~/Sites/ directory.

Now, open up your System Preferences and go into Network. Select your network in the left hand pane, and click the ‘Advanced…’ button on right. Click the ‘Proxies’ tab and check ‘Automatic Proxy Configuration’. In the ‘Proxy Configuration File’, enter the URL to your file, for example http://localhost/~username/localhost.pac.

Click on ‘OK’ and then ‘Apply’.

2. Set up Apache VirtualHost

Edit the Apache configuration file for your user which is stored under /etc/apache2/users/.conf, and add the following:

<VirtualHost *:80>
    VirtualDocumentRoot "/Users/<username>/Sites/%1/htdocs"
    ServerName subdomains.localhost
    ServerAlias *.localhost
</VirtualHost>

Restart Apache with sudo apachectl restart

3. Test!

mkdir -p ~/Sites/mysite/htdocs
echo 'Hello World!' > ~/Sites/mysite/htdocs/index.html

Visit http://mysite.localhost/ in your browser, and you should see “Hello World!”

References

• Navigator Proxy Auto-Config File Format
• RFC 2606
• VirtualDocumentRoot Directive

Glen Scott

I’m a freelance software developer with 18 years’ professional experience in web development. I specialise in creating tailor-made, web-based systems that can help your business run like clockwork. I am the Managing Director of Yellow Square Development.

More Posts

Follow Me:

Note 22nd Jan 2014: I no longer have the time or enthusiasm for this book, so the project has been abandoned, sorry! The page is left here for archive purposes only.
—

One of my most popular blog posts has been the instructions on installing the PHP mcrypt extension on Mac OS X. I recall needing mcrypt for a phpMyAdmin installation, and thought the install instructions would be useful for others. It was: to date, the page has had 19,174 views!

The popularity of this post got me thinking — how exactly are people using Mac OS X for PHP development?

I’ve been using OS X for development for many years now, and I’ve built up a lot of knowledge about how to create an environment that’s a pleasure, rather than a chore, to use. A lot of this knowledge I am taking for granted, but I am sure it will be of use to others.

I’m putting this knowledge into my first e-book.

Here’s an example of what topics I’ll be covering:

Part I – Native

Where I look at options for working on smaller projects, or projects where your deployment environment is unknown.

1. Configuring Apache
2. Adding PHP modules
3. Adding PECL modules
4. Installing and running MySQL, PostGreSQL and MongoDB
5. Installing and configuring phpMyAdmin
6. Installing and configuring MAMP

Part II – Virtualization

For working with medium – large projects where your deployment environment is known.

1. Installing Vagrant
2. Setting up your first virtualized PHP environment
3. Puppet provisioning
4. Vital development tools

Part III – Specific environments

If you are developing for a specific framework or tool, this chapter will help.

1. Installing a test instance of Magento
2. Create a WordPress plugin and theme development environment
3. Create an environment for Zend Framework or CodeIgniter applications

Are you interested in finding out more? If so, please add your e-mail address to the list and I’ll keep you updated on the progress of the e-book.

Also, if you have any subjects that you would covered, please add a comment to the page.



Glen Scott

I’m a freelance software developer with 18 years’ professional experience in web development. I specialise in creating tailor-made, web-based systems that can help your business run like clockwork. I am the Managing Director of Yellow Square Development.

More Posts

Follow Me:

As described in Apple’s security notes for Mac OS X 10.7.3, PHP is upgraded from 5.3.6 to version 5.3.8 as part of the update.

Glen Scott

I’m a freelance software developer with 18 years’ professional experience in web development. I specialise in creating tailor-made, web-based systems that can help your business run like clockwork. I am the Managing Director of Yellow Square Development.

More Posts

Follow Me: