Varying Vagrant Vagrants logo Varying Vagrant Vagrants

Some sites use Apache or IIS to serve pages, but VVV uses the popular Nginx. VVV provides an include for setting up WordPress easily, and a file for setting your own Nginx configuration on a per site basis named vvv-nginx.conf.

A Standard WordPress Nginx Configuration

For most WordPress sites, this NGINX configuration will suffice:

server {
  listen 80;
  listen 443 ssl;
  server_name {vvv_site_name}.local;
  root {vvv_path_to_site}/public_html;

  error_log {vvv_path_to_site}/log/error.log;
  access_log {vvv_path_to_site}/log/access.log;

  set $upstream {upstream};

  include /etc/nginx/nginx-wp-common.conf;
}

This will give you:

You will need to create the public_html and log folders if they don’t exist

nginx-wp-common.conf

This is an Nginx config file provided by VVV. Including it pulls in a number of useful rules, such as PHP Fast CGI and rules for using Nginx with permalinks.

While not required, it’s strongly recommended that this config file is included.

Nginx Variable Replacements

Before VVV copies the configs to there final location, it runs a search replace routine. This allows variables containing information about the site to be used inside the Nginx config.

The config at the top of this page contains several examples. E.g. {vvv_site_name} is used to set the domain used, and {vvv_path_to_site} is used to set the root and log locations.

Nginx Upstream

You may have noticed this line in the example above:

set $upstream {upstream};

The {upstream} variable is set from vvv-custom.yml, and is used to determine the version of PHP to use. Removing this will disable that functionality.

It may be desirable to force a site to use a particular version of PHP, for details see the changing PHP versions documentation.

PHP Error Logs

error_log {vvv_path_to_site}/log/error.log;
access_log {vvv_path_to_site}/log/access.log;

These two lines tell Nginx where to log errors and requests to the site. In this example, the logs for the example site are located at www/example/log/error.log

Because the logs are being saved in a subfolder, it will be necessary to create the log folder and initial log files during provision. To do this, add these lines to vvv-init.sh:

# Nginx Logs
mkdir -p ${VVV_PATH_TO_SITE}/log
touch ${VVV_PATH_TO_SITE}/log/error.log
touch ${VVV_PATH_TO_SITE}/log/access.log