trellis

WordPress LEMP stack with PHP 8.2, Composer, WP-CLI and more

2,489

607

2,489

View on GitHub

Top Related Projects

bedrock

6,142

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

Quick Overview

Trellis is an open-source WordPress development and deployment tool that provides a modern server stack and unified development workflow for WordPress. It aims to make setting up and managing WordPress sites easier, more secure, and more consistent across different environments.

Pros

Provides a consistent development environment across team members
Improves security with better server configurations and SSL by default
Simplifies deployment process with one-command deploys
Integrates well with modern development workflows and tools

Cons

Steep learning curve for developers not familiar with Ansible or command-line tools
May be overkill for simple WordPress sites or small projects
Requires more server resources compared to traditional shared hosting
Limited flexibility for highly customized server configurations

Getting Started

Install dependencies:
```
brew install ansible
```

Clone the Trellis repository:

git clone --depth=1 git@github.com:roots/trellis.git

Configure your site in group_vars/development/wordpress_sites.yml:

wordpress_sites:
  example.com:
    site_hosts:
      - canonical: example.test
        redirects:
          - www.example.test
    local_path: ../site
    admin_email: admin@example.test
    multisite:
      enabled: false
    ssl:
      enabled: false
      provider: self-signed
    cache:
      enabled: false

Provision your local environment:
```
vagrant up
```
Access your new WordPress site at https://example.test

Competitor Comparisons

bedrock

6,142

WordPress boilerplate with Composer, easier configuration, and an improved folder structure

Pros of Bedrock

More flexible and customizable WordPress development environment
Easier integration with modern development workflows and tools
Better suited for complex, custom WordPress projects

Cons of Bedrock

Steeper learning curve for developers new to modern WordPress development
May require more initial setup and configuration
Less suitable for simple WordPress sites or quick prototypes

Code Comparison

Bedrock's directory structure:

├── composer.json
├── config
│   ├── application.php
│   └── environments
├── web
│   ├── app
│   └── wp
└── wp-config.php

Trellis's directory structure:

├── group_vars
├── hosts
├── roles
├── site.yml
└── wordpress-sites.yml

Bedrock uses Composer for dependency management and follows a more modern PHP application structure, while Trellis focuses on server provisioning and deployment using Ansible.

Bedrock's composer.json:

{
  "name": "roots/bedrock",
  "type": "project",
  "license": "MIT",
  "description": "WordPress boilerplate with modern development tools, easier configuration, and an improved folder structure",
  "require": {
    "php": ">=7.1",
    "composer/installers": "^1.8",
    "vlucas/phpdotenv": "^4.1.8",
    "oscarotero/env": "^2.1",
    "roots/wordpress": "5.5.1",
    "roots/wp-config": "1.0.0",
    "roots/wp-password-bcrypt": "1.0.0"
  }
}

Trellis's wordpress-sites.yml:

wordpress_sites:
  example.com:
    site_hosts:
      - canonical: example.com
        redirects:
          - www.example.com
    local_path: ../site
    admin_email: admin@example.com
    multisite:
      enabled: false
    ssl:
      enabled: false
    cache:
      enabled: false