1915framework

Super minimal PHP framework combining ideas from Symfony 1 + WordPress

Setup

Load on your webserver and point your virtual host to the '/web' folder.
In 'lib/_vars.php' decide if you want to use a databse with $use_db.
- in 'lib/database.php' add your databse settings
The initial module is home with an action of index

$use_db = (false) if you want to use a database with your site. This will load in the mysql class
$index_fallback = (true) if you want the default index action to run if none are found (changable per module in modules.php)
$home_module = ('home')
$login_module = ('login') allows you to specify where to send people if they are not logged in and hit a secure module
$fof_text = (string) 404 Text if module or action is not found

The main website urls look like this: website.com/$module/$action/$id/$uri[4]/$uri[5]/etc...
$module will dive in the modules/$module folder and then look for an $action file with the naming convention a.$action.php
The view used will look for v.$action.php
I have shortened the variables from the original symfony structure because after you get confortable with the system, the filenames are less important. Lots of systems overcomplicate to help new users which just adds bloat IMO.

The main $template is naturally 'main'. You can specify different templates on a per module basis. Like:
$templates['home'] = "home";
$templates['login'] = "login";
Ajax calls automatically use the 'blank' template
The $secure_modules array contains all the modules that need to be secured.
The $index_fallbacks variable allows you to set fallback options on a per module basis
$index_fallbacks['home'] = false;

There is a global.php file that gets called before we dive into action files. This is the place to add custom needs with if or switch statements. You can create whatever kind of convention you need.

This base was designed with SCSS and CodeKit in mind. There is a scss folder in the root with an _hg.scss and main.scss.
In my sites I import the _hg into the main and send them to /web/css/main.css with a map. You can delete this folder and just use main.css or remove it all together. 1915framework doesn't care what you do. It just wants to help where it can.

I use the dBug class that is made based on the ColdFusion debugger. It's fantastic. You can call it like this dbug($obj) and it will display nicely what you have there.
As an added bonus in the dbug function it checks to make sure $is_local is true so that debugging outputs won't display on your live site.
$is_local is set in lib/application and is defaulted to any HTTP HOST with .dev

There is a variable $page that always gets handed to the actions and views that contains there current page number. It scans the url for page like: /videos/page/7 and returns nicely $page = 7 for you.
It doesn't have to be the third uri element it will grab whatever element comes after the /page/ element.

At the moment nothing is currently baked in. This framework is meant to give you the basics and then you can incorporate whatever else you need. Hopefully one day a plugin system could be attached and the admin could be added as a plugin.
Check out $secure_modules in lib/modules and the function is_user_logged_in() to work with securing specfic modules.

The mysql classes used is similar to many array of objects style mysql classes.
It requires manual queries like the good old days. Some examples:
$users = $db->get_results("SELECT * FROM users WHERE logged_in = 1");
$post = $db->get_row("SELECT * FROM posts WHERE id = $id");
$post_id = $db->query_to_id("INSERT INTO posts (title, content) VALUES ('This is a Test', 'Sure Is')");
$last_name = $db->get_var("SELECT last_name FROM users WHERE user_id = 234");