Install & config Apache, MySQL and PHP on your Mac (MAMP)


There’s a Mac computer that I want to use as local development server for web apps. I don’t want to use bundled installers like XAMPP or MAMP because I feel that I will learn more about Apache if I install each component of the LAMP stack separately. By the way, one of my goals is to be an expert in the LAMP stack. And prior to writing this blog entry, I had only been concerned about the actual coding of web apps, and have never had the chance or need to play with the installation and configuration of Linux, Apache, MySQL and PHP as individual components since there’s always been XAMPP and MAMP for easy setup in my local environment. And at work, someone else is always in charge of setting up our Linux server and the rest of the things we need for our production environment.

I also plan to setup a LAMP environment on my Mac by using VirtualBox to create a virtual machine with Linux, but I’m saving that for another post if it happens. 😆

Here in this blog entry, I shall take note of the steps that I take as I setup Apache, MySQL and PHP on Mac.

My environment

Computer: MacBook Pro
Operating System: OS X El Capitan version 10.11.5
I’ll be using the Terminal and Vim editor

Apache, MySQL, and PHP versions that I will setup:

Apache: version 2.4.18 (bundled with El Capitan, default)
MySQL: version 5.7.15 (installed via Homebrew)
PHP: version 5.5.34 (bundled with El Capitan, default)

I have no MAMP, XAMPP or any bundled *AMP stack installed on my Mac, so I will have fresh install of MySQL.

Start Apache on your Mac

Apache is already in OS X El Capitan so I just need to set it up. If you want to check your Apache version, run the command httpd -v in Terminal. Mine is Apache version 2.4.18.

Type this command in Terminal to start Apache on your Mac:

Now that we started Apache, you should now be able to access the URL http://localhost/.

Start PHP on your Mac

Maybe you expected this section to be for MySQL setup, but I’m going to work with PHP first since it should be already in OS X El Capitan, like Apache.

Also, as of writing, the latest PHP version is 7 but I want to take one little step at a time as I write this so I’ll stick with the PHP 5 bundled with my Mac. I will try to post another blog entry on how to upgrade from PHP 5 to PHP 7. 🙂

We are going to edit the Apache configuration file to enable PHP on Mac, but for now let’s make a back up of the file. Let’s do that by running these commands:

Notice the 20160910 in the command sudo cp httpd.conf http.conf.20160910.bak. It’s the date when I made a backup. You may change the date or even delete it.

Open Vim to edit httpd.conf by running this command:

Find the following line in httpd.conf and uncomment it:

Remove the hash symbol (#) at the beginning of that line to uncomment it.

Vim editor tip: when you open the httpd.conf file, search for the line containing “php5_module” by pressing the esc key to make sure you’re not in INSERT mode, then type /php5_module and then hit the return/enter key. Vim should point you to the line that you should uncomment. Press the “i” key to enter INSERT mode in Vim, and uncomment that line. To save the file, press esc key again and type :wq!

Now, restart Apache to reflect the change:

Check if PHP works

Run these commands:

Press the “i” key to enter INSERT mode again, then place this PHP code into temp_phpinfo.php:

Then using your web browser, go to http://localhost/temp_phpinfo.php

If the page shows a table of details about PHP, then PHP now works on your Mac. Good job! 🙂

I recommend that you delete this temp_phpinfo.php file though, and avoid using phpinfo() especially in production servers because it can lead to security issues. It will be easier for attackers to hack into your system when they see all the details that phpinfo() exposes.

Install MySQL

Install Homebrew if you haven’t yet. I choose to install MySQL with Homebrew because I find the process simple.

Run this command to install MySQL via Homebrew:

The installation process on my Mac looked like this:

By default, Homebrew installs MySQL without root password, and with this setup, you can now log into MySQL by typing:

But wait! Securing MySQL with a password is highly recommended, and if you agree, run this command:

With a password for root set, you should access MySQL with this command instead, adding a -p to the command for a password prompt:

MySQL command line on a Mac Mini with MAMP bundle installed

The Mac Mini I’m using at work already has MAMP installed, but I followed the steps for setting up Apache, MySQL and PHP in this page just to test. Since MAMP is already installed, I already have MySQL.

So, before using MySQL via command line, simply start your MySQL server from MAMP and then use command line MySQL by logging in like this:

Create sample database table for testing with PHP later

Run the following commands:

This is what my MySQL command line interface looked like:

Make sure PHP can communicate with MySQL

The following command creates a symbolic link to help point to the right socket for MySQL to use on Mac.

Reason: “You may have a socket (appearing as a zero length file) as /tmp/mysql.sock or /var/mysql/mysql.sock but 1 or more apps is looking in the other location for it.” – source

Another option: A fellow developer told me that instead of creating a symbolic link to the socket, he connects directly to localhost:3306, connecting through networking sockets instead of Unix sockets.

Enable mod_rewrite

My guide suggests we enable this now to avoid forgetting later that it’s not yet enabled. This will prevent hiccups when we’re already busy with coding web apps.

Edit the config file with Vim.

Uncomment the following lines:

Restart Apache:

Sample PHP-MySQL code to test your “MAMP” stack

Remember the table I created earlier? This is when we’re going to use that.

Run this command, we’re going to paste code into it:

Paste the following PHP code which SELECTs data from a sample MySQL table. Remember to edit the variable values to match your own settings, especially the password.

Visit this link on your browser: http://localhost/testsql.php

It should display this:

1 catzie
2 petar
done

Move Document Root folder

Right now, the document root is at "/Library/WebServer/Documents", and you may have noticed that each time we edit a file to create a new file within this folder, we need to sudo. That is inefficient, so let’s move our document somewhere that we won’t have to sudo for each change that we want to make.

We will move document root from "/Library/WebServer/Documents" to /webcontent.

Create “webcontent” folder under the root directory /. You can choose any other name you like.

Let’s create a sample page inside the newly created folder.

And place anything there such as “Hello!”

Now, let;s edit the Apache configuration file to point to the /webcontent folder:

Change the line DocumentRoot "/Library/WebServer/Documents" into /webcontent

Change the line <Directory "/Library/WebServer/Documents"> into <Directory "/webcontent">

Restart Apache:

Visit http://localhost again, and you should see whatever text you placed inside /webcontent/index.html

Just in case you still need to ‘sudo’ to access /webcontent folder

Try to copy the /webcontent/index.html file to check if you no longer need sudo in the /webcontent folder:

If it gives you the error cp: /webcontent/index2.html: Permission denied then here are your options:

  • Option #1: Change ownership of /webcontent folder

    In the Mac Mini I use, the directory permissions for /webcontent is drwxr-xr-x which means only the owner (root) has permissions write to it, unless I sudo as another user, which is not convenient if I need to edit many files.

    What we can do is change ownership of /webcontent from “root” user to our own user, like so:

    Now try to create or edit files under the /webcontent folder. Your system should no longer deny you permission, since it is owned by you. So far I have not encountered a problem yet with this setup.

  • Option #2: Move document root under your user folder

    You can try to move your document root under your user folder, i.e. ~/ or /Users/<yourUsername>, and see if you can edit files there without the need for sudo. Your user is the owner of this folder so you shouldn’t need additional permissions to edit files under it.

On my MacBook Pro, I no longer had to sudo when I edit files in new document root /webcontent, but on another Mac computer that I use (Mac Mini), I still needed sudo to edit files in document root. I will edit this blog entry when I find a way to avoid this.

Tested on:

Computer: Mac Mini
Operating System: OS X El Capitan version 10.11
Apache: 2.4.16 (bundled with El Capitan)
PHP: 5.5.27 (bundled with El Capitan)
MySQL: 5.5.34 (bundled with installed MAMP)

Extras…

How to stop Apache on your Mac

Type this command in Terminal to stop Apache on your Mac:

or

Based on my observation, when I start and stop Apache multiple times, the stop command with -k only works on the first time. Succeeding commands for stopping Apache becomes just sudo apachectl stop.

How to check version of Apache, MySQL and PHP

Apache version:

or

MySQL version:

If using MAMP bundle, MySQL service should be running when you use this command:

The welcome screen should show MySQL version when you login to MySQL via command line:

PHP version:

ERROR 2002 (HY000): Can’t connect to local MySQL server through socket ‘/tmp/mysql.sock’ (2)

When I got this error regarding a socket (my MySQL is installed via Homebrew), it was fixed when I started MySQL by running the following command:

I think the same command is used for both starting and restarting of the MySQL server. Note that this is the command I use for my MySQL that’s installed via Homebrew. If you have MAMP GUI and not the MySQL from Homebrew, simply use that interface to start your MySQL service.

Reference(s):
Install MySQL on Mac OSX with Homebrew
Running Simple Select Statements
symbolic link setup for correct socket file locations in Mac OS X for MySQL
Version of Apache in Mac
Main Guide: Installing Apache, PHP, and MySQL on Mac OS X El Capitan

Related Posts:

Posts that may be related to "Install & config Apache, MySQL and PHP on your Mac (MAMP)":

Catzie

A Filipino programmer with a variety of interests such as baking, singing, making up silly song/rap lyrics, K-pop, drawing, creating unique dessert flavors, obsessing about finding out how some things works, board games, anime, video games, and forgetting things that usually go in her long list of interests. Running small-time online dessert shops Cookies PH and Catzie's Cakery.

Leave a Reply

Your email address will not be published. Required fields are marked *