Gestionnaires de Dépendances

Pear

A ne plus utiliser. Il s'agissait d'un gestionnaire de dépendances pour PHP qui n'est plus utlisé.

Composer

Utilisé pour CakePHP 3.x

CakePHP 3 sort courant 2014 et utilise Composer pour l'installation de dépendances. Que ce soit pour créer un projet CakePHP, le mettre à jour, installer des plugins CakePHP ou des librairies externes, il va être obligatoire de regarder un peu le fonctionnement de Composer.

Installation de Composer sur MAC OS 10.9

$ curl -sS https://getcomposer.org/installer | php
$ mv composer.phar /usr/local/bin/composer

et ensuite on peut utiliser la commande composer partout (si usr/local/bin est dans le PATH)

Création d'un projet CakePHP

Elle se fait en une commande avec Composer en se plaçant avec cd dans le répertoire où l'on veut installer le nouveau projet

cd /path/to/project
composer create-project --prefer-dist cakephp/app nom-application

Fonctionnement de Composer

Le fonctionnement est simple : on ajoute un fichier composer.json à la racine de son projet et on rentre dedans les dépendances dont on a besoin. Ensuite on lance dans le terminal une commande :

composer install (pour la première execution)
composer update (celle qu'on utilisera le plus souvent pour mettre à jour les dépendances, plugins)

La différence entre les 2 commandes install et update est qu'avec install, les dépendances écrites dans le composer.lock vont être installés.

En gros, quand on est en local, en développement, on va mettre à jour les dépendances avec composer update. Avec cette commande, composer met à jour le fichier composer.lock qui contient une arborescence de toutes les dépendances à l'instant t.

On va faire tous nos tests pour vérifier que les dépendances mises à jour ne cassent pas notre code, en lançant nos tests (phpunit, ...).

Quand notre code nous semble satisfaisant, on ajoute le composer.lock dans git. Le dossier vendor qui contient toutes les dépendances ne doit pas être suivi par git, il faut bien penser à le mettre dans notre .gitignore. En effet, on ne va pas alourdir notre projet git avec nos dépendances. Le composer.lock contient tout ce qu'il faut pour recréer le fichier vendor quand on sera sur le serveur.

En effet quand on déploie, on va envoyer notre projet avec git push sur le serveur et relancer composer install sur le serveur (avec un hook de git par exemple). Ainsi cette commande va réinstaller les dépendances dans le dossier /vendor en se servant des données qui se trouvent dans composer.lock.

Il faut bien comprendre qu'il ne faut pas lancer composer update sur le serveur car à ce moment là, les dépendances vont être mises à jour, et des dépendances vont peut-être être incompatibles avec votre code. Aucun test n'aura effectué avec les dépendances mises à jour.

En conclusion :

composer update : quand on développe, en local, pour mettre à jour les dépendances
composer install : seule commande à utiliser sur un serveur quand on déploie notre application

Rappel de l'arborescence de CakePHP 3

src plugins logs tmp vendor webroot .htaccess composer.json index.php README.md

C'est dans le fichier composer.json que vous allez définir les plugins et dépendances dont votre projet CakePHP va avoir besoin.

Un exemple simple de ce fichier :

{
    "name": "votreNom/nomApp",
    "description": "mon application perso",
    "homepage": "<a href="http://www.monapp.com" rel="" target="">http://www.monapp.com</a>",
    "type": "project",
    "license": "MIT",
    "require": {
        "cakephp/cakephp": "3.0.*-dev",
        "FriendsOfCake/crud": "dev-cake3",
        "cakephp/debug_kit": "dev-master",
        "votreNom/pluginName": "dev-master",
        "php": "&gt;=5.4"
    },
    "repositories": [
        {
            "type": "vcs",
                "url": "git@bitbucket.org:votreNom/pluginName.git"
        },
    ],
    "autoload": {
        "psr-4": {
            "App\\": "App",
            "App\\Test\\": "Test",
            "": "./Plugin"
        }
    },
    "scripts": {
        "post-install-cmd": "App\\Console\\Installer::postInstall"
    }
}

Quelques explications :

Les premières lignes définissent votre projet
Dans require, vous mettez les dépendances, plugins, vendors dont vous avez besoin pour votre projet
Dans repositories, vous pouvez ajouter les adresses de package privés, qui ne sont pas repertoriés sur https://packagist.org/. CakePHP est disponible sur Packagist, ainsi que la plupart des Plugins donc cela ne sert que si on crée ses propres Plugins.
Dans autoload, on définit les conventions qu'utilise CakePHP 3, en l'occurence psr-4 : https://github.com/php-fig/fig-standards/blob/master/proposed/psr-4-autoloader/psr-4-autoloader.md
Dans scripts, on peut ajouter des scripts à exécuter avant, après avoir fait un update.

Problème des .git des plugins

En effet lorsque les dépendances sont installées dans le projet, le dossier caché .git du plugin est ajouté dans le dossier du plugin. Cela pose problème avec le versionning du projet dans sa globalité puisqu'il va considérer le plugin comme un submodule. Or on sait que les submodules sont une catastrophe à gérer.

Voir les solutions à ce problème : https://getcomposer.org/doc/faqs/should-i-commit-the-dependencies-in-my-vendor-directory.md

Exemple de composer.json pour un plugin CakePHP

{
    "name":"votreNom/nomPlugin",
    "version": "1.0.0",
    "description":"CakePHP Application Plugin super top qui fait ça et ça",
    "type":"cakephp-plugin",
    "keywords":[
        "cakephp",
        "mot clé1",
        "mot clé2"
    ],
    "homepage":"https://github.com/votreNom/nomPlugin",
    "license":"MIT",
    "authors":[
        {
            "name":"Votre Nom",
            "role":"Author",
            "homepage":"http://www.votrePageWeb.com/"
        },
        {
            "name":"Nom autre pers si nécessaire",
            "role":"Contributor",
            "homepage":"https://github.com/votreNom"
        }
    ],
    "require":{
    },
    "require-dev": {
        "cakephp/cakephp": "~3.0"
    },
    "suggest":{
    },
    "autoload": {
        "psr-4": {
            "Crud\\": "."
        }
    },
    "support": {
        "source":"https://github.com/votreNom/nomPlugin",
        "issues":"https://github.com/votreNom/nomPlugin/issues",
        "wiki":"http://www.wiki.com/",
        "irc":"irc://irc.freenode.org/votreIrc"
    },
    "extra": {
        "installer-name": "NomDuPlugin"
    }
}

Homebrew

Used to install and update tools on my MAC : http://brew.sh/

Install

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Usage

To check your installation : brew doctor

To update Packages : brew update

To upgrade brew : brew upgrade

To install a package : brew install package_name

Everything is install in the usr/local/Cellar directory, so it can be uninstalled easily : brew uninstall package_name

List all tap used : brew tap

# Pear

# Composer

# Installation de Composer sur MAC OS 10.9

# Création d'un projet CakePHP

# Fonctionnement de Composer

# Rappel de l'arborescence de CakePHP 3

# Quelques explications :

# Problème des .git des plugins

# Exemple de composer.json pour un plugin CakePHP

# Homebrew

# Install

# Usage