parser - GitLite

KO | EN

gitlite — search

#ai #typescript #go #machine-learning #linux #docker #macos #nodejs #awesome #cli #awesome-list #security #mcp #openai

parser

(★ 60)

Fuel PHP Framework - v1.x template parser package adapters

File Explorer

Download Latest Version (.zip)

- - dwoo.php
  - haml.php
  - hamltwig.php
  - handlebars.php
  - jade.php
  - lex.php
  - markdown.php
  - mustache.php
  - phptal.php
  - plates.php
  - smarty.php
  - twig.php
- view.php
- parser.php
.gitignore
bootstrap.php
composer.json
README.md

# Installation Guide

1. Get the code

git clone https://github.com/fuel/parser

Downloads the entire project code from GitHub to your computer.

cd parser

Moves into the project folder you just downloaded.

2. PHP (Composer)

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
PHP A PHP runtime is required.
Composer The package manager used to install PHP libraries.

composer install

Installs the PHP libraries listed in composer.json.

✅ Run it with a built-in server like php -S localhost:8000, then open http://localhost:8000 in your browser.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Parser package

## Installing

Simply add `parser` to your config.php `always_loaded.packages` config option.

## Included Parsers

* Markdown - A PHP version of Markdown by Michel Fortin.

## Usage

```php
// old usage still valid, will load app/views/example.php
View::forge('example');

// load a Mustache template, will load and parse app/views/example.mustache
View::forge('example.mustache');

// load a Twig template, will load and parse app/views/example.twig
View::forge('example.twig');

// load a Hybrid Haml / Twig template, ATTENTION: this one actually loads app/views/example.twig and {% haml %} code at the top of the view
View::forge('example.mthaml');

// load a Jade template, will load and parse app/views/example.jade
View::forge('example.jade');

// load a Plates template, will load and parse app/views/example.plates
View::forge('example.plates');

// load a Haml template, will load and parse app/views/example.haml
View::forge('example.haml');

// load a Smarty template, will load and parse app/views/example.smarty
View::forge('example.smarty');

// load a Lex template, will load and parse app/views/example.lex
View::forge('example.lex');

// load a Dwoo template, ATTENTION: this one actually loads app/views/example.tpl
View::forge('example.dwoo');

// load a Handlebars template, will load and parse app/views/example.handlebars
View::forge('example.handlebars');

// load a Plates template, ATTENTION: this one actually loads app/views/example.tpl
View::forge('example.plates');

```

## Installing parsers

To be able to use one of the supported parsers, you need to install them via composer.
Simply add the libraries to your project's `composer.json` then run `php composer.phar install`:

```json
{
    "require": {
        "dwoo/dwoo" : "*",
        "mustache/mustache" : "*",
        "smarty/smarty" : "*",
        "twig/twig" : "2.*",
        "mthaml/mthaml": "*",
        "pyrocms/lex": "*",
        "league/plates" : "3.*",
        "zordius/lightncandy" : "dev-master"
    }
}
```

Note that the  Markdown parser is installed by default, as it is also used by the FuelPHP core class `Markdown`.

Libraries that can not be installed through composer are expected to be installed in in `APPPATH/vendor/lib_name` (capitalize lib_name),
and you'll have to download them yourself. Don't change the casing or anything, keep it as much original as possible within the `vendor/lib_name`
dir to keep updating easy (also because some come with their own autoloader).

You can configure them to be loaded from other locations by copying the parser.php config file to your app and editing it.

## Config and runtime config

Currently the drivers still lack a lot of config options they should probably accept. They are currently all configured to work with one instance of their parser library, which is available to config:

```php
// Clear the cache for a specific Smarty template
$view = View::forge('example.smarty');
$view->parser()->clearCache('example.smarty');

// Example static usage
View_Smarty::parser()->clearCache('example.smarty');
```