OS X: You need only one tiny command to start a web server from any directory through OS X's terminal. If you've got a web site lying around and need to test it out, this is possibly the.
I recently purchased brand new MacBook Pro and I had to install NGINX, PHP and MySQL in my MacBook Pro. In this article, I am going to share my experience for how to install NGINX, PHP and MySQL on your Mac. This article is for someone interesting to set-up web development environment, especially for the first time.
Programmers can develop a local web server using Xampp. Xampp is equally compatible with operating systems like Linux, Microsoft Windows and Mac as well. Programmers find Xampp very easy to use, the reason is simple that it is powered by Apache, MySQL, PHP and Perl. Developing web applications on macOS is a real joy. There are plenty of options for setting up your development environments, including the ever-popular MAMP Pro that provides a nice UI on top of Apache, PHP and MySQL. Abyss Web Server empowers you to have your Web destinations on your PC. It bolsters secure SSL/TLS associations (HTTPS) and in addition an extensive variety of Web innovations. It can likewise run progressed PHP, Perl, Python, ASP, ASP.NET, and Ruby on Rails Web applications which can be sponsored by databases, for example, MySQL, SQLite, MS. Install PHP on Mac OS X. To enable PHP support for Apache, we need to make changes in its configuration file. Pankajs-MacBook-Pro:CODE root # vi /etc/apache2/httpd.conf Uncomment below line and save it. LoadModule php5module libexec/apache2/libphp5.so. Now restart the server and it should be able to process PHP files.
Reson I choose Nginx over Apache web server is its light-weight resource utilization and its ability to scale easily. Also, Niginx has grown its popularity during last few years. Furthermore, Nginx is often selected by administrators for its resource efficiency and responsiveness under the heavy load.
My MacBook Pro installed Mac OS High Sierra and it was shipped with pre-installed PHP package. So, depending on your web development environment setup, you may need to upgrade default PHP version to the latest version.
Normally, Mac OS X doesn’t ship with its own copy of MySQL. So, you will have to install MySQL on your local machine.
Also, remember this article only explain to install these required packages on your local machine. Alternatively, you can set up similar development environment by using Docker or Vagrant. I will write another post in this regarding.
Now let’s have a look how to install NGINX, PHP and MySQL on Mac OS local environment.
I prefer to use Homebrew package manager to install required additional packages on my Mac OS X.
If you haven’t install Homebrew on your Mac, you just need to copy paste following command on your terminal and Homebrew will install on your Mac automatically. Remember you need an Internet connection to download these packages.
Once you installed Homebrew, you can install NGINX by using the following command.
Nginx will set following document root by default. But you can change to any path using nginx.conf file.
NGINX default document root
Configure NGINX virtual hosts
I have included my pre-configured virtual hosts as a zip file.
So you can download my pre-configured NGINX virtual host files here.
Once you download the zip file, unzip the contents and then you just need to copy into the following path. Furthermore, my NGINX virtual hosts specially configured for developing Magento 1, Magento 2 and WordPress projects in my local.
Step 1 – Rename existing “nginx” folder /usr/local/etc/
Step 2 – Copy downloaded “nginx” folder in to /usr/local/etc/
Step 3 – Change your system username
All the pre-configured NGINX virtual hosts are located under the following path.
You will find four configuration files under the above path.
- 00_upstream.conf – For Fast CGI upstream
- 10_localhost.com.conf – For Magento 1 hosts
- 20_localhost.com.conf – For Magento 2 hosts
- magestyle.conf – For WordPress and general hosts
Also, you will notice, each virtual host’s document root is defined under the above configuration files.
Update your host file
Also, you will need to update your host file for the custom virtual host names. So you can have a look my host file as an example.
NGINX server state management
Start NGINX Server
Reload NGINX Server
Stop NGINX Server
Test and verify NGINX services
My local configuration examples:
For Magento 1 projects
Local Document Root – /Users/chatura/htdocs/m1-local
Host name – http://m1-local.localhost.com/
Configuration file path – /usr/local/etc/nginx/servers/10_localhost.com.conf
For Magento2 projects
Local Document Root – /Users/chatura/htdocs/m2-local/web
Host name – http://m2-local.m2.localhost.com/
Configuration file path – /usr/local/etc/nginx/servers/20_localhost.com.conf
For WordPress and other projects
Local Document Root -/Users/chatura/htdocs/wp-test
Host name – http://wp-test.localhost.com/
Local Document Root – /usr/local/etc/nginx/servers/magestyle.conf
If you follow the following steps, you can replace default PHP with Homebrew PHP version. Also, you can easily upgrade or switch your PHP version according your project requirement.
Especially I am going use my development setup for Magento 2 development. So I followed the Magento technology stack documentation before decide which PHP version I need to install. So I am going to install PHP 7.1 version in my local environment as per the Magento 2 latest technology stack.
Use following “brew tap” command to allow Homebrew to tap into Homebrew PHP to formulae. Once you’ve done this, you’ve expanded your options of installable PHP versions. So these additional Git repos will be saved inside the (usr/local/Library/Taps) directory,
To check list of available configuration options
Install PHP without Apache and with PHP FPM
Install additonal PHP extensions
Setup PHP CLI binary
In addition, if you want to use the PHP command line tools, you need to update the $PATH environment variable of your shell profile.
If you use the default Bash shell:
If you use ZSH:
If you are not sure which one you use, run following code in your terminal. I am using ZSH and it returns “/bin/zsh”
Web Server Php For Mac Shortcut
Configure PHP using PHP-FPM
PHP-FPM is a modern way of running PHP with a process manager and the FastCGI protocol. Also, this enables high performance as well as easy switching between various versions of PHP.
Note: Also you can install many PHP version with Homebrew package manager. You just need to link required PHP version and unlink other PHP versions.
Check Installed PHP version and php.ini file
PHP service management
Let’s install MySQL server.
Also, you can use the following command to MySQL server gets automatically started and stopped when the Mac is shutdown/powered on.
So, you can start MySQL start service manually using the following command for now.
MySQL service management
Test MySQL connection
I hope this article will help you to install Nginx, PHP, MySQL on your Mac OS. Let me know in case you’re stuck at some point or have general feedback. Please feel free to comment below.
Server For Php
May 4, 2013 11:51 PM
Great guide, thanks John.
Just a note, in case anyone has the same issue. At first I couldn't get this to work. I tried logging out and back in (still no joy), then restarting the mac (still no joy).
Try doing both of those first. However, if, like me, you still can't get the local host site to load, try the following: You should find a file at /Library/WebServer/Documents/index.html.en . This contains the text 'It works!' referred to in the post. What I did was duplicate that file in the same folder and changed the duplicate's name to 'index.html', leaving the original in situ.
Both local and user sites then loaded. After which, I was able to delete the duplicated file and everything now works without issue. Just to be clear, leave the original file index.html.en where it is, untouched and unharmed throughout this step.
Not sure why I had to take this mysterious detour - probably something local to my machine, but if you're having trouble after following the guide above, see if it helps.
May 4, 2013 11:51 PM