middleman-php

middleman-php lets Middleman's server render PHP. So your source/kittens.php file will actually render kittens, and not a mess of <?php open tags.

Sometimes I have clients who want little bits of PHP interactivity on their site, but I still want to use Middleman to generate the PHP pages. This makes it so you don't have to middleman build and then upload to your site just to get a preview.

Installation

In your Middleman project's Gemfile, add:

gem "middleman-php"

and in your config.rb, add:

configure :development do
  activate :php
end

If you want the php to be parsed on builds, too (as opposed to raw PHP generated for a server to run), just omit the configure block:

activate :php

The PHP will only be rendered on pages where the URL ends in .php...so if you want to see index.php, you'll have to actually stick index.php in your browser. It will however, let you do fancy stuff like files ending in .php.erb...so your ERB can generate some php output.

Also thanks to Mariano, who contributed a significant chunk of code to get $_GET, $_POST, and other PHP global request variables working.

There are probably also bugs I haven't found, so if you find one, feel free to submit an issue!