Introduction

La mise en route du caddy n'est très difficile en soi, cela ressemble beaucoup à l'installation de la plupart des cms.

Attention, ce projet est en cours de dévellopement le fichier d'initialisation de Caddy contient un backdoor permettant d'enregistrer un nouvel administrateur du caddy, il faudra bien suivre les indications de l'étape 5

Pré-requis

• Avoir un serveur apache avec php4 ou 5 en état de marche (ou équivalent)
• Une base de donnée MySQL (il est possible d'utiliser un autre type de base)
• Un peu de courage

Etape 1

Cakephp

• Récuperer le framework cakephp sur http://www.cakephp.org Caddy a été dévellopé avec la version 1.1.13.4450 et testé avec succès avec la version 1.1.14.4797
• Désarchiver cakephp dans un dossier au choix

/home/*user*/ 
/home/*user*/public_html/ 
/var/ 
/var/www

Pour faire les choses bien, le mieux est de ne pas laisser le dossier cakephp accéssible au publique mais de créer un sous-domaine par exemple qui pointe vers cakephp/caddy-x6tm/webroot ou cakephp/app/webroot. et ce sera d'autant plus facile pour gerer les images de l'interface.

Etape 2

Checkout Caddy-x6tm

Le principe est de se placer dans le repertoire de cakephp et de télecharger la version svn de Caddy :

$ cd cakephp
$ svn checkout http://caddy-x6tm.googlecode.com/svn/trunk/caddy-x6tm caddy-x6tm

Hop, un repertoire a été creer dans cakephp, il se nomme caddy-x6tm et celui-ci contient notre application.

• On a donc cakephp/caddy-x6tm/webroot <- c'est vers ce repertoire qu'il faut faire pointer notre sous-domaine. On pourra y acceder par http://caddy-x6tm/ par exemple
• Sans sous domaine le path des images dans le css seront erronnés néanmoins on peut acceder à l'appli avec http://localhost/cakephp/caddy-x6tm/webroot/
• Derniere possibilité, renommer caddy-x6tm par app (nom du repertoire par défaut de l'appli cakephp). Ansi : http://localhost/cakephp/

Etape 3

Base de donnée

• Recuperer le code SQL dans la page des Téléchargements
• Créer une base de donnée par exemple caddy-x6tm avec phpMyAdmin http://localhost/phpmyadmin ... par exemple
• Executer le code SQL dans la base de donnée
• Configurer Caddy pour qu'il fonctionne avec la base :

cakephp/caddy-x6tm/config/database.php.default à renommer pour database.php et parametrer la class :

// File : cakephp/app/config/database.php //

class DATABASE_CONFIG
{
	var $default = array('driver' => 'mysql',
				'connect' => 'mysql_connect',
				'host' => 'localhost',
				'login' => '',
				'password' => '',
				'database' => 'caddy-x6tm',
				'prefix' => '');
}

• Il est tout à fait possible d'utiliser un autre type de base de donnée (sqlite, postgreSQL ...) à voir dans les commentaires de ce même fichier.

Etape 4

Initialisation de Caddy

Caddy devrait déjà être opérationel, quelques pages notamment l'accueil devrait être visible (interface comprise : css, images). Néanmoins veillez à ne pas faire d'enregistrements sur la base.

Si ce n'est pas le cas,

• verifier la configuration du serveur web (si rien ne s'affiche, une erreur 404 ou autre)
• verifier les chemins des images dans le fichiers de css (cakephp/app/webroot/css/caddy-php.cake.css ou cakephp/caddy-x6tm/webroot/css/caddy-php.cake.css) si les images ne s'affichent pas (c'est ici que l'on retrouve l'interêt entre autre d'un sous-domaine qui pointe sur webroot).
• si beaucoup d'erreurs apparaissent en début de page (du type "Session.start"), il sera nécessaire de changer les droits sur le dossier tmp :

chmod -R 777 cakephp/app/tmp

Caddy assure la sécurité des ressources (enregistrements) grâce aux Access Control List (Liste de controle d'accès, utilisé par differents système comme windows ou linux) qu'il faudra initialiser. Ceci se fait aisement en visitant la page http://localhost/cakephp/index.php/configs ou http://caddy-x6tm/index.php/configs selon la configuration du serveur.

Lors de l'initialisation il sera aussi demandé de créer un administrateur. Cette partie est une faille de sécurité pour la suite si le code associé reste présent dans les fichiers de Caddy : à voir dans l'étape ci-dessous.

Etape 5

Faille de sécurité notoire

Le code permettant l'installation de Caddy peut être utilisé pour creer de nouveaux administrateurs, une fois l'étape 4 terminée, la solution la plus sûr est de supprimer la portion de code associé. Rendez-vous dans le fichier cakephp/app/controllers/configs_controller.php ou cakephp/caddy-x6tm/controllers/configs_controller.php

//File : cakephp/app/controllers/configs_controller.php //

/*Il y a 3 functions à supprimer :
- function index()
- function install_acl()
- function install_admin()
Ce sont les 3 premieres fonctions.
La fonction suivante permet de changer les droits sur les utilisateurs, cette fonction a été sécurisée.

Installation terminée

Caddy doit être maintenant pleinement utilisable.

La mise en production de l'appli sur un hebergement 1and1.fr s'est correctement déroulé, il a été nécessaire d'activer le "Pretty's Url" à la place du mod rewrite : app/config/core.php