andykwesi / leaf

🍁 The easiest way to create clean, simple but powerful web apps and APIs quickly

Leaf 3

Leaf is a PHP framework that helps you create clean, simple but powerful web apps and APIs quickly and easily. Leaf introduces a cleaner and much simpler structure to the PHP language while maintaining it's flexibility. With a simple structure and a shallow learning curve, it's an excellent way to rapidly build powerful and high performant web apps and APIs.

Leaf 3 brings a much cleaner, faster and simpler workflow to your apps. Powered by an ecosystem of powerful modules with zero setup and it's ease of use, Leaf now allows you to tackle complexities no matter the scale.

📦 Installation

Install Leaf 3:

You can create a Leaf 3 app with the Leaf CLI

leaf create <project-name> --v3 --basic

<project-name> is your project name

You can also use Composer to install Leaf 3 in your project quickly.

composer require leafs/leaf

Install Leaf 2:

You can install Leaf 2 in your project with Leaf CLI or composer.

leaf create <project-name> --basic --v2

Or with composer

composer require leafs/leaf v2.6

🗂 Basic Usage

This is a simple demonstration of Leaf's simplicity. After installing Leaf, create an index.php file.

<?php

require __DIR__ . "/vendor/autoload.php";

app()->get("/", function () {
  response()->json([
    "message" => "Welcome!"
  ]);
});

app()->run();

If you use the Leaf CLI, this is already done for you 🚀.

You may quickly test this using the built-in PHP server:

php -S localhost:8000

Or with the Leaf CLI:

leaf serve

You can view the full documentation here

✈️ The Leaf Ecosystem (Libs & Frameworks)

Project	Status	Description
leaf		Create websites and APIs quickly
leafmvc		An MVC wrapper for leaf (for general development)
leafapi		An MVC wrapper for leaf geared towards API development
skeleton		Leaf boilerplate for rapid development
leaf-ui		A PHP library for building user interfaces
cli		CLI for creating & interacting with your leaf apps

🧩 The Leaf Ecosystem (Modules)

Project	Status	Description
alchemy		Simpler tests for your PHP apps
aloe		Smart console helper for leaf mvc, leaf api and skeleton
anchor		Basic security tools
auth		Simple but powerful authentication system for your apps
bareui		Dead simple templating engine with no compilation (blazing speed)
blade		Laravel blade templating port for leaf
cookie		Cookie management without the tears
cors		CORS operations made simple
csrf		Basic CSRF protection
date		PHP dates for humans
db		Leaf Db from v2 (actively maintained)
db-old		Leaf Db from v1 (still maintained)
exception		Leaf's exception wrapper (fork of whoops)
experiments		collection of experimental modules
fetch		HTTP requests made simple
form		Form processes and validation
fs		Awesome filesystem operations + file uploads
http		Http operations made simple (request, response, ...)
logger		leaf logger module
mail		Mailing made easy with leaf
mvc-core		Core MVC tools powering our MVC wrappers
password		Password encryption/validation/hashing in one box
redis		Redis module
router		Default router for leaf php
session		PHP sessions made simple
tilly		Simple utility 'toolkit' for PHP applications
veins		Leaf veins templating engine
viewi		Leaf integration with Viewi PHP

💬 Stay In Touch

• Twitter
• Join the forum
• Chat on discord

📓 Learning Leaf 3

• Leaf has a very easy to understand documentation which contains information on all operations in Leaf.
• You can also check out our youtube channel which has video tutorials on different topics
• You can also learn from codelabs and contribute as well.

😇 Contributing

We are glad to have you. All contributions are welcome! To get started, familiarize yourself with our contribution guide and you'll be ready to make your first pull request 🚀.

To report a security vulnerability, you can reach out to @mychidarko or @leafphp on twitter. We will coordinate the fix and eventually commit the solution in this project.

Code contributors

Michael Darko	Ademílson F. Tonato	Tobias Herber	Pjotr Savitski
Pablo Ferreiro	jess	Sergey Romanenko	Wahyu Kristianto
JeiHO

🤩 Sponsoring Leaf

Your cash contributions go a long way to help us make Leaf even better for you. You can sponsor Leaf and any of our packages on open collective or check the contribution page for a list of ways to contribute.

And to all our existing cash/code contributors, we love you all ❤️

Sponsors

Netlify	Casprine	Vano	Farhan Yahaya
Lucas Chaplain	Dawuda Iddris	Aaron Smith	Peter Bogner
King David Gyimah	Andy Kwesi Apenteng

🤯 Links/Projects

• Leaf Docs
• Leaf MVC
• Leaf API
• Leaf CLI
• Aloe CLI