Disable certain plugins in non-production environments using PHP constants.

Installs: 600

Dependents: 0

Suggesters: 0

Security: 0

Stars: 16

Watchers: 2

Forks: 2

Open Issues: 1


v1.2.0 2020-07-17 20:06 UTC


Packagist Supported PHP Versions GitHub Repository Size Build Status Downloads

Define an array of plugins that deactivate automatically in certain environments (e.g. caching plugins in development).

Inspired by this blog post by Kamil Grzegorczyk. Uses a fork of the DisablePlugins class written by Mark Jaquith.


This plugin is designed to work with Bedrock based sites, and will not work with a Standard WordPress installation.

$ composer require lukasbesch/bedrock-plugin-disabler

It will be installed as a wordpress-muplugin.
If you try to activate it as a regular plugin, the plugin will deactivate itself with a notice.

Manual Installation (not recommended)

Download the latest release and place it in your web/app/mu-plugins folder.


Define the constant DISABLED_PLUGINS with an array of the plugins main files you want to deactivate in your preferred environment configuration, for example config/environments/development.php:

Config::define('DISABLED_PLUGINS', [

If you have an older Bedrock installation (< 1.9.0) you have to define the constant using the regular define() function:

if (! defined('DISABLED_PLUGINS')
    define('DISABLED_PLUGINS', [

PHP 5.6+ can store arrays in constants, but you can also provide serialized data:

Config::define('DISABLED_PLUGINS', serialize([