jevets/kirby-phpdotenv

PHPDotenv for Kirby CMS

kirby-phpdotenv

A simple wrapper around vlucas' PHP dotenv library for Kirby CMS., _(*1)

Why?

I've been using .env in my Kirby projects for a while, but I got tired of pasting in the env() function for every new site. So, I created this package instead., _(*2)

Quick Example

# .env
APP_DEBUG=true

```php, <sub>(*3)</sub>

site/config/config.php

c::set('debug', env('APP_DEBUG', false));, <sub>(*4)</sub>

```php
# elsewhere
c::get('debug'); // true

Install

Install via composer, <sub>(*5)</sub>

composer require jevets/kirby-phpdotenv 

Usage

1. Instantiate

In your site's index.php file (or in site.php file), load Composer's autoloader., <sub>(*6)</sub>

require_once 'path/to/vendor/autoload.php';

Then instantiate with:, <sub>(*7)</sub>

1. The path where dotenv can find your .env file
2. A file name other than .env

new Jevets\Kirby\Dotenv\Dotenv(__DIR__ . DS, '.env');

Note: Jevets\Kirby\Dotenv\Dotenv will instantiate and run [dotenv]->load() for you., <sub>(*8)</sub>

2. Create your .env file

KIRBY_LICENSE=1234-12345-123456

APP_MODE=production
APP_DEBUG=true

3. Use in config.php file(s)

c::set('license', env('KIRBY_LICENSE', 'put your license in .env'));
c::set('debug', env('APP_DEBUG', false));

c::get('license'); // "1234-12345-123456"
c::get('debug'); // true

This library loads a global helper function:, <sub>(*9)</sub>

function env($key, $default = '') {...}, <sub>(*10)</sub>

Note function env() declaration is wrapped in if (!function_exists('env')) so you can override it or use your own method., <sub>(*11)</sub>

Customized folder setup

In my Kirby projects, I usually keep this folder structure:, <sub>(*12)</sub>

project/
  .env
  .env.example
  .gitignore
  package.json
  composer.json
  site/
    accounts/
    blueprints/
    cache/
    config/
    snippets/
    templates/
  public/
    kirby/
      toolkit/
    panel/
    content/
    assets/
    thumbs/
    index.php
    site.php
  src/
  vendor/

And here's my typical site.php, <sub>(*13)</sub>

# Composer autoload
require __DIR__ . DS . '..' . DS . 'vendor' . DS . 'autoload.php';

# DotEnv
new Jevets\Kirby\Dotenv\Dotenv(__DIR__ . DS . '..');

# Setup Kirby
$kirby = kirby();
$kirby->roots()->site = __DIR__ . DS . '..' . DS . 'site';

ChangeLog

0.0.3

• Rename class alias in helpers.php from String to Str for PHP7 compatibility

0.0.2

• Initial release

Collaborating

Pull requests and suggestions are quite welcome!, <sub>(*14)</sub>

Credits

• All credit for dotenv goes to vlucas for his great work on PHP dotenv. I just wrapped it up in a package to speed up development of Kirby-based sites.
• I stole Taylor Otwell's env() function from Laravel 5.1, with a couple tweaks to get it working with Kirby.

Bugs/Issues

Please use the issue tracker on the GitHub repo., <sub>(*15)</sub>