Mise à jour


1Présentation

Le code source de Temma évolue au fil du temps, et il est important de récupérer les dernières versions, que ce soit pour bénéficier des corrections de bug ou pour profiter des nouvelles fonctionnalités.

La méthode de mise à jour dépend de la manière dont vous avez installé Temma, soit en utilisant Composer, soit en utilisant le script d'installation ou l'installation à la main.


2Avec Composer

Comme pour toute mise à jour de dépendances gérées par Composer, il suffit de taper la commande suivante :

$ composer update

Le fichier composer.json contient la directive suivante :

"require": {
    "digicreon/temma-lib": "^2.X.0"
}

Avec X le numéro de version mineure en cours au moment où vous avez installé votre projet. Ainsi, vous récupérerez toutes les versions mineures de Temma version 2 (qui ne doivent pas apporter de modifications non rétrocompatibles).


3Sans Composer

La mise à jour se fait en ligne de commande, et utilise l'outil comma :

$ bin/comma '\Temma\Cli\Temma' update

La commande est à exécuter depuis la racine du projet.

Cette commande peut prendre plusieurs options, afin de choisir la version déployée et le comportement de mise à jour.


3.1version

L'option version peut prendre plusieurs valeurs possibles :

  • stable : (valeur par défaut) Met à jour avec les fichier de la dernière version publiée de Temma.
  • latest : Met à jour avec les dernières sources commitées de Temma. Cela permet de récupérer les toutes dernières évolutions, mais fait prendre un risque car ces fichiers n'ont pas forcément été testés en profondeur.
  • Un numéro de version de la forme X.Y.Z : Permet de spécifier la version précise à récupérer.

Exemples :

$ bin/comma '\Temma\Cli\Temma' update --version=stable
$ bin/comma '\Temma\Cli\Temma' update --version=latest
$ bin/comma '\Temma\Cli\Temma' update --version=2.10.0

3.2force

La mise à jour s'effectue de manière à respecter votre utilisation de Temma. Par défaut, certains fichiers ou répertoires ne sont pas mis à jour lorsqu'ils ne sont pas présent dans votre arborescence de fichiers.

Avec l'option force, il est possible de demander une mise à jour plus agressive, qui pourra aller jusqu'à effacer des fichiers pour les remplacer par les fichiers de Temma (dans la version demandée).

Trois exemples identiques :

$ bin/comma '\Temma\Cli\Temma' update --force
$ bin/comma '\Temma\Cli\Temma' update --force=true
$ bin/comma '\Temma\Cli\Temma' update --force=yes

3Numéro de version courante

Pour connaître le numéro de la version installée de Temma, il suffit d'exécuter la commande suivante :

$ bin/comma '\Temma\Cli\Temma' info

Vous obtiendrez la version de Temma, ainsi que la version de Smarty (si Smarty est installé) :

Temma version:  2.8.0
Smarty version: 5.4.1