Skip to content
Pascal web application framework
Pascal PHP Other
Branch: master
Clone or download
Pull request Compare This branch is even with zamronypj:master.
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.
src add missing method declaration Aug 14, 2019
tests implement shell script to clean compiled unit binaries Jul 26, 2019
.gitignore fix ignore entries Jul 26, 2019
LICENSE refactor includes by its category for easier include management Nov 7, 2018
NOTICE.txt code formatting in redis library Feb 7, 2019
README.md edit readme Jul 29, 2019
fano.cfg

README.md

Fano Framework

Web application framework for modern Pascal programming language. Learn more.

Requirement

Installation

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

Install from Fano Command Line tool

Fano Cli is command line tool intended to simplify scaffolding web application, creating controllers, views, models, etc. It is recommended way to setup web application skeleton with Fano Framework.

$ fanocli --create-project=my-cool-app
$ cd my-cool-app
$ fanocli --create-mvc=Hello
$ ./build.sh

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.
  • Fano Upload, sample web application that allow user to upload file to server.

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 (in progress)
  • Redis database support (in progress)
  • Elasticsearch database support
  • Improve data validation and sanitation
  • Unit test

Copyright Notice

See NOTICE.txt

You can’t perform that action at this time.