Skip to content

Tomo20151120/codeigniter-ss-twig

 
 

Repository files navigation

CodeIgniter Simple and Secure Twig

Latest Stable Version Total Downloads Latest Unstable Version License

This package provides simple Twig integration for CodeIgniter 3.0.

Folder Structure

codeigniter/
└── application/
    └── libraries/
        └── Twig.php

Requirements

  • PHP 5.4.0 or later

Installation

With Composer

$ cd /path/to/codeigniter/
$ composer require kenjis/codeigniter-ss-twig

Install libraries/Twig.php to your CodeIgniter application folder:

$ php vendor/kenjis/codeigniter-ss-twig/install.php
  • Above command always overwrites exisiting files.
  • You must run it at CodeIgniter project root folder.

Without Composer

Download the latest Twig v1.x: https://github.com/twigphp/Twig/releases

Unzip and install to application/third_party folder.

Download the latest codeigniter-ss-twig: https://github.com/kenjis/codeigniter-ss-twig/releases

Unzip and copy codeigniter-ss-twig/libraries/Twig.php to application/libraries folder.

Remove comment marks below and fix the path for Autoloader.php:

--- a/libraries/Twig.php
+++ b/libraries/Twig.php
@@ -9,10 +9,8 @@
  */
 
 // If you don't use Composer, uncomment below
-/*
 require_once APPPATH . 'third_party/Twig-1.xx.x/lib/Twig/Autoloader.php';
 Twig_Autoloader::register();
-*/
 
 class Twig
 {

Usage

Loading Twig Library

$this->load->library('twig');

You can override the default configration:

$config = [
	'paths' => ['/path/to/twig/templates', VIEWPATH],
	'cache' => '/path/to/twig/cache',
];
$this->load->library('twig', $config);

Rendering Templates

Render Twig template and output to browser:

$this->twig->display('welcome', $data);

Above code renders views/welcome.twig.

Note: I've changed the method name from render() to display(). Now render() method returns string only.

Render Twig template:

$output = $this->twig->render('welcome', $data);

Above code renders views/welcome.twig.

Adding a Global Variable

$this->twig->addGlobal('sitename', 'My Awesome Site');

Getting Twig_Environment Instance

$twig = $this->twig->getTwig();

Supported CodeIgniter Helpers

  • base_url
  • site_url
  • form_open
  • form_close
  • form_error
  • set_value
  • form_hidden
  • anchor

Some helpers are added the functionality of auto-escaping for security.

Reference

How to Run Tests

$ cd codeigniter-ss-twig
$ composer install
$ phpunit

Other Twig Implementations for CodeIgniter 3.0

Related Projects for CodeIgniter 3.0

About

A Simple and Secure Twig integration for CodeIgniter 3.0

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 99.7%
  • HTML 0.3%