fhc/framework

The framework dedicated to developers for who don't code

Installs: 0

Dependents: 0

Stars: 8

Watchers: 2

Forks: 3

Language: PHP

v1.5.1 2014-08-05 14:51 UTC

README

FHC(FLRngel Hates Coding) PHP Framework

The framework using MVC Model, rails folder structure(about 80%), and ultra easy to use.

Requirements

Apache2 (mod_rewrite)

PHP ( >= 5.3 )

Installation

git clone https://github.com/flrngel/FHC-Framework <project name>
cd <project name>
./install.sh

or use FHC-Gaia

gaia new <project name>

Understanding how it works

Architecture

  • /index.php : FHC-Framework begins with index.php on every page.
  • /lib/include/*.php : index.php load every php files in here.(core.php, functions, etc.)
  • /lib/classes/*.php : class files has to be in here.
  • /lib/modules/ : not accessable directory from web request. for crons, modules, plugin build, etc.
  • /app/controllers/*.php : controller files
  • /app/views/*.html : view file(default matches with same controller)
  • /app/assets/ : assets for website

MVC

  • Model(class in FHC)
  • Views(app/views/.html
  • Controllers(app/controllers/.html

workflow

  • User requests such pattern, GET /what/to/do
  • index.php parses request URI
  • executes controller file app/controllers/what/to/do.php
  • toss $res as global varable to view file
  • renders view file app/views/what/to/do.html and get contents toss as $contents variable
  • renders layout file app/views/layout/[default].html
  • response rendered page

Usage

.env file

This is inspired from dotfiles

FHC-Framework first loads $_SERVER['DOCUMENT_ROOT']/.env json file and decodes to $_ENV variable

as $_ENV is global(php default), you can use it everywhere under FHC-Framework

Routings

just create app/controllers/<dir>/<filename>.php and access as GET(POST) /<dir>/<filename>

$res variable

$res variable is defined as array, and is global variable between controllers, views, layout

Classes

you can use anywhere lib/classes/<NAMESPACE>/<CLASSNAME>.php as new <CLASSNAME> from controller files

Update

use FHC-Gaia

gaia update <project name>

Useful libraries

LICENSE

MIT