Installation de cakePHP

Publié par Othman ouahbi le: 03/01/2007 à 14:44

CakePHP est vraiment facile à installer, en fait j’ai même pas à écrire ce post, mais je vais quand même le faire ;)

Avant qu’on commence on va se mettre d’accord sur quelques points:

• La version de PHP minimum que cakePHP supporte est 4.3.2
• la version de mySQL minimum que cakePHP supporte est 4.0
• La version qu’on va installer est la dernière version stable à la date d‘écriture de ce post: 1.1.12.4205

• Il y a une version majeure en préparation 1.2. Pas encore stable, cette version change pas mal de choses. Une étape de migration est donc nécessaire. Mais ne vous inquiétez pas, on va consacrer des articles sur ça le moment venu.

Les Ingrédients (ou Pré-requis)

Vous devez avoir une plate forme LAMP de base qui fonctionne.
Vous pouvez ne pas avoir de base de données, pour des applications qui ne nécessitent pas de base de données tout simplement.

Serveur Web

Si vous avez un hébergement et vous voulez installer Cake dedans, cela ne vous concerne pas puisque vous avez déjà un serveur Web installé. En revanche si vous voulez développer en local, vous devez installer un serveur Web. Mais quel serveur Web choisir ? La question ne se pose pas: Apache . Mais j’ai Windows ? Apache. Ok bon si vous avez des contraintes et que vous devez utiliser IIS j’ai une bonne nouvelle pour vous, Cake marche sans problème sur ce serveur. Une autre alternative à apache est LightTPD

Notez que le but ici n’est pas d’apprendre à installer une plate forme LAMP tout(e) seul(e) comme un(e) grand(e), la sécurisé etc. En principe vous devez déjà avoir ça en place.
Cependant, Si vous êtes un débutant, et vous voulez avoir ça sous linux par exemple, je vous conseil la distribution Ubuntu qui est basée sur Debian très facile à utiliser et une bonne introduction au monde *nix.
Vous trouverez un tutoriel décrivant comment installer un serveur lamp sur ubuntu ici

Tout en un

Pour les utilisateurs de Windows, Il y a des solutions comme EasyPHP ou xampp qui sont des kits qui regroupent les outils nécessaires pour avoir un environnement LAMP prêt à l’emploi sans se casser la tête. Je préférerai xaamp parce qu’il offre la possibilité de changer entre PHP4 et PHP5 en un clic ce qui peut être extrêmement utile lorsqu’on teste des choses, surtout que cakePHP support les deux versions de PHP, 4 et 5.
Il y a une version de xampp pour linux et pour mac OS X aussi.

Mettre la main au Cake

Arrivant jusqu’ici, je considère que vous avez une plate forme LAMP qui marche. il reste à acquérir cakePHP.
Il y a différentes façons de l’avoir:

• Télécharger la dernière version stable
• Télécharger la version Nightly Build
• Récupérer la dernière version à jour du dépôt SVN)

La dernière version stable

Vous pouvez la récupérer d’ici http://cakeforge.org/projects/cakephp/
à l’heure d‘écriture de ce post, la dernière version stable est 1.1.12.4205.
Vous cliquez donc sur Téléchargement et vous prenez l’archive adéquate ( .zip pour Windows, .tar.bz2 ou .tar.gz pour les *nix)

Nightly Build

Il faut aller ici pour récupérer cette version. C’est en fait une version qui est extraite du dépôt de Cake toutes les nuits à 11h CST (faites le calcule pour GMT). Cette version inclue souvent des corrections de bugs entre deux versions stables.
Après vous Sélectionnez l’archive adéquat ( .zip pour Windows, .tar.bz2 ou .tar.gz pour les *nix)

SVN

Pour gérer le code, les développeurs de cakePHP utilisent un outil de gestion des sources et de contrôle de versions, qui s’appelle Subversion ou communément dit SVN.
Un dépôt Subversion est l’emplacement central où sont stockées toutes les données relatives aux projets gérés. Le dépôt est accédé via une URL locale ou distante.

L’avantage qu’offre SVN et que vous pouvez traquer les mises à jour de Cake sans aller Télécharger la dernière version à chaque fois et écraser les fichiers déjà existant etc.
SVN rend les choses plus organisées. Avec un seul clic (ou une seule commande) vous pouvez garder votre copie de travail locale à jour avec le dépôt de cakePHP.

Vous devez donc avoir un client SVN installé.
Pour les utilisateurs Windows, il existe TortoiseSVN un client SVN qui s’intègre à l’explorateur de fichiers pour permettre une utilisation visuelle des commandes.

L’adresse du dépôt SVN de cakePHP est: https://svn.cakephp.org/repo/trunk/cake/1.1.x.x/

l’installation

Peu importe la méthode que vous avez utilisé pour récupérer CakePHP. L’essentiel est que vous ayez soit l’archive décompressé soit si vous optez pour SVN, un répertoire avec un “checkout” du dépôt.
Il y a en fait deux façon d’installer cakePHP: Développement et Production.

Mais avant de voir chaque type, on va faire un tour rapide de l’architecture des dossiers de cakePHP. Un tour rapide parce qu’on va détailler ça dans un prochain post. Maintenant on va juste voir les répertoires qui vont être impliqué dans l’installation.

Quand on décompresse l’archive téléchargé, on trouve 3 dossiers principaux:

vendors/
app/
cake/

• vendors contient les scripts tiercent qu’on veut utiliser dans les applications. En effet, cake permet la gestion de plusieurs applications avec une seule instance du core. Donc les scripts qui vont être dans ce répertoire vont être partagés par l’ensemble des applications gérées par Cake.

• cake Ce répertoire est le véritable core de cakePHP. Il contient toute la bibliothèque de fichiers pour faire fonctionner les applications.

• app Est le répertoire de l’application, donc ici on trouve les contrôleurs, les vues, les modèles, les rares fichiers de configurations, etc. Tout ce qui est en relation avec l’application.

Sous app, y a deux dossiers qui nous intéresse pour l’instant: tmp et webroot .

• tmp Contiendra tout ce qui est temporaire, à savoir les logs, cache, session, etc. NOTE ce répertoire doit avoir les bonnes permissions pour que Cake puisse le manipuler ( chmod ).
• webroot est la racine de l’application, ce répertoire contient toutes les ressources visibles par le serveur Web, à savoir les images, fichiers css, javascript, etc. Il est inclut dans le répertoire app parce qu’il est en relation avec cette seule application. On pourra avoir plusieurs applications cake qui tournent sur le serveur Web et donc plusieurs webroots associés.

Développement

Y a vraiment rien à dire sur ce type d’installation, c’est très enfantin: Déposez le contenu de l’archive dans la racine de votre serveur Web, ou bien dans un sous répertoire cake par exemple.
Ouvrez votre navigateur sur http://localhost/ ou bien http://localhost/cake/
Si vous ne voyez rien, vérifier que votre serveur marche. Si la page apparaît, mais sans CSS, vous avez sûrement un problème de mod_rewrite. Si Vous Pouvez, installez/activez le (dépend de votre système). Si vous ne pouvez pas l’installer pour une raison quelconque, pas de panique, mod_rewrite est préférable mais pas obligatoire!
Cake Dispose d’un système de PrettyURLs qui permet d’avoir de jolies URLs. Jolies dans le sens où les URLs sont plus acceptables, par les humains et par les moteurs de recheche ( SEO). Seul bémole, vous aurez index.php dans l’URI.
Voilà ce que ça peut donner dans les trois cas:
mod_rewrite:
http://localhost/pages/home
PrettyURLs:
http://localhost/index.php/pages/home
Pas de mod_rewrite ni de PrettyURLs:
http://localhost/index.php?url=pages/home

Pour activer les PrettyURLs de Cake. Ouvrez le fichier core.php qui se trouve dans app/config/.
Trouvez la ligne:
// define('BASE_URL', env('SCRIPT_NAME'));
Et décommentez la (enlevez les // )
Sauvegarder le fichier.
Il n’est pas nécessaire d’enlever les fichiers .htaccess du répertoire de l’installation (Normalement y en a trois: dans le répertoire principale, dans app/ et dans app/webroot) sauf si on préfère utiliser les PrettyURLs de cake à mod_rewrite qui est activé.
Voilà ça doit marcher normalement.

Production

Ce mode offre plus de sécurité et d’organisation. Il est conseillé pour le déploiement final des applications. Ainsi que si vous développez plusieurs applications avec un même core de Cake, ce qui est possible.
On peut procéder de deux manières:

• Si on a le droit de changer DocumentRoot sur le serveur, on peut le pointer sur notre répertoire webroot. il deviendra alors le nouveau DocumentRoot. Les répertoires app et cake ne seront donc pas visibles par le serveur.

DocumentRoot /chemin/vers/app/webroot

• On peut avoir accès pour changer webroot mais on préférera l’approche suivante: Sortir le répertoire cake et app en dehors de la racine du serveur Web, de tel sorte à n’avoir dans la racine, ou un sous répertoire de celle-ci que le contenu de app/webroot.

Exemple d’une configuration

La racine de mon serveur Web est /home/oth/www.
Supposant que je veux installer une application bar. Dans un sous répertoire de mon serveur Web Je crée donc /home/oth/www/bar et je prends le contenu de mon webroot, je le mets dans ce répertoire.
Ensuite, je crée un répertoire foo dans /home/oth
Dans ce répertoire je mets le répertoire cake. Dans foo, je crée un autre répertoire apps (avec s ). Dans ce répertoire je mets mon répertoire app, cependant je le renomme, par exemple en app_bar.
J’aurais quelque chose qui ressemble à

/home/oth/
      foo/
          cake/
          apps/
             app_bar/
      www/
          bar/

Je dois maintenant renseigner dans mon index.php de bar (l’ancien webroot) qu’elle est mon application, et où il est le répertoire cake.
J’ouvre ce fichier donc pour le modifier.
On doit changer les valeurs des constantes ( defines) ROOT, _APP_DIR_ et _CAKE_CORE_INCLUDE_PATH_.
_ ROOT_ doit contenir le chemin absolu du répertoire qui contient le répertoire app (qu’on a renommé en app_bar).
Pour notre cas c’est:
define(‘ROOT’,’/home/oth/foo/apps’);
(N’ajoutez pas un ‘/’ à la fin)
_APP_DIR_ est le nom du répertoire app, on l’a changé donc:
define(‘APP_DIR’,‘app_bar’);
_CAKE_CORE_INCLUDE_PATH_ est le chemin absolu du répertoire qui contient le répertoire cake
dans notre cas:
define(‘CAKE_CORE_INCLUDE_PATH’,’/home/oth/foo’);

C’est tout !
Facile non?
Maintenant une devinette. Si on veut ajouter un autre site cat dans un sous répertoire de la racine du serveur Web, on fait comment ? Ai-je vraiment besoin de répondre ?
Bon, je donne un indice même si je sais que vous l’aviez sûrement deviné. Substituez bar par cat dans ce qui a précédé! Je ne dis pas plus!
Heh!

Conclusion

Ok, je sais, j’avais promis dans le post précédent que ça sera plus court, mais bon. Ça nous évitera de revenir sur des choses plus tard. Vaut mieux avoir des bases solides. Après on aura même pas besoin de la documentation, on se débrouillera tous seuls!
Voilà pour ce, post, billet, article, tutorial, ce que vous voulez! ça s’arrête là! N’oubliez pas, les commentaires sont fait, ben pour commenter! Donc n’hésitez pas si vous voulez plus de clarifications ou autre.

8h du matin! Oh ma! Hmm, je n’ai pas vu le temps passer.
Enfin, tant que c’est pour la bonne cause :)

Cake!

Auteur du commentaire		Mémoriser les informations données
E-mail
Site web
Message
	Aide Textile

Categories

• Général
• News
• Tutoriaux

Anglais

• CakePHP
  
• Ad7Six
  
• cakebaker
  
• gwoo
  
• nate
  
• othy
  
• rossoft
  
• the undefined
  

Rechercher

Partager