Pour ce faire, nous allons prendre l'exemple d'une base contenant des étudiants (students) et des voitures (cars) appartenant chacune à un étudant. Le schéma ci-dessous présente de façon graphique les relations entre les entités. Dans cet article seules les relations has_one et belongs_to seront abordés (la première case de l'image) donc une relation un pour un (les autres seront traitées ultérieurement).

(more…)

• Tout d'abord, un article traitant de la gestion des relations avec la librairie ORM devrait sortir sous peu
• Je vais bientôt poster une librairie dédiée aux paiements Paypal. Elle permet d'ajouter sur vos sites ces petits boutons paypal que vous voyez partout permettant de payer un service ou un bien ou encore de faire un don. Ceux la:

  

  

  

• Pas réellement lié à Kohana, j'envisage d'écrire un petit quelque chose sur google apps ou comment mettre en place un serveur mail google pour votre domaine!
• Si je vois des bouts de code ou des librairies sympa pour Kohana, je les ajouterai sur ce site

Sinon toi, Visiteur, que souhaiterais tu voir être abordé concernant Kohana ?

• Deploying Kohana to Production

qui est malheureusement en anglais mais très simple à comprendre. Si vous souhaitez une traduction en français, ajouter un petit commentaire sur ce post et j'essaierai de trouver le temps de le traduire) que vous pouvez trouver dans le guide utilisateur de Kohana .

En gros il faut purger les vues, contrôleurs et modèles de ceux que vous n'utilisez pas et de ceux qui y sont de base à titre d'exemple. Il faut aussi changer certains paramètres liés au domaine sur lequel votre application va être hébergée. Enfin il y a quelque petites variables à personnaliser pour améliorer les performances et la sécurité par rapport à un environnement de développement.

De plus la fin de l'article détaille comment il est possible de sécuriser un peu plus votre application en changeant l'arborescence de Kohana et/ou en utilisant un .htaccess pour restreindre ou permettre certains accès.

Quelque notes personnelles:

• Je trouve ça pas mal de mettre le répertoire system un niveau au-dessus du index.php: il suffit de changer $kohana_system = 'system'; dans index.php en $kohana_system = '../system';. Déjà ca peut permettre de restreindre les accès directs à system comme évoqué plus haut mais surtout ça permettra à toutes vos applications de fonctionner sur le même system, donc une seule mise à jour de ce répertoire sera nécessaire pour être à jour.
• Grâce à la fonctionnalité de chargement des ressources en cascade de Kohana, lorsque vous avez un fichier que vous avez modifié dans system/config/xxx.php alors mettez le dans application/config. En effet le chargement s'effectue dans cet ordre: application > modules > system. Cela permettra lors d'une MAJ de system de ne pas affecter vos configurations d'application

Le site de Kohana ne propose pas encore un moyen de partager ces ressources directement sur leur site (comme un wiki ou autre) mais ça devrait arriver tôt ou tard. Je ferai en sorte de mettre à jour cet article avec les nouveautés le plus souvent possible en attendant la création d'un dépôt officiel pour les modules.

Module Auth

Description: Permet de mettre en place des mécanismes d'authentification. Il supporte la gestion de rôles et l'auto-login (via cookies). C'est un module officiel donc maintenu par les développeurs de Kohana. Il utilise l'ORM.
Doc: http://doc.kohanaphp.com/addons/auth
Téléchargement: via le téléchargement du site ou le repository SVN

Module Forge

Description: Permet de créer et de gérer des formulaires. Il fournit des méthodes pour afficher, valider et filtrer les formulaires. C'est un module officiel donc maintenu par les développeurs de Kohana.
Doc: http://doc.kohanaphp.com/addons/forge
Téléchargement: via le téléchargement du site ou le repository SVN

Module Media

Description: module permettant de réduire la consommation de bande passante pour vos feuilles de style CSS et codes Javascript. Il intercepte les requêtes /media/css/xxxx.css et /media/js/xxxx.js et est capable de les mettre en cache, les compresser, etc… C'est un module officiel donc maintenu par les développeurs de Kohana (gregmac).
Doc: http://doc.kohanaphp.com/addons/media
Téléchargement: via le téléchargement du site ou le repository SVN

Add-on Template Controller

Description: Permet de gérer en un seul endroit le template de votre site. J'en ai parlé dans l'article Kohana: utilisation du contrôleur Template. C'est un module officiel donc maintenu par les développeurs de Kohana.
Doc: http://doc.kohanaphp.com/addons/template
Téléchargement: ici

Module GRID

Description: Ce module permet de créer des tableaux plus facilement
Doc: http://forum.kohanaphp.com/comments.php?DiscussionID=121
Téléchargement: ici

Module Scaffolding

Description: Ce module permet de génèrer le code source de création, lecture, mise-à-jour et effacement (CRUD) des données d'une base.
Doc: http://mhordecki.wordpress.com/2008/02/07/scaffolding-module-for-kohana-php/
Téléchargement: ici

Librairie Formation

Description: Classe permettant de faire de la validation et de la génération de formulaire. Peut même être utilisée avec un objet ORM pour directement créer le formulaire par rapport aux champs de la base de données.
Doc: http://learn.kohanaphp.com/category/formation
Téléchargement: ici

Module Zend_ACL

Description: Ce module est un portage vers Kohana de la libraire ACL du framework Zend permettant de mettre en place des listes de contrôle d'accès.
Doc: http://framework.zend.com/manual/en/zend.acl.html
Téléchargement: ici

• Validation de certains attributs d'une image uploadé
• Traitement sur l'image (réduction)

<?php
 
// On mets ici les règles de validation sur l'image
// Le tableau $_FILES doit être valide, l'image doit être de type gif, jpg ou png et ne doit pas dépasser 1 Mo
$_FILES = Validation::factory($_FILES)
    ->add_rules('picture', 'upload::valid', 'upload::type[gif,jpg,png]', 'upload::size[1M]');
 
// Si les règles sont validées
if ($_FILES->validate())
{
 
    // Déplace le fichier dans le répertoire Config::item('upload.directory', TRUE);
    $filename = upload::save('picture');
 
    // Réduit l'image et la sauve
    Image::factory($filename)
        ->resize(100, 100, Image::WIDTH)
        ->save(DOCROOT.'media/pictures/'.basename($filename).'.jpg');
 
    // Supprime le fichier temporaire
    unlink($filename);
 
    // Redirige vers une autre page
    url::redirect('account/information');
}

Le code ainsi que ses mise à jour futures éventuelles peut être trouvé ici.

C'est là ou le module 'Template Controler' intervient, il permet de:

• gérer en un et un seul endroit le template de votre site tout en gardant la possibilité de faire des extensions dans des controleurs fils. Evite les redondances et améliore la clarté et la qualité du code.
• afficher la page automatiquement (auto-render)

(more…)

• Surcharge de la méthode __get() afin de faire des traitements sur les attributs d'un objet récupéré de la base
• Surcharge de la méthode __set() afin de faire des traitements sur les attributs d'un objet avant de l'insérer en base
• Présentation d'une fonction permettant de tester l'existence de l'élément dans la base
• Présentation d'une fonction permettant d'initialiser un objet ORM plus rapidement

(more…)

1. Créer votre propre vue dans application/views/kohana_error_page.php. Le chargement en cascade des fichiers va faire que c'est la vue dans application qui sera prise en compte.
2. ou bien on peut aussi créer un hook pour cette tâche pour associer l'évènement system.404 à la redirection vers votre propre page 404 et en voici le code:

1
2
3
4
5
6
7
8
9
10
11

<?php defined('SYSPATH') or die('No direct script access.');
 
// This hook makes 404 errors redirect to a custom page
 
Event::clear('system.404', array('Kohana', 'show_404'));
Event::add('system.404', 'my_404');
 
function my_404()
{
    url::redirect('error/404');
}

• Pré remplissage des champs avec des valeurs
• Validation des données
• Ré-affichage du formulaire avec les données entrées si la validation échoue
• Insertion en base en ORM si la validation est un succès

(more…)

Kohana, à l'instar de Code Igniter, propose un certain nombre de "helper". Les helpers sont en fait des classes php contenant un certain nombre de fonctions statiques qui vont vous faciliter la vie.

Kohana propose par défaut les helpers suivants: Array, Cookie, Date, Download, Email, Expires, Feed, Form, HTML, Inflector, Num, Security, Text, URL, Valid. Pour plus d'informations sur leurs fonctionnalités rendez vous sur la documentation. Par exemple, l'helper "array" propose des fonctions pour manipuler les tableaux. Les fonctions sont indépendantes et de ce fait ne dépendent de rien.

Ce tutorial va montrer comment créer un helper. Comme vous allez pouvoir le constater c'est très simple. Ce tutorial ce base sur l'implémentation d'un helper permettant de savoir d'où provient une requête web. Il sera nommé request. On souhaite créer une méthode request::is_ajax() permettant de déterminer si la requête courante est une requête ajax.

(more…)