NGINX and PHP
Installation and Configuration
NGINX
HTTP and reverse proxy server, a mail proxy
server, and a generic TCP/UDP proxy server.
Originally written by Igor Sysoev.
Served or proxied 30.46% busiest sites in
January 2018, including Dropbox, Netflix,
Wordpress.com, FastMail.FM
The sources and documentation are distributed
under the 2-clause BSD-like license.
Commercial support is available from Nginx,
Inc. (www.nginx.com)
Where to get ?
Official web site :
http://www.nginx.org
Latest version :
Stable : 1.12.xx
Mainline : 1.13.xx
Supported Platform :
UNIX, Linux, Mac OSX
MS Windows Server or Desktop
Additional Resources
E-book can be
downloaded for free at
https://www.nginx.com
/resources/library/com
plete-nginx-
cookbook/?utm_sourc
e=nginxorg&utm_medi
um=homepagebanner
&utm_campaign=com
plete_cookbook
Download
Click here to download
NGINX for Windows
Click here to download
NGINX for Unix
Installing NGINX on MS
Windows Platform
Extract the downloaded zip file to any folder
you like, i.e. c:\nginx, as long as no space in
folder name.
Go to folder conf and edit nginx.conf file to
configure nginx.
Running NGINX on MS
Windows Platform
To start NGINX, go to folder root of the
NGINX folder, and type "nginx" and
press Enter.
To stop the NGINX, go to folder root of the
NGINX folder, and type "taskkill /f
/IM nginx.exe" and press Enter.
NGINX Configuration
Prior of running NGINX, we have to
configure it first.
The configuration file is usually located
at folder nginx/conf/.
The default name for NGINX
configuration file is nginx.conf.
The configuration file basically is a text
file, so we can change it using any text
editor program.
Important Settings
There are few settings in nginx.conf file
that must be set, prior to running the
nginx.exe :
worker_connections : Maximum number of
connection that can be served.
sendfile : Enabling sending files capabilities.
keepalive_timeout : number of seconds
before timeout.
listen : number of port that NGINX will listen.
server_name : name or IP address of NGINX
server.
Important Settings, cont…
root : Location of root folder of the HTML
document (under NGINX folder).
index : name of index (default) file to open
when user do not supply a file name.
error_page : name/location of file to be open
when particularly error happens.
location : redirect location when particular
pattern appears.
Include : includes another file, or files
matching the specified mask, into configuration.
Warning !!!
Every time you edit (make changes) in
nginx.conf file, you must shutdown
and start again the NGINX in order for
the change(s) to take effects.
If you not restart the NGINX, the
changes will not affect anything until
next start.
PHP
PHP is a popular general-purpose
scripting language that is especially
suited to web development.
Most popular scripting language in use
for websites.
PHP is free to download and use.
Where to get ?
Official web site :
www.php.net
Latest version :
7.0.xx
Supported Platform :
UNIX, Linux, Mac OSX
MS Windows Server 2000 or higher
Unix Platform
Click here to download PHP for
Unix/Linux/OSX Platform
MS Windows Platform
Click here to download PHP
for Windows Platform
MS Windows Platform, cont…
MS Windows Platform, cont…
Which version to download ?
Non Thread Safe versions are for computer that
only have single core single thread processor,
for non threaded environment, or for testing
purpose only.
Nowadays, most platforms have multicore
multithread processor, so its better to download
the Thread Safe versions.
Always download the version that matched to
the NGINX version installed.
Installing PHP
Extract the downloaded file into any folder you
choose, preferably inside the NGINX folder,
i.e. c:\nginx\php.
Add few settings in nginx.conf file :
location ~ \.php$ {
try_files $uri =404;
location ~ \..*/.*\.php$ {return 404;}
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME
c:/nginx/html/$fastcgi_script_name;
include fastcgi_params;
}
Restart the NGINX Server.
PHP Configuration
Prior of running PHP, we have to configure it
first.
The configuration file is located at folder
where the PHP is installed.
The default name for PHP configuration file
is php.ini.
The configuration file basically is a text file,
so we can change it using any text editor
program.
Important Settings
There are few settings in php.ini file that
must be set, before running the PHP :
engine : Directive to enable/disable PHP.
short_open_tag : Directive to enable/disable
short tag.
asp_tags : Directive to enable/disable ASP
like tag.
Precision : Directive to set how many digit
use in floating point number.
Warning !!!
Every time you edit (make changes) in
php.ini file, you must restart the
NGINX Server in order for the
change(s) to take effects.
If you not restart the NGINX Server,
the changes will not affect anything
until next start/restart.
Non-Sucking Service Manager
(NSSM)
To run NGINX and PHP automatically,
it’s preferable to run them as services.
NSSM is a service helper which
doesn't suck, because it handle failure
of the application running as a service.
NSSM monitors the running service
and will restart it if it dies. With NSSM
you know that if a service says it's
running, it really is.
Non-Sucking Service Manager
(NSSM), cont…
You can configure NSSM to absolve all
responsibility for restarting it and let
Windows take care of recovery actions.
NSSM logs its progress to the system Event
Log so you can get some idea of why an
application isn't behaving as it should.
NSSM also features a graphical service
installation and removal facility.
NSSM is public domain. You may
unconditionally use it and/or its source code
for any purpose you wish.
Where to get ?
Official web site :
www.nssm.cc
Latest version :
2.24-xxx
Supported Platform :
MS Windows 2000 or later
Installing NSSM
Extract the downloaded file into any folder you
choose, preferably inside the Program Files
folder, i.e. c:\Program Files\.
Installing NGINX as a service
using NSSM
Open the installed folder.
Select folder that matched
your operating system.
Installing NGINX as a service
using NSSM, cont…
Press Shift + RightClick
simultaneously.
Select Open command
window here.
Type nssm install.
Installing NGINX as a service
using NSSM, cont…
Select nginx.exe
Select NGINX folder
After everything is done, click
here to install NGINX service
Type the service name, i.e. “NGINX Service”
Installing PHP as a service
using NSSM
Open the installed folder.
Select folder that matched
your operating system.
Installing PHP as a service
using NSSM, cont…
Press Shift + RightClick
simultaneously.
Select Open command
window here.
Type nssm install.
Installing PHP as a service
using NSSM, cont…
Select php-cgi.exe
Select PHP folder
After everything is
done, click here to
install NGINX
service
Type “-b 127.0.0.1:9000 -c c:\nginx\php\php.ini”
Type the service name, i.e. “PHP Service”
Running NGINX and PHP
Services
Press Windows Key + R
simultaneously.
Type services.msc.
Select PHP Service, and click Start.
Select NGINX Service, and click
Start.
To stop the service, select the service
and click Stop.
Important !!!
You should run the PHP service prior
to NGINX service.
Failed to do so can result that NGINX
unable to recognize the PHP service.
You can test your services by
browsing to localhost (127.0.0.1).
