Jekyll PHP

Jekyll PHP adds better support for PHP in Jekyll. Jekyll, as a static site generator, does not directly support PHP so there are inconsistencies regarding which features work with PHP. Jekyll PHP attempts to add support for PHP to the missing features, and even more.

Jekyll PHP requires at least Jekyll 3.2 but has no other dependencies.

Add this line to your application's Gemfile:

gem 'jekyll-php'

NOTE: You may alternatively want to use a version constraint

And then run the command:

$ bundle install

Run the command:

$ gem install jekyll-php

Jekyll has the global config variable permalink which sets a permalink style for every page, post, and collection. PHP files will now adhere to the permalink style.

When using Composer, Jekyll PHP can help steamline the process when building the site. It will exclude the appropriate files and install Composer production-ready when building your site for production.

There are two ways to specify a production build. The first is using environments and setting JEKYLL_ENV=production. The second option is to add a environment variable to your global config file and set it to production.

Composer should already be installed in the root directory of your site, so it should contain composer.json, composer.lock, and vendor/. When the building environment is anything but production, it will simply use what is already installed into vendor/. When the building environment is production, it will use composer.json and composer.lock to install Composer for production, which basically means installing Composer with certain flags. Below lists all of the variables that may be changed in the global config file and their default values.

Jekyll PHP is licensed under Apache License 2.0. You may also refer to the included LICENSE.txt file.