Lemon Documentation

---

Get Started

Lemon is Micro Framework which means that you can build full website app in one file, which is great for beginners. More about Lemon
Version: 1.3.4
Changelog

Installation

Installation is provided by composer composer create-project lemon_framework/lemon:dev-master project-name
Lemon won't build your project, only download framework. You need to make file index.php that will be main file of your project and then run using php -S localhost:port

/project_folder
    /lemon
    /composer.json
    /index.php #here starts your app
        

Quickstart

This is minimal app built using Lemon:

require "lemon/framework.php";

Route::get("/relative/(.+)/", function($var)
    {
        echo $var;
    });

Route::any("/", function()
    {
        echo "hi";
    });

Route::handler(404, function()
    {
        echo "404";
    });

Route::execute();
        

Framework reference

Lemon from version 1.0.0 provides basic actions like routing or template system.

Routing

Routing in Lemon is based on class Route and its inspired by Laravel's routing. This class has 3 main static methods to create routes.
The methods are:

• ::get - creates route that allows only method GET
• ::post - creates route that allows only method POST
• ::any - creates route that allows only methods GET and POST

All those methods has 2 arguments Path and Action

• Path is way to get to the route.
• Action is function that is called when user visits the page.

Dynamic routes

Lemon provides you to make dynamic routes, to make dynamic part, just put (.*) and in your route output function argument.

Route::get('/dynamic/(.+)', function ($arg)
    {
        echo $arg;
    });
            

Example

require "leomon/framework.php";

Route::get('/get', function()
    {
        echo 'You can only get here!';
    });


Route::post('/post', function()
    {
        echo 'You can only post here!';
    });


Route::any('/any', function()
    {
        echo 'You can get and post here!';
    });

Route::execute();
            

Template system

Template system is way to run html from external file with Cross Site Scripting prevention. Since version 1.2.0 Lemon has custom template syntax inspired byJinjaa. To start with templates, just make folder views in your project folder and every new template add into this folder as template_name.lemon.php.
Your folder should look like this:

/project_folder
    /lemon
    /composer.json
    /views #Here are all the templates
        /home.lemon.php #Example template
    /index.php #main php file with all the routes
                

To view template just use function view(filename, params) In this function don't use the .lemon.php
To add variables to template add as second parameter one of those:

• compact("var", "var2",...)
• ["var_name" => "var_value"]

Template syntax

{{ $var }} Shows variable defined in view function

Foreach
{% foreach($var as $var): %}
loops everything that is here
{% endfor; %}

If

{% if (condition) %}

{% else if (condition): %}

{% else: %}

{% endif; %}
            

//index.php

Route::get('/' function()
    {
        $stuff = ['php', 'vim', 'lemon'];
        view('awesome_view', compact("stuff"));
    });

//views/awesome_view.lemon.php

Cool stuff
{% foreach ($stuff as $item) %}
    {{ $item }}
{% endfor %}
            

Route::handler(400, function ()
    {
        echo "Bad request on page".$_SERVER["REQUEST_URI"];
    });
           

//index.php           
<?php
require "lemon/framework.php";

Session::start();
CSRF::setToken();

Route::any("/", function() {
        CSRF::check();
        view("template");
    });

Route::execute(); 
?>                             

//view/template.lemon.php


@csrf