wp-lite-env

A simple, lightweight, docker-based WordPress environment

Usage

Installation

To install the package, run the following command:

npm install -g @elementor/wp-lite-env

If you want to install the package for a specific project, run the following command:

npm install --save-dev @elementor/wp-lite-env

Creating a configuration file

The configuration file is a JSON file that contains the configuration for the WordPress environment.

The following is an example of a configuration file:

{
  "core": "6.7",
  "phpVersion": "8.2",
  "plugins": {
    "elementor": "./elementor/build"
  },
  "themes": {
    "hello-elementor": "./hello-elementor"
  },
  "mappings": {
    "resources": "./resources"
  },
  "config": {
    "SCRIPT_DEBUG": false,
    "WP_DEBUG": false
  }
}

Usage

Starting a new WordPress environment

To start a new WordPress environment, run the following command:

npx wp-lite-env start config=<path to configuration file> -- port=<port>

For example:

npx wp-lite-env start config=./tests/.wp-lite-env.json -- port=1234

Stopping a WordPress environment

To stop a running WordPress environment, run the following command:

npx wp-lite-env start config=<path to configuration file> -- port=<port used by the WordPress environment>

For example:

npx wp-lite-env stop config=./tests/.wp-lite-env.json -- port=1234

Starting a new WordPress environment

The WordPress CLI is available for use on the server. To use it, run the following command:

npx wp-lite-env cli config=<path to configuration file> -- port=<port used by the WordPress environment> command="<CLI command>"

For example:

npx wp-lite-env cli config=./tests/.wp-lite-env.json -- port=1234 command="ls -la /var/www/html"

Contributors

This package is developed and maintained by the Elementor team. With that being said, we want to thank the @wordpress/env team, this package is heavily inspired by their wonderful work.