README

EasyEngine package for PHP site creation.

Quick links: Using | Contributing | Support

Using

This package implements the following commands:

ee site create --type=php

Runs the standard PHP Site installation.

ee site create --type=php <site-name> [--cache] [--admin-email=<admin-email>]  [--with-db] [--local-db] [--php=<php-version>] [--dbname=<dbname>] [--dbuser=<dbuser>] [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--with-local-redis] [--skip-check] [--skip-status-check] [--ssl=<value>] [--wildcard] [--force]

OPTIONS

<site-name>
	Name of website.

[--cache]
	Use redis cache for PHP.

[--admin-email=<admin-email>]
	E-Mail of the administrator.

 [--with-db]
	Create database for php site.

[--local-db]
	Create separate db container instead of using global db.

[--php=<php-version>]
	PHP version for site. Currently only supports PHP 5.6, 7.0, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5, and latest.
	---
	default: 8.4
	options:
		- 5.6
		- 7.0
		- 7.2
		- 7.3
		- 7.4
		- 8.0
		- 8.1
		- 8.2
		- 8.3
		- 8.4
		- 8.5
		- latest
	---

[--dbname=<dbname>]
	Set the database name.

[--dbuser=<dbuser>]
	Set the database user.

[--dbpass=<dbpass>]
	Set the database password.

[--dbhost=<dbhost>]
	Set the database host. Pass value only when remote dbhost is required.

[--with-local-redis]
	Enable cache with local redis container.

[--skip-check]
	If set, the database connection is not checked.

[--skip-status-check]
	Skips site status check.

[--ssl=<value>]
	Enables ssl on site.

[--wildcard]
	Gets wildcard SSL .

[--force]
	Resets the remote database if it is not empty.

EXAMPLES

# Create php site (without db)
$ ee site create example.com --type=php

# Create php site with db
$ ee site create example.com --type=php --with-db

# Create php site with ssl from letsencrypt
$ ee site create example.com --type=php --ssl=le

# Create php site with wildcard ssl
$ ee site create example.com --type=php --ssl=le --wildcard

# Create php site with self signed certificate
$ ee site create example.com --type=php --ssl=self

# Create php site with remote database
$ ee site create example.com --type=php --with-db --dbhost=localhost --dbuser=username --dbpass=password

ee site delete

Deletes a website.

ee site delete <site-name> [--yes]

OPTIONS

<site-name>
	Name of website to be deleted.

[--yes]
	Do not prompt for confirmation.

EXAMPLES

# Delete site
$ ee site delete example.com

ee site update

Supports updating and upgrading site.

ee site update [<site-name>] [--ssl=<ssl>] [--wildcard]

[<site-name>]
	Name of the site.

[--ssl=<ssl>]
	Enable ssl on site

[--wildcard]
	Enable wildcard SSL on site.

EXAMPLES

# Add SSL to non-ssl site
$ ee site update example.com --ssl=le

# Add SSL to non-ssl site
$ ee site update example.com --ssl=le --wildcard

# Add self-signed SSL to non-ssl site
$ ee site update example.com --ssl=self

ee site info --type=php

Runs the standard PHP Site installation.

ee site info --type=php <site-name> [--cache] [--admin-email=<admin-email>]  [--with-db] [--local-db] [--php=<php-version>] [--dbname=<dbname>] [--dbuser=<dbuser>] [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--with-local-redis] [--skip-check] [--skip-status-check] [--ssl=<value>] [--wildcard] [--force]

OPTIONS

<site-name>
	Name of website.

[--cache]
	Use redis cache for PHP.

[--admin-email=<admin-email>]
	E-Mail of the administrator.

 [--with-db]
	Create database for php site.

[--local-db]
	Create separate db container instead of using global db.

[--php=<php-version>]
	PHP version for site. Currently only supports PHP 5.6, 7.0, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5, and latest.
	---
	default: 8.4
	options:
		- 5.6
		- 7.0
		- 7.2
		- 7.3
		- 7.4
		- 8.0
		- 8.1
		- 8.2
		- 8.3
		- 8.4
		- 8.5
		- latest
	---

[--dbname=<dbname>]
	Set the database name.

[--dbuser=<dbuser>]
	Set the database user.

[--dbpass=<dbpass>]
	Set the database password.

[--dbhost=<dbhost>]
	Set the database host. Pass value only when remote dbhost is required.

[--with-local-redis]
	Enable cache with local redis container.

[--skip-check]
	If set, the database connection is not checked.

[--skip-status-check]
	Skips site status check.

[--ssl=<value>]
	Enables ssl on site.

[--wildcard]
	Gets wildcard SSL .

[--force]
	Resets the remote database if it is not empty.

EXAMPLES

# Create php site (without db)
$ ee site create example.com --type=php

# Create php site with db
$ ee site create example.com --type=php --with-db

# Create php site with ssl from letsencrypt
$ ee site create example.com --type=php --ssl=le

# Create php site with wildcard ssl
$ ee site create example.com --type=php --ssl=le --wildcard

# Create php site with self signed certificate
$ ee site create example.com --type=php --ssl=self

# Create php site with remote database
$ ee site create example.com --type=php --with-db --dbhost=localhost --dbuser=username --dbpass=password

ee site enable

Enables a website. It will start the docker containers of the website if they are stopped.

ee site enable [<site-name>] [--force] [--verify]

OPTIONS

[<site-name>]
	Name of website to be enabled.

[--force]
	Force execution of site enable.

[--verify]
	Verify if required global services are working.

EXAMPLES

# Enable site
$ ee site enable example.com

# Enable site with verification of dependent global services. (Note: This takes longer time to enable the
site.)
$ ee site enable example.com --verify

# Force enable a site.
$ ee site enable example.com --force

ee site disable

Disables a website. It will stop and remove the docker containers of the website if they are running.

ee site disable [<site-name>]

OPTIONS

[<site-name>]
	Name of website to be disabled.

EXAMPLES

# Disable site
$ ee site disable example.com

ee site info

Display all the relevant site information, credentials and useful links.

ee site info [<site-name>]

[<site-name>]
	Name of the website whose info is required.

EXAMPLES

# Display site info
$ ee site info example.com

ee site ssl

Verifies ssl challenge and also renews certificates(if expired).

ee site ssl <site-name> [--force]

OPTIONS

<site-name>
	Name of website.

[--force]
	Force renewal.

ee site list

Lists the created websites.

ee site list [--enabled] [--disabled] [--format=<format>]

abstract list

[--enabled]
	List only enabled sites.

[--disabled]
	List only disabled sites.

[--format=<format>]
	Render output in a particular format.
	---
	default: table
	options:
	  - table
	  - csv
	  - yaml
	  - json
	  - count
	  - text
	---

EXAMPLES

# List all sites
$ ee site list

# List enabled sites
$ ee site list --enabled

# List disabled sites
$ ee site list --disabled

# List all sites in JSON
$ ee site list --format=json

# Count all sites
$ ee site list --format=count

ee site reload --type=php

Runs the standard PHP Site installation.

ee site reload --type=php <site-name> [--cache] [--admin-email=<admin-email>]  [--with-db] [--local-db] [--php=<php-version>] [--dbname=<dbname>] [--dbuser=<dbuser>] [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--with-local-redis] [--skip-check] [--skip-status-check] [--ssl=<value>] [--wildcard] [--force]

OPTIONS

<site-name>
	Name of website.

[--cache]
	Use redis cache for PHP.

[--admin-email=<admin-email>]
	E-Mail of the administrator.

 [--with-db]
	Create database for php site.

[--local-db]
	Create separate db container instead of using global db.

[--php=<php-version>]
	PHP version for site. Currently only supports PHP 5.6, 7.0, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5, and latest.
	---
	default: 8.4
	options:
		- 5.6
		- 7.0
		- 7.2
		- 7.3
		- 7.4
		- 8.0
		- 8.1
		- 8.2
		- 8.3
		- 8.4
		- 8.5
		- latest
	---

[--dbname=<dbname>]
	Set the database name.

[--dbuser=<dbuser>]
	Set the database user.

[--dbpass=<dbpass>]
	Set the database password.

[--dbhost=<dbhost>]
	Set the database host. Pass value only when remote dbhost is required.

[--with-local-redis]
	Enable cache with local redis container.

[--skip-check]
	If set, the database connection is not checked.

[--skip-status-check]
	Skips site status check.

[--ssl=<value>]
	Enables ssl on site.

[--wildcard]
	Gets wildcard SSL .

[--force]
	Resets the remote database if it is not empty.

EXAMPLES

# Create php site (without db)
$ ee site create example.com --type=php

# Create php site with db
$ ee site create example.com --type=php --with-db

# Create php site with ssl from letsencrypt
$ ee site create example.com --type=php --ssl=le

# Create php site with wildcard ssl
$ ee site create example.com --type=php --ssl=le --wildcard

# Create php site with self signed certificate
$ ee site create example.com --type=php --ssl=self

# Create php site with remote database
$ ee site create example.com --type=php --with-db --dbhost=localhost --dbuser=username --dbpass=password

ee site restart --type=php

Runs the standard PHP Site installation.

ee site restart --type=php <site-name> [--cache] [--admin-email=<admin-email>]  [--with-db] [--local-db] [--php=<php-version>] [--dbname=<dbname>] [--dbuser=<dbuser>] [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--with-local-redis] [--skip-check] [--skip-status-check] [--ssl=<value>] [--wildcard] [--force]

OPTIONS

<site-name>
	Name of website.

[--cache]
	Use redis cache for PHP.

[--admin-email=<admin-email>]
	E-Mail of the administrator.

 [--with-db]
	Create database for php site.

[--local-db]
	Create separate db container instead of using global db.

[--php=<php-version>]
	PHP version for site. Currently only supports PHP 5.6, 7.0, 7.2, 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4, 8.5, and latest.
	---
	default: 8.4
	options:
		- 5.6
		- 7.0
		- 7.2
		- 7.3
		- 7.4
		- 8.0
		- 8.1
		- 8.2
		- 8.3
		- 8.4
		- 8.5
		- latest
	---

[--dbname=<dbname>]
	Set the database name.

[--dbuser=<dbuser>]
	Set the database user.

[--dbpass=<dbpass>]
	Set the database password.

[--dbhost=<dbhost>]
	Set the database host. Pass value only when remote dbhost is required.

[--with-local-redis]
	Enable cache with local redis container.

[--skip-check]
	If set, the database connection is not checked.

[--skip-status-check]
	Skips site status check.

[--ssl=<value>]
	Enables ssl on site.

[--wildcard]
	Gets wildcard SSL .

[--force]
	Resets the remote database if it is not empty.

EXAMPLES

# Create php site (without db)
$ ee site create example.com --type=php

# Create php site with db
$ ee site create example.com --type=php --with-db

# Create php site with ssl from letsencrypt
$ ee site create example.com --type=php --ssl=le

# Create php site with wildcard ssl
$ ee site create example.com --type=php --ssl=le --wildcard

# Create php site with self signed certificate
$ ee site create example.com --type=php --ssl=self

# Create php site with remote database
$ ee site create example.com --type=php --with-db --dbhost=localhost --dbuser=username --dbpass=password

ee site share

Share a site online using ngrok.

ee site share <site-name> [--disable] [--refresh] [--token=<token>]

OPTIONS

<site-name>
	Name of website.

[--disable]
	Take online link down.

[--refresh]
	Refresh site share if link has expired.

[--token=<token>]
	ngrok token.

EXAMPLES

# Share a site online
$ ee site share example.com

# Refresh shareed link if expired
$ ee site share example.com --refresh

# Disable online link
$ ee site share example.com --disable

ee site clean

Clears Object and Page cache for site.

ee site clean [<site-name>] [--page] [--object]

OPTIONS

[<site-name>]
	Name of website to be enabled.

[--page]
	Clear page cache.

[--object]
	Clear object cache.

EXAMPLES

# Clear Both cache type for site.
$ ee site clean example.com

# Clear Object cache for site.
$ ee site clean example.com --object

# Clear Page cache for site.
$ ee site clean example.com --page

Contributing

We appreciate you taking the initiative to contribute to this project.

Contributing isn’t limited to just code. We encourage you to contribute in the way that best fits your abilities, by writing tutorials, giving a demo at your local meetup, helping other users with their support questions, or revising our documentation.

Reporting a bug

Think you’ve found a bug? We’d love for you to help us get it fixed.

Before you create a new issue, you should search existing issues to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version.

Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please create a new issue. Include as much detail as you can, and clear steps to reproduce if possible.

Creating a pull request

Want to contribute a new feature? Please first open a new issue to discuss whether the feature is a good fit for the project.

Support

Github issues aren't for general support questions, but there are other venues you can try: https://easyengine.io/support/

This README.md is generated dynamically from the project's codebase using ee scaffold package-readme (doc). To suggest changes, please submit a pull request against the corresponding part of the codebase.