Pascal web application framework
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
App
Config
Core
DI
Db/Rdbms
Dispatcher
Environment
Error
Helpers
Http
Includes
Libs
Middleware
Mvc
Router
Security
LICENSE
README.md
fano.cfg
fano.pas

README.md

Fano Framework

Web application framework for modern Pascal programming language.

Requirement

Installation

Fano is standalone library, and basically, is not very useful on its own. It depends on an application to bootstrap.

Install from sample application

You may clone Fano App repository as base application skeleton.

When you clone Fano App repository, it pulls this repository as its submodule automatically. After that, it is ready to be compiled and run.

Follow the instruction Fano App repository for installation.

Other available sample application:

  • Fano Api, base REST API web application skeleton.
  • Fano App Middleware, base REST API web application skeleton with middleware support.
  • Fano Image, sample web application that generate PNG image on the fly.
  • Fano Mvc, sample MVC web application that load data from model and display it in view.
  • Fano Db, sample MVC web application that load data from MySQL and display it in view.

Install from Fano Command Line tool

Fano Cli is command line tool intended for scaffolding web application using Fano, creating controllers, views, models, etc . It is inspired by Laravel Artisan tool.

$ fanocli --create-project=my-cool-app
$ cd my-cool-app
$ fanocli --create-controller=Hello
$ fanocli --create-model=Hello
$ fanocli --create-view=Hello
$ ./build.sh

While you can create project structure, initialize Fano repository, create controller, view and model, the tools is still in development.

Install from scratch with Git submodule

If you decide to start from scratch,

$ mkdir my-cool-app
$ cd my-cool-app
$ git init
$ git submodule add https://github.com/fanoframework/fano.git

This command will pull Fano Web Framework repository into fano directory inside your my-cool-app directory.

Install from scratch without Git submodule

Using git submodule requires you to have copy of Fano respository locked to specific commit in your application project directory structure. If you have multiple applications that uses Fano, each of them will have their own copy of Fano respository that may be locked to different commit version. Updating Fano repository in one application does not affect other applications. It is roughly similar to how Composer (PHP) or NPM (Node.js) works.

If you do not want this code duplication, you may clone Fano repository as usual in a directory, then, in your each application project configuration, you tell Free Pascal, directory where to search Fano units.

This approach, however, has disadvantage. When you update your Fano repository, all your applications that depends on Fano will be affected. If newer version of Fano repository introduces breaking changes, application that requires older version of Fano repository may fail.

Roadmap

  • Secure file upload support (in progress)
  • FastCGI protocol support (in progress)
  • Cookie and session support
  • Run application with built-in web server
  • Run application as Apache module
  • Improve route matching performance
  • MongoDb database support
  • Redis database support
  • Elasticsearch database support
  • Improve data validation and sanitation
  • Unit test