jpcid / server-command

Start up a development server; zero config needed

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

wp server

This is a package that implements the wp server command for WP-CLI.

It uses the PHP built-in server to serve a given WordPress instance.

The main advantage is that you don't have to install and configure Nginx or Apache, which can be overkill if you just want to work on a theme or a plugin.

Requirements

  • PHP 5.4 or newer
  • WordPress 3.5 or newer

Installation

First, make sure you have the package index configured:

cd ~/.wp-cli/
php composer.phar config repositories.wp-cli composer http://wp-cli.org/package-index/

Then, just install the package:

php composer.phar require wp-cli/server-command=dev-master

Usage

Just run it:

$ wp server
PHP 5.5.1 Development Server started at Wed Aug 14 03:34:13 2013
Listening on http://localhost:8080
Document root is /Users/User/wp/core
Press Ctrl-C to quit.

How is this different from Whippet?

The main difference is that we don't modify the wp-config.php file, so you can run other WP-CLI commands while the server is running.

Can I add custom rewrite rules?

Yep; just write a WordPress plugin that checks PHP_SAPI == 'cli-server' and redirects as appropriate.

For example, here's a working plugin for the Roots theme: leoj3n/wp-server-roots-rewrites.

About

Start up a development server; zero config needed

License:MIT License