Tutorial pour commencer


Prerequis

serveur apache2, php >= 5.2

Un ptit telechargement 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

Dezipper puis copier le repertoire dans le repertoire web de votre serveur apache
Selon votre installation (quelques exemples)
linux (/var/www ou /home/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'ou est situé le framework...

Vous y etes, 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 projet.
La librairie etant 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 a chaque projet
note: vous pouvez faire de meme avec plugin en changeant son chemin dans le fichier conf/site.ini.php

Parametrons 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 a 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 a 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 presentation des repertoires

conf/

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

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

module/

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

plugin/

Contient les classes metiers/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 etre 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
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 tres modulable, vous pouvez l'apprendre tres rapidement