zf-development-mode

This package provides a script to allow you to enable and disable development
mode for zend-mvc (both versions 2
and 3) and Expressive
applications. The script allows you to specify configuration and modules that
should only be enabled when in development, and not when in production.

Note to v2 users

If you were using a v2 version of this package previously, invocation has
changed. Previously, you would invoke it via the MVC CLI bootstrap:

$ php public/index.php development enable  # enable development mode
$ php public/index.php development disable # disable development mode

v3 releases now install this as a vendor binary, with no dependencies on other
components:

$ ./vendor/bin/zf-development-mode enable  # enable development mode
$ ./vendor/bin/zf-development-mode disable # disable development mode

Installation

Install this package using Composer:

$ composer require zfcampus/zf-development-mode

Once installed, you will need to copy a base development configuration into your
application; this configuration will allow you to override modules and bootstrap
configuration:

$ cp vendor/zfcampus/zf-development-mode/development.config.php.dist config/

Optionally, if you want to also have development-specific application
configuration, you can copy another base configuration into your configuration
autoload directory:

$ cp vendor/zfcampus/zf-development-mode/development.local.php.dist config/autoload/

In order for the bootstrap development configuration to run, you may need to
update your application bootstrap. Look for the following lines (or similar) in
public/index.php:

// Run the application!
Zend\Mvc\Application::init(require 'config/application.config.php')->run();

Replace the above with the following:

// Config
$appConfig = include 'config/application.config.php';
if (file_exists('config/development.config.php')) {
    $appConfig = Zend\Stdlib\ArrayUtils::merge($appConfig, include 'config/development.config.php');
}

// Run the application!
Zend\Mvc\Application::init($appConfig)->run();

To enable development mode

$ cd path/to/project
$ ./vendor/bin/zf-development-mode enable

Note: enabling development mode will also clear your module configuation cache,
to allow safely updating dependencies and ensuring any new configuration is
picked up by your application.

To disable development mode

$ cd path/to/project
$ ./vendor/bin/zf-development-mode disable

Note: Don't run development mode on your production server!