Local WordPress Dev Environment

My local WordPress development environment.

Requirements

Git
Composer

Installation

Run this command in the terminal:

composer --keep-vcs --repository-url=git@github.com:wpscholar/local.git create-project wpscholar/local

The installation process will check your environment for the required PHP version and PHP extensions. If this presents a problem and you want to force install anyway, just add the --ignore-platform-reqs flag to the command.

Usage

With Lando

Install Lando
Run git clone git@github.com:wpscholar/local.git to pull down the code.
Run cd local to change into the project root directory.
Run lando start to initialize and start the containers.
Copy the .env.example file as .env.
Run composer install to install required dependencies.
Run lando composer run set-salts to generate salts.
Import a copy of the production database using the lando db-import <file> command where <file> is the name of the SQL file you've placed in the current directory.
Visit local.lndo.site
Trust the CA (Optional)

With Laravel Valet

Install Homebrew
Install Laravel Valet
Install MySQL using Homebrew: brew install mysql
Start MySQL using Homebrew: brew services start mysql
Set password to be root for the root user: $(brew --prefix mysql)/bin/mysqladmin -u root password root
Run composer --keep-vcs --repository-url=git@github.com:wpscholar/local.git create-project wpscholar/local
Run valet link local (unless you've already run valet park and are in your Valet root directory)
Run valet secure local
Run cd local
Copy the .env.example file as .env.
Run composer run wp db create - You may need to rename the database in your .env file first if you don't want your database to be named local.
Visit https://local.test (unless you set a different top level domain) in the browser to finish the WordPress installation.

With Local

Install Local
Create a new WordPress site using the UI
Navigate to the site's app directory in the terminal.
Run rm -rf public to delete the public directory.
Run composer --keep-vcs --repository-url=git@github.com:wpscholar/local.git create-project wpscholar/local public
Click the link in Local to visit the site in the browser.

Configuration

Open up the .env file to edit database credentials or other WordPress constants.

wpscholar / local