WordPress

This is a WordPress engine for Nanobox. This engine is based off of the basic PHP engine, and shares many of the configuration options from it.

App Detection

• To detect a WordPress app, this engine looks for a directory named wp-content.

Build Process

• Generate wp-config.php
• composer install

Basic Configuration Options

This engine exposes configuration options through the Boxfile, a yaml config file used to provision and configure your app's infrastructure when using Nanobox.

Advanced Configuration Options

This Readme outlines only the most basic and commonly used settings. For the full list of available configuration options, view the Advanced PHP Configuration options.

Overview of Basic Boxfile Configuration Options

build:
  # Web Server Settings
  webserver: 'apache'
  document_root: '/'

  # PHP Settings
  php_runtime: 'php-5.6'
  php_extensions:
    - curl
    - gd
    - mbstring
    - pdo_mysql
  php_zend_extensions:
    - ioncube_loader
    - opcache
  php_max_execution_time: 30
  php_max_input_time: 30
  php_error_reporting: E_ALL
  php_display_errors: 'stderr'
  php_post_max_size: '8M'
  php_upload_max_filesize: '2M'
  php_file_uploads: true

  # Apache Settings
  apache_php_interpreter: fpm
  apache_access_log: false

Quick Links

Web Server Settings
PHP Settings
Apache Settings

Web Server Settings

The following setting is used to select which web server to use in your application.

• webserver
• document_root

---

webserver

The following web servers are available:

• apache (default)
• nginx
• builtin (PHP's built-in web server available in 5.4+)

build:
  webserver: 'apache'

*Web server specific settings are available in the following sections of the Advanced PHP Configuration doc:

Apache Settings
Nginx Settings
Built-In PHP Web Server Settings

---

document_root

The public root of your web application. For instance, if you like to house your app in /public for security or organizational purposes, you can specify that here. The default is the /.

build:
  document_root: '/'

---

PHP Settings

The following settings are typically configured in the php.ini. When using Nanobox, these are configured in the Boxfile.

• php_runtime
• php_extensions
• php_zend_extensions
• php_max_execution_time
• php_max_input_time
• php_error_reporting
• php_display_errors
• php_post_max_size
• php_upload_max_filesize
• php_file_uploads
• php_date_timezone

---

php_runtime

Specifies which PHP runtime and version to use. The following runtimes are available:

• php-5.3
• php-5.4
• php-5.5
• php-5.6
• php-7.0

build:
  php_runtime: 'php-5.6'

---

php_extensions

Specifies what PHP extensions should be included in your app's environment. To see what PHP extensions are available, view the full list of available PHP extensions.

build:
  php_extensions:
    - curl
    - gd
    - mbstring
    - pdo_mysql

---

php_zend_extensions

Specifies what Zend extensions should be included in your app's environment. To see what Zend extensions are available, view the Zend Extensions section of the PHP extensions list.

build:
  php_zend_extensions:
    - ioncube_loader
    - opcache

---

php_max_execution_time

Sets the max_execution_time PHP setting.

build:
  php_max_execution_time: 30

---

php_max_input_time

Sets the max_input_time PHP setting.

build:
  php_max_input_time: 60

---

php_error_reporting

Sets the error_reporting PHP setting.

build:
  php_error_reporting: E_ALL

---

php_display_errors

Sets the display_errors PHP setting.

build:
  php_display_errors: 'stderr'

---

php_post_max_size

Sets the post_max_size PHP setting.

build:
  php_post_max_size: '8M'

---

php_upload_max_filesize

Sets the upload_max_filesize PHP setting.

build:
  php_upload_max_filesize: '2M'

---

php_file_uploads

Sets the file_uploads PHP setting.

build:
  php_file_uploads: true

---

php_date_timezone

Sets the date.timezone PHP setting.

build:
  php_date_timezone: 'US/central'

---

Apache Settings

The following settings are used to configure Apache. These only apply when using apache as your webserver.

• apache_php_interpreter
• apache_access_log

---

apache_php_interpreter

Specify which PHP interpreter you would like Apache to use.

• fpm (default)
• mod_php

build:
  apache_php_interpreter: fpm

---

apache_access_log

Enables or disables the Apache Access log.

build:
  apache_access_log: false

---