WinNMP - portable Nginx MariaDB Redis Php development stack for Windows

A portable, preconfigured, lightweight, fast and stable server stack for developing php mysql applications on windows, based on the excellent webserver Nginx. A lighter alternative to XAMPP and WAMP.

How to create a new Project

New Project

Create new PHP projects using various web application frameworks

Configure NGINX virtual server for various PHP Frameworks

How to install Magento 2 on Windows

How to install free SSL Certificates from LetsEncrypt

How to upload files or synchronize your project to a server using WinSCP:

Project Buttons

How to use COMPOSER:

Composer

Composer is a tool for dependency management in PHP used to download and keep updated various PHP frameworks and components. After you created a new project in c:\pathTo\WWW\myProjectName, click on Open Command Prompt icon, then run commands like:

composer create-project silverstripe/installer myProjectName 3.1.*

composer create-project laravel/laravel myProjectName --prefer-dist

cd myProjectName
composer require components/jquery 
composer require components/bootstrap-datetimepicker

cd myProjectName
composer create-project symfony/framework-standard-edition c:\pathTo\WWW\myProjectName 2.4.*

How to change the root directory of a project:

Your project's Nginx settings are stored in conf\domains.d\myProjectName.conf. This file`s root directive is automatically modified by the WinNMP manager for portability.

If you want to use a custom root folder for your project, for example WWW\myProjectName\public, you can manually set this root directive and lock it using the comment # locked

    root "C:\PathTo\WWW\myProjectName\public"; # locked

How to send emails using PHP

WinNMP has 2 options for processing emails sent by PHP's mail() function: mSmtp and mailToDisk (default). To change the option, edit conf\php.ini and modify sendmail_path:

How to allow access from LAN and Internet to your local project:

In the Projects list, click Project Setup, check Enable Local Virtual Server, then Save.

Edit WinNMP\conf\domains.d\projectName.conf directly or click on Edit Nginx Virtual Server button in the Edit Project window Edit Nginx Local Virtual Server

Modify like this:

server {
    listen      127.0.0.1:80;
    listen          *:80;

    server_name     projectName.test projectName.com projectName.myDomain.com;

    ### Access Restrictions
    allow           all;
    ## deny         all;

Now Kill Nginx, Start Nginx OR Check Nginx Configuration Syntax.

How to add additional local test server names to my project:

Hosts File Editor

You can always use different/multiple server names for your Local Virtual Server. Use Hosts File Editor (the third icon) to add extra local server names like:

127.0.0.1    projectName.dev
127.0.0.1    projectName.test
127.0.0.1    www.projectName.xyz

Then Edit conf\domains.d\projectName.conf and add

server_name projectName.dev projectName.test www.projectName.xyz;

How to add locations

If you want a location like /phpMyAdmin to serve files from a directory outside your project (but inside PHP's open_basedir), for example C:/WinNMP/include/phpMyAdmin you need to edit the Nginx config file:

Edit WinNMP\conf\domains.d\projectName.conf to set http://projectName.local/phpMyAdmin

Edit WinNMP\conf\nginx.conf to set http://localhost/phpMyAdmin

server {
    ....
    location ~ ^/phpMyAdmin/.*\.php$ {
            root "C:/WinNMP/include";
            try_files $uri =404;
            include         nginx.fastcgi.conf;
            fastcgi_pass    php_farm;
            allow           127.0.0.1;
            allow           ::1;
            deny            all;
    }
    location ~ ^/phpMyAdmin/ {
             root "C:/WinNMP/include";
    }
}

Notice that the root directive lacks /phpMyAdmin because Nginx adds the URL path /phpMyAdmin to the root path, so the resulting directory is C:/WinNMP/include/phpMyAdmin