EasyEngine package for PHP site creation.
Quick links: Using | Contributing | Support
This package implements the following commands:
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 and latest.
---
default: latest
options:
- 5.6
- 7.2
- 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
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
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
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 and latest.
---
default: latest
options:
- 5.6
- 7.2
- 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
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
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
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
Verifies ssl challenge and also renews certificates(if expired).
ee site ssl <site-name> [--force]
OPTIONS
<site-name>
Name of website.
[--force]
Force renewal.
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
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 and latest.
---
default: latest
options:
- 5.6
- 7.2
- 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
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 and latest.
---
default: latest
options:
- 5.6
- 7.2
- 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
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
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
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.
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.
Want to contribute a new feature? Please first open a new issue to discuss whether the feature is a good fit for the project.
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.