Tutorial pour commencer

Pré-requis

serveur apache2, php >= 5.2

Un ptit téléchargement please

Rendez-vous sur le site, cliquez sur le lien de téléchargement "télécharger" .

Dézipper l'archive zip téléchargée

Dézipper puis copier le repertoire dans le repertoire web de votre serveur apache
Selon votre installation (quelques exemples)
linux (/var/www ou /usr/local/apache2/htdocs ou /home/apache/htdocs)
windows (c:/wamp/www/)
mac osx (/MAMP/www)

Rendez-vous sur l'interface

Ouvrez votre navigateur sur l'adresse web ou se situe le framework http://localhost/mkframework_v4_*_*
L'adresse dependant d'où est situé le framework...

Vous y êtes, place aux précisions

Vous venez d'installer le framework et plus exactement le builder du mkframework
A partir de la, vous pouvez générer un nouveau projet en un clic , celui-ci sera créé dans le repertoire data/genere/ du mkframework.
Pour information, le projet généré ne contient pas la librairie du mkframework, elle le lie, pour permettre de ne pas gaspiller de place en redondant la librairie sur chaque nouveau projet généré.
La librairie étant la seule partie transversale à vos applications, elle n'est pas incluse dans les nouveaux projets, mais c'est la seule.
Le répertoire plugin, lui est propre à chaque projet
note: vous pouvez faire de même avec le répertoire plugin en changeant son chemin dans le fichier conf/site.ini.php

Paramétrons le fichier conf/connexion.ini.php

En ouvrant le fichier conf/connexion.ini.php de votre projet (dans data/genere/)
On peut remarquer qu'il y a plusieurs type de configuration pré-remplies

CODE


 mysql.dsn="mysql:dbname=blog;host=localhost"
mysql.sgbd=pdo_mysql
mysql.hostname=localhost
mysql.database=blog
mysql.username=root
mysql.password=root
&nbp;

On voit assez simplement ce qu'il faut remplir et à quel endroit.

Vous pouvez remarquer un module article, mais ou est la base ?

Le module article du projet example est une base "xml" du mkframework, elle est située dans data/xml/base/article
Une base de donnée xml étant constitué d'un repertoire du nom de la table
Ainsi que de deux fichiers structure.xml, contenant les colonnes de la table ainsi qu'un fichier max.xml contenant l'id maximum.

Mais comment livrer l'application en production

Il y a deux fichiers à modifier pour permettre de changer l'adresse de la librairie.
1. index.php
l.119

CODE


 include('../../../lib/framework/class_root.php');
 

2. conf/site.ini.php

CODE


 [path]
lib=../../../lib/framework/
 


Petite présentation des répertoires

conf/

Contient les fichiers de configurations, comme vous pouvez le voir le framework ne manque pas de paramètres :)

data/

Contient toutes les ressources d'une applications (images,cache,xml...)

model/

Contient les classes de vos tables, un fichier par table, contenant deux classes model_matable et row_matable
Vous pouvez avoir plus de détail dans la page ORM

module/

Contient les modules du site.
Un module se construisant ainsi
un répertoire portant le nom du module, un fichier main.php, et un repertoire tpl contenant les fichiers vues.

plugin/

Contient les classes métiers/pratique du site qui peuvent être réutilisés dans d'autres projets.
note: on peut remarquer quelques classes comme plugin_auth, plugin_routing qui auraient pu être dans la librairie du framework
Mais en faisant ainsi on permet ainsi un fonctionnement plus souple en vous laissant la main pour modifier, personnaliser ceux-ci si besoin.
note2: vous pouvez parametrer ces classes dans le fichier conf/site.ini.php

site

Répertoire transversal au site.
Il contient les fichiers css, javascript ainsi que les layout

Conclusion

Comme vous avez pu le remarquer, ce framework est très modulable, vous pouvez apprendre à l'utiliser très rapidement