Maya Php Framework 1.0

Design the database then generate most of the code.

by: Edgardo Fabian since: Oct. 2007

Home

Installation

note: This assumes that you have basic knowledge of installing web servers with php support such as apache,nginx,lighttpd etc. Therefore the installation assumes you have a mysql db and php support already installed.

Step 1. Design Database

Sample users table

fieldtypedescription
idunsigned intPrimary key
firstnamevarcharFirstname of the user
lastnamevarcharLastname of the user
roleint Integer values corresponding to certain user roles tied to their rights. A value 0 is always the default assigned rule typically for unauthenticated user. Higher values means higher rights. Details of rights are defined in app/model/Role.php.
createdtimestampDefaults to timestamp as db insertion

Sample subjects table linked to users

fieldtypedescription
idunsigned intPrimary key
namevarcharName of this subject
descriptionvarcharDescription of this subject
user_id_teacherunsigned intThis is a foreign key from the 'users' table, which will be named/labeled 'teacher' in tables and inputs
statusunsigned intactive=1 or not_active=0
createdtimestampDefaults to timestamp as db insertion

Sample enrolees table linked to users and subjects

fieldtypedescription
idunsigned intPrimary key
subject_idunsigned intThis is a foreign key pointing to the subjects table
users_ids_enrolleesunsigned intAn array of enrollee id pointing to the users table
createdtimestampDefaults to timestamp as db insertion

Rules in db creation.

1) All names of database table names must be in small letters and plural form. For example users, billboards, subjects etc. This is because the model created by the generateModel.php utility will be singular.

2) Foreign key relation shall be linked according to the name of the field for example 'user_id_teacher' means an id that points to the a user in the 'users' which is named as 'teacher'. Setting of foreign key relation in db is not required.

3) Foreign key relation n to n relation shall be linked according to the name of the field but plural form such as 'users_ids_enrollees'. This means any number of users id (array) that points to users in 'users' table that should be named 'enrollees' in tables and forms.

4) All tables should have an 'id' as a primary key which must be an unsigned integer.

5) All fields must be in small letters like id, name, description etc.

Step 2. Generate Model, View, Controllers

Generate Model

2) Got the ../util folder

3) run 'php generateModel.php (table name) [link_image]

For example 'php generateModel.php users link_image', if the users table exist, this command will generate three files namely ../usr_generated/model/UserProtected.php, ../usr_generated/model/UserPublic.php and ../usr/model/User.php . The ../user/model/User.php includes a User class that will extend the UserProtected class at ../usr_generated/model/UserProtected.php/. The UserProtected class will contain all the get and set methods to access the db fields.

Generate Controllers

2) Got the ../util folder

For example 'php generateController.php users link_image login_register', if the users table exist, this command will generate two files namely ../usr_generated/controller/MayaUsersController.php, and ../usr/controller/UsersController.php . The ../usr/controllers/UsersController.php includes a UsersController class that will extend the MayaUsersController class at ../usr_generated/controller/MayaUsersController.php/. The UsersController will no longer be generated if it already existed to prevent ovewriting user codes.

login_register is an optional parameter to include loginRestAction and registerRestAction which are only applicable for users table

Generate View

2) Got the ../util folder

For example 'php generateView.php users link_image login_register', if the users table exist, this command will generate three files namely ../usr/view/List Users.rest.php, ../usr/view/New User.rest.php and ../usr/view/Edit User.rest.php . Please note that this will overwrite whatever views previously modified. In case you overwrite by accident a backup is generated at ../usr/view_bak/.

login_register is an optional parameter to include login and register view support

Step 3. Modify generated code to fit your needs

Folder Structure

• index.php (edit) Main structure of each page
• config (edit) Contains configuration files
• paths.cfg.php
• database.cfg.php
• security.cfg.php
• app (edit) MVCs that extends the core maya MVCs
• model
• MayaModel.php
• Role.php
• view
• controller
• Maya.php
• usr (edit) MVCs that extends the core generated models from tables
• model
• view
• controller
• view_bak
• uploads (files uploaded by the MVC above will be placed here)
• Users.dir
• List Users.rest.php - Mostly a sym link to usr/view/List Users.rest.php
• Edit User.hid.rest.php - Mostly a sym link to usr/view/Edit Users.rest.php
• New User.rest.php - Mostly a sym link to usr/view/New User.rest.php
• [Other Tables]
• css (edit)
• js (edit) For jquery and javascript plugins
• lib (edit) For php plugins
• images (edit) Images needed by developer for website.
• img (edit) Images default to maya
• usr_generated (do not edit) Generated MVC from tables
• model
• controller
• model_bak
• controller_bak
• maya (do not edit) Core MVC of maya
• model
• view
• controller
• util (do not edit) Utilities for generating MVCs from tables

Rules which files should be edited

1) Files from index.php down to the images are the files that can be edited

2) Foldes from img,usr_generated,maya and util should not be edited

3) usr_generated are files automatically generated by the utilities which will be discussed later.

Modify Basic Structure of Page

1) The index.php determines the basic structure of the page. It follows the basic format below

 <?PHP require_once "config/paths.cfg.php";require_once "app/Maya.php";require_once "app/model/Role.php";require_once "usr/model/User.php";$maya = new Maya();$maya->controller->receive($maya->view);$maya->controller->prepareMenu();$maya->controller->processMenu();$maya->controller->database();$user= new User();$role= new Role();$paths = new Paths();?><!DOCTYPE html><html dir="ltr" lang="en-US"><head> <meta charset="utf-8"> <title>Maya PHP Framework</title> <meta name="description" content="Description"> <meta name="keywords" content="Keywords"> <?PHP$maya->view->linkCss();           $maya->view->initializejQuery(); ?></head><body> <div > <!-- topmost div to display messages and menu --> <?PHP //menu, login and message initialization code$maya->view->generateLoginForm("user_login","email","style=\"display:block\"","rgb(139, 118, 75)");         $maya->view->generateNoticeForm("rgb(139, 118, 75)");$maya->view->generatePageDeleteConfirmForm();        $maya->view->generateDeleteConfirmForm();$maya->view->generateImageUploadForm();        $maya->view->generateRegisterForm($maya->controller->getNest()->user,"User");        $maya->view->generateCommandView();$maya->view->generateSearchForm();        $maya->view->generateSiteMap();$maya->view->generateUserGreeting();    ?>    </div>    <div>        <!-- could be banner code here -->    </div>    <div class="page">       <!-- this is key marker because all other pages are loaded inside this "div.page" -->            <p style="font-weight:bold" >        <?PHP             $maya->view->generateTitle(); ?> </p> <?PHP$maya->view->generatePage();         ?>    </div>    <footer>        <!-- footer code here --!>    </footer>    <?PHP     $maya->view->initializeChosen();$maya->view->initializeWysiwyg();    $maya->view->initializeDatetimePicker();$maya->view->setHideRemovableToFitWindow();    \$maya->view->floatTableHeaderOnScroll();    ?>    <?php    require_once "DisplayController.php";     ?></body></html> 

2) All php codes marked by  <?php ....?>  are required

3) There should always be a  <div class='page'> </div>  because this is where other pages are loaded via restful process.

Modify Models

1) You should only modify the extended versions of models at usr/model folder. This is to insure that when you change your db and update your models the changes you added will not be overwritten by generaModel.php. The generateModel.php will only overwrite the models at usr_generate/model folders

2) You may override functions from the usr_generated/model folder

3) You should add user functions only to the models at usr/model folder.

Modify Controllers

1) You should only modify the extended versions of controllers at usr/controller folder. This is to insure that when you change your db and update your controllers the changes you added will not be overwritten by generaController.php. The generateController.php will only overwrite the controllers at usr_generate/model folders

2) You may override functions from the usr_generated/controller folder

3) You should add user controller functions only to the controllers at usr/controller folder.

Modify Views

1) Views (List, Edit, New) are automatically generated at usr/view folder by generateView.php.

2) If you want to put a page that is exactly the same as the 'List Users.rest.php' in the Admin.dir/Users.dir/ directory then it is recommended to generate a relative symbolic link.

ln -s '../../usr/view/List Users.rest.php' 'List Users.rest.php'

The above is terminal command in linux that assumes the folder structure defined above executed at ../Admin.dir/Users.dir/ directory

3) If you want to put a page that is similar to for example 'New User.rest.php' that is for example named 'Register User.rest.php', then you must copy ../usr/view/New User.rest.php and modify the contents to fit your desired page.