Installation avancée¶

Installer CakePHP avec l’installeur PEAR¶

CakePHP publie un package PEAR que vous pouvez installer en utilisant l’installateur PEAR. L’installation avec l’installateur PEAR peut simplifier le partage des librairies de CakePHP dans plusieurs applications. Pour installer CakePHP avec PEAR, vous devrez faire comme suit:

pear channel-discover pear.cakephp.org
pear install cakephp/CakePHP

Après avoir installé CakePHP avec PEAR, si PEAR est configuré correctement, vous devriez pouvoir utiliser la commande cake pour créer une nouvelle application. Puisque CakePHP sera localisé dans l”include_path de PHP, vous n’aurez pas besoin de faire d’autres changements.

Installer CakePHP avec Composer¶

Avant de commencer, vous devez vous assurer que vous avez une version de PHP mise à jour:

php -v

Vous devez avoir au moins PHP 5.3.0 (CLI) ou supérieur. La version de PHP du serveur web doit être la version 5.3.0 ou supérieur, et doit être la même version que la version de PHP de votre ligne de commande (CLI).

{
    "name": "example-app",
    "require": {
        "cakephp/cakephp": "2.10.*"
    },
    "config": {
        "vendor-dir": "Vendor/"
    }
}

$ php composer.phar install

example-app/
    composer.phar
    composer.json
    Vendor/
        bin/
        autoload.php
        composer/
        cakephp/

$ Vendor/bin/cake bake project <path to project>

define(
    'CAKE_CORE_INCLUDE_PATH',
    APP . '/Vendor/cakephp/cakephp/lib'
);

// Charger l'autoload de Composer.
require APP . 'Vendor/autoload.php';

// Retire et réajoute l'autoloader de CakePHP puisque Composer pense que
// c'est le plus important.
// See http://goo.gl/kKVJO7
spl_autoload_unregister(array('App', 'load'));
spl_autoload_register(array('App', 'load'), true, true);

Partager les librairies de CakePHP pour plusieurs applications¶

Il peut y avoir des situations où vous voulez placer les répertoires de CakePHP à différents endroits du système de fichiers. Cela est peut être dû à des restrictions de l’hôte partagé, ou peut-être souhaitez-vous juste que quelques-unes de vos apps puissent partager les mêmes librairies de CakePHP. Cette section décrit comment déployer vos répertoires de CakePHP à travers le système de fichiers.

Premièrement, réalisez qu’il y a trois parties principales d’une application Cake:

1. Les librairies du coeur de CakePHP, dans /lib/Cake.

2. Le code de votre application, dans /app.

3. Le webroot de l’application, habituellement dans /app/webroot.

Chacun de ces répertoires peut être situé n’importe où dans votre système de fichier, avec l’exception de webroot, qui a besoin d’être acessible pour votre serveur web. Vous pouvez même déplacer le dossier webroot en-dehors du dossier app tant que vous dîtes à CakePHP où vous le mettez.

Pour configurer votre installation de CakePHP, vous aurez besoin de faire quelques changements aux fichiers suivants.

• /app/webroot/index.php

• /app/webroot/test.php (si vous utilisez la fonctionnalité de Testing.)

Il y a trois constantes que vous devrez modifier: ROOT, APP_DIR, et CAKE_CORE_INCLUDE_PATH.

• ROOT doit être définie vers le chemin du répertoire qui contient le dossier app.

• APP_DIR doit être définie comme le nom (de base) de votre dossier app.

• CAKE_CORE_INCLUDE_PATH doit être définie comme le chemin du dossier des librairies de CakePHP.

Testons cela avec un exemple pour que vous puissiez voir à quoi peut ressembler une installation avancée en pratique. Imaginez que je souhaite configurer CakePHP pour travailler comme ce qui suit:

• Les librairies du coeur de CakePHP seront placées dans /usr/lib/cake.

• Le répertoire webroot de l’application sera /var/www/monsite/.

• Le répertoire app de mon application sera /home/me/monapp.

Etant donné ce type de configuration, j’aurai besoin de modifier mon fichier webroot/index.php (qui finira dans /var/www/mysite/index.php, dans cet exemple) pour ressembler à ce qui suit:

// /app/webroot/index.php (partiel, commentaires retirés)

if (!defined('ROOT')) {
    define('ROOT', DS . 'home' . DS . 'me');
}

if (!defined('APP_DIR')) {
    define ('APP_DIR', 'myapp');
}

if (!defined('CAKE_CORE_INCLUDE_PATH')) {
    define('CAKE_CORE_INCLUDE_PATH', DS . 'usr' . DS . 'lib');
}

Il est recommandé d’utiliser la constante DS plutôt que des slashes pour délimiter des chemins de fichier. Cela empêche les erreurs de fichiers manquants que vous pourriez obtenir en résultats en utilisant le mauvais délimiteur, et cela rend votre code plus portable.

Apache et mod_rewrite (et .htaccess)¶

Cette section a été déplacée vers URL rewriting.