Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tag: v0.3.0
Fetching contributors…

Cannot retrieve contributors at this time

162 lines (100 sloc) 3.661 kb

grunt-php Build Status

Requires PHP 5.4.0+

Start a PHP-server

Pretty much a drop-in replacement for grunt-contrib-connect. Useful for eg. running tests on a PHP project. Uses the built-in server in PHP 5.4.0+.

Doesn't have a middleware option as grunt-contrib-connect does.

Getting Started

If you haven't used grunt before, be sure to check out the Getting Started guide, as it explains how to create a gruntfile as well as install and use grunt plugins. Once you're familiar with that process, install this plugin with this command:

npm install grunt-php --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:


Tip: the load-grunt-tasks module makes it easier to load multiple grunt tasks.


Example usage

Start a short-lived PHP-server

Useful for you need to fire up a PHP-server for running unit tests or something.

    php: {
        dist: {
            options: {
                port: 5000

grunt.registerTask('default', ['php']);

Run this with grunt php or grunt php:dist.

Start a persistent PHP-server and open in browser

    php: {
        test: {
            options: {
                keepalive: true,
                open: true

grunt.registerTask('test', ['php', 'mocha']);

Use it with grunt-contrib-watch

    php: {
        watch: {}

grunt.registerTask('phpwatch', ['php:watch', 'watch']);



Type: Integer
Default: 8000

The port on which you want to access the webserver. Task will fail if the port is already in use.


Type: String
Default: '' (usually same as localhost)

The hostname the webserver will use.

Use if you want it to be accessible from the outside.


Type: String
Default: '.'

From which folder the webserver will be served. Defaults to the directory of the Gruntfile.


Type: Boolean
Default: false

Keep the server alive indefinitely. Any task specified after this will not run.

This option can also be enabled ad-hoc by running the task like grunt php:targetname:keepalive


Type: Boolean
Default: false

Open the server in the browser when the task is triggered.


Type: String

Optionally specify the path to a router script that is run at the start of each HTTP request. If this script returns false, then the requested resource is returned as-is. Otherwise the script's output is returned to the browser.

Example router script:

// router.php
if (preg_match('/\.(?:png|jpg|jpeg|gif)$/', $_SERVER["REQUEST_URI"])) {
    return false;    // serve the requested resource as-is
} else {
    echo "<p>Thanks for using grunt-php :)</p>";


Type: String
Default: 'php'

Specify a custom path to the PHP binary. Useful if you have multiple versions of PHP installed.


MIT License • © Sindre Sorhus

Jump to Line
Something went wrong with that request. Please try again.