Teddy Payet

Installer Homebrew sur Mac OSX

Teddy Payet — 2016-03-02T08:00:00Z

Il arrive souvent quand on développe qu'il nous soit nécessaire d'installer certains outils pour mieux travailler. Il existe plusieurs solutions pour y arriver :

faire le tout à la main en compilant les sources de l'outil (pas simple pour tout le monde, même pour moi) ;
utiliser MacPorts pour installer les outils (je vous partagerai bientôt un pas à pas pour son installation) ;
utiliser Homebrew pour installer les outils.

Présentation de Homebrew

Homebrew nous permet d'installer des outils qu'Apple n'a pas installé sur MacOS. Généralement ceux sont des utilitaires accessibles par lignes de commande. Donc si vous y êtes allergiques, passez votre chemin.
La communauté autour d'Homebrew est grande et réactive. Ce qui a l'avantage de nous donner accès à un panel très large d'outils. Ces outils sont souvent issus de la communauté Linux (Ubuntu, Debian et cie).
Pour simplifier l'idée, c'est un gestionnaire de packages (cf. nos outils).

Installation

Comme le dit la page d'accueil du site d'Homebrew le moyen le plus simple est de taper cette ligne dans votre Terminal :

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

Le script va nous expliquer les actions qu'il va réaliser avant de les lancer. Il nous suffira de valider son message pour que l'installation puisse se lancer. Cela fait, nous pouvons lancer la ligne de commande brew doctor pour savoir si tout est opérationnel pour Homebrew sur notre système d'exploitation. Suivre les indications de cet utilitaire le cas échéant.

Homebrew installe ses packages dans son répertoire (cf. "Cellar") et créera des alias dans le répertoire /usr/local/. C'est un avantage pour reconnaitre ce qui a été installé par Homebrew sans altérer notre OS.

Exemple d'utilisation : GruntJS

Lorsqu'on réalise des sites (ce n'est qu'un exemple), nous réalisons des actions répétitives. Mais voilà… le faire manuellement est chronophage. Pour éviter cela, il existe GruntJS (je vous invite à lire la documentation officielle). Pour installer GruntJS, on a besoin de Node.js et de npm. Et c'est là qu'intervient Homebrew.

Voici le code à exécuter pour installer Node.js et npm :

brew install node npm

Puis

npm install -g grunt-cli

Et voilà, le tour est joué.

Exemple d'installation : wget

Sous MacOS, on a accès à curl en lignes de commande mais pas à wget. Les 2 sont similaires ou du moins peuvent servir aux même tâches. Toutefois pour aspirer un site sur son ordinateur, il est plus aisé d'utiliser la commande wget. Il est très simple d'installer cette commande par l'intermédiaire de Homebrew :

brew install wget

Mettre à jour sa version d'Homebrew et ses packages

Comme indiqué dans la documentation officielle d'Homebrew, si on désire mettre à jour ce dernier, il suffit de saisir la ligne de commande suivante :

brew update

Oui, mais est-ce que nous avons des packages qui ont besoin d'une mise à jour ? Pour le vérifier, taper cette ligne de commande dans votre Terminal :

brew outdated

Homebrew nous indiquera donc la liste des mises à jour disponibles pour nos packages. S'il nous dit que tout est à jour, eh bien, tant mieux ! Sinon, il nous faut saisir cette ligne de commande :

brew update

Et tous nos packages se mettront à jour.

Conclusion

Ce gestionnaire de package n'est pas encore dans une version "1" à l'heure actuelle mais il est déjà suffisamment robuste pour nous permettre de travailler sereinement.
De plus, si nous avons besoin de connaitre la liste des packages disponibles sous Homebrew, il existe un site dédié : ~~http://brewformulas.org/~~ https://formulae.brew.sh
Un formulaire de recherche y est disponible, donc vous n'aurez pas d'excuses pour ne pas trouver le package qui vous va bien.

© Photo par Maciej Korsan
Le visuel de la bière a été choisi en rapport avec l'histoire d'Homebrew. En effet, en anglais, "brew" veut dire "breuvage". Et le créateur de ce projet avait choisi ce nom car il aimait beaucoup tout ce qui touchait à la bière, sans avoir considéré que son projet allait avoir tant d'influence. Quand il l'a réalisé, c'était déjà trop tard.
Référence

Créer un trunk sur la zone SPIP

Teddy Payet — 2015-07-30T07:00:00Z

Il arrive parfois que lorsqu'on a créé un plugin sur SPIP-Zone (ou qu'on veuille reprendre le développement d'un plugin sur SPIP-Zone) que ce plugin n'est pas sur la structure trunk/branches/tags. Pour reprendre ce plugin, il est conseillé de mettre le répertoire sous cette structure avant de commencer.

Un script pour les commander tous !

Au lieu de faire cela ligne par ligne, commande par commande, vous pouvez lancer un script à personnaliser selon le besoin. Les lignes de commande à taper ne sont pas forcément très nombreuses mais elles sont répétitives. Je vais de ce fait vous montrer un script bash qui simplifiera cette migration. Mais qui dit "bash", dit être donc sous un environnement UNIX : Linux, Mac OS.

Le script

#!/bin/bash
url_svn=svn://zone.spip.org/spip-zone/_plugins_/
plugin_nom=votreplugin
plugin_numero=0.9.0
svn mv ${url_svn}${plugin_nom} ${url_svn}${plugin_nom}_trunk -m "On commence la migration du plugin ${plugin_nom} en trunk/branches/tags"
svn mkdir ${url_svn}${plugin_nom} ${url_svn}${plugin_nom}/branches/ ${url_svn}${plugin_nom}/tags/ -m "On recrée le nom du répertoire ${plugin_nom} avec le répertoire branches/ et tags/"
svn cp ${url_svn}${plugin_nom}_trunk ${url_svn}${plugin_nom}/branches/v${plugin_numero:0:1} -m "On copie les fichiers du plugin ${plugin_nom} dans sa branche v${plugin_numero:0:1}"
svn cp ${url_svn}${plugin_nom}/branches/v${plugin_numero:0:1} ${url_svn}${plugin_nom}/tags/${plugin_numero} -m "On pose le tag correspondant à la version ${plugin_numero} du plugin ${plugin_nom}"
svn mv ${url_svn}${plugin_nom}_trunk ${url_svn}${plugin_nom}/trunk -m "On déplace enfin le répertoire initial vers le trunk pour le plugin ${plugin_nom} v${plugin_numero}"

Personnalisation

Il faut copier-coller ces lignes de commande dans un fichier qui aura pour extension .sh. Pour votre plugin, vous devez changer 2 valeurs :

plugin_nom : le nom du répertoire de votre plugin
plugin_numero : le numéro du plugin (sous la forme x.y.z) que vous trouverez dans le fichier plugin.xml ou paquet.xml

Vous n'avez pas besoin de changer l'URL du serveur svn de la zone sauf si le plugin que vous désirez reprendre le développement n'est pas dans le répertoire _plugins_.
Ce script va faire 5 commits au final avec les commentaires qui vont bien avec. Pour cela, ouvrez votre terminal et lancer le script que vous avez créé.

J'ai déjà éprouvé ce script à mon travail sur mes différents projets. Il est simple et efficace.

Explications

Même si le script est simple, on peut expliquer ce qui se passe et notamment l'écriture particulière de la syntaxe de bash.

Tout fichier bash commence par la ligne #!/bin/bash. Cela indique (en plus de l'extension .sh) que c'est bien un fichier… bash.
url_svn= : lorsque vous voyez un texte suivi d'un simple signe égal "=", c'est que vous créez une variable avec une valeur ;
Pour rappeler au besoin la variable, vous devez taper $ puis le nom de la variable désirée.
Pour pouvoir mettre du texte collé à votre variable, il faut mettre le nom de la variable entre accolades. Exemple : ${plugin_nom}_trunk donnera votreplugin_trunk
Si vous désirez avoir les premiers caractères de votre variable, dans le rappel de votre variable, vous pouvez utiliser la forme ${nom_variable:debut:longueur} où :
- nom_variable : le nom de votre variable ;
- debut : emplacement où commencer (0 étant le numéro du premier caractère) ;
- longueur : le nombre de caractères que vous désirez récupérer.

Plus de lecture

Le sujet du rangement sur la zone a été abordé à plusieurs reprises :

Image : © By Leroy

MAMP, PHP-cs-fixer, PHPDoc…

Teddy Payet — 2015-05-06T13:10:36Z

Pour faire suite au précédent article, je vais vous indiquer, très rapidement, l'installation de PHP-cs-fixer et de PHPDoc qui peuvent être à minima complémentaires voir très utiles dans nos développements.

PHP-CS-fixer

Source : https://github.com/FriendsOfPHP/PHP-CS-Fixer
L'outil "PHP Coding Standards Fixer" corrige la plupart des problèmes dans votre code lorsque vous souhaitez suivre les normes de codage PHP définies dans les documents PSR-1 et PSR-2.

Sous Mac, allez dans le Terminal et tapez la ligne suivante :

$ cd /Applications/MAMP/bin/php/php5.5.18/bin/

Puis, comme indiqué sur la page officielle, tapez le curl (le wget ne fonctionnera pas nativement sous MacOSX) :

$ curl http://get.sensiolabs.org/php-cs-fixer.phar -o php-cs-fixer

ET maintenant, on donne les bonnes autorisations d'exécution :

$ sudo chmod a+x php-cs-fixer

Grâce à ces lignes de commande, MAMP saura de quoi on parle quand un IDE en aura besoin… Mais pas encore MacOSX. Rien de plus simple, on fait comme d'habitude :

$ sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/php-cs-fixer /usr/bin/php-cs-fixer

On est ok normalement avec PHP-CS-Fixer

PHPDoc

Source : http://www.phpdoc.org/docs/latest/getting-started/installing.html
On ne le présente plus… PHPDocumentor devrait être connu de tous au moins de nom :-)
Pour l'installer en tant qu'extension de PHP, il faut passer par PEAR :

$ pear channel-discover pear.phpdoc.org Adding Channel "pear.phpdoc.org" succeeded
Discovery of channel "pear.phpdoc.org" succeeded

Maintenant, on peut installer phpDocumentor en utilisant la ligne de commande suivante :

$ pear install phpdoc/phpDocumentor downloading phpDocumentor-2.8.2.tgz ...
Starting to download phpDocumentor-2.8.2.tgz (16,246,834 bytes)
............................................................................................................................................................................................................................................................................done: 16,246,834 bytes
install ok: channel://pear.phpdoc.org/phpDocumentor-2.8.2

Et maintenant au tour de Mac OS X de comprendre ce qui se passe :

$ sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpdoc /usr/bin/phpdoc

Et voilà ! Vous voyez ? C'est rapide !

MAMP, PHP, Pear, PHP Code Sniffer sont dans un même bateau

Teddy Payet — 2015-01-27T17:06:32Z

Cela fait un moment que je n'avais pas écris de billet sur mon blog. Mais ça fait aussi longtemps que je me dis qu'il faut que j'écrive un tutoriel complet sur comment installer PHP Code Sniffer sur un MAMP.

En soit, vous pouvez retrouver toutes ces informations sur le net mais un peu éparpillées… Je dois "à chaque fois" jouer avec google pour retrouver ces différents articles.
De ce fait, je vais les regrouper sur une même page et, dans la mesure du possible, remettre les sources du code que je mettrai.

Besoins

En codant sous Mac OS X (Yosemite, là de suite), on utilise souvent MAMP pour développer nos différents sites en local. Et mine de rien, respecter les normes PHP, ça fait du bien. Et pour cela, on a besoin d'installer PHP Code Sniffer pour que nos IDEs puissent utiliser la norme PSR2 (dans mon cas).
Donc, ma configuration lors de ce pas à pas :

Mac OSX 10.10.1 (dit Yosemite) ;
MAMP 3.0.7.3 ;
PHP 5.5.18 (fournit dans MAMP, et PHP 5.5.14 dans Yosemite).

Configuration de l'installation

Pour que nos lignes de commandes php et pear soient reconnues, il faut dire au système où regarder.
Pour cela, je vous invite à ouvrir le Terminal car c'est quasiment que par lui que nous allons utiliser pour configurer notre Mac.

PHP

Source : http://stackoverflow.com/a/17240373
A partir de là, je vous invite à taper la commande suivante :

# which php

Ce qui devrait vous donner ceci :

/usr/bin/php

Vérifions la version :

# php -v

Cela devrait vous dire que vous avez une version PHP 5.5.14. Ce qui ne correspond pas à notre version fournit avec MAMP. Nous devons alors dire à notre Mac qu'on veut la version de MAMP.
Taper ceci pour faire une sauvegarde de notre version de php en renommant le fichier php en php.bak. :

# sudo mv /usr/bin/php /usr/bin/php.bak

Notre Mac ne reconnaitra plus temporairement les commandes PHP. On crée maintenant un lien symbolique de php vers notre version de MAMP :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/php /usr/bin/php

Regarder votre version de PHP maintenant :

# php -v

On est ok normalement avec PHP

PEAR

Cette fois-ci, on va régler PEAR qui va nous permettre d'installer PHP Code Sniffer sur notre installation MAMP. Pour faire simple, on reprend la même démarche que précédemment.

# which pear

Là, si vous n'avez jamais configuré votre Mac, rien ne s'affichera. Vous serez redirigé vers la ligne de saisie de commandes. La commande suivante normalement nous donne le numéro de version de PEAR (attention à la majuscule du "V").

# pear -V

Mais comme dit précédemment, la commande PEAR n'est pas reconnue. On va dire alors à notre Mac qu'il faut qu'il aille voir dans MAMP :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/pear /usr/bin/pear

Refaites la commande de version de PEAR. MAMP fournit la version 1.9.5 pour PEAR.
On est ok normalement avec PEAR

PHP Code Sniffer

Source : : https://github.com/Islandora/islandora/wiki/Installing-and-configuring-codesniffer
Pour installer PHP Code Sniffer, il faut passer par PEAR. Comme on l'a déjà installé, il nous suffit de renseigner la commande suivante :

# pear install PHP_CodeSniffer

Je n'ai pas rencontré de problème à ce stade. Si on va dans /Applications/MAMP/bin/php/php5.5.18/bin/ on peut voir un fichier phpcs. Mais dans /usr/bin/, on ne trouve pas de phpcs. Ce qui a pour effet, là de suite, que si on tape une commande phpcs, on aura une erreur. Pour régler ça, rien de miraculeux, une ligne de commande mettra notre Mac dans le droit chemin :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpcs /usr/bin/phpcs

On vérifie tout ça :

# phpcs --version

Soit pour moi : PHP_CodeSniffer version 2.2.0 (stable) by Squiz (http://www.squiz.net)

PHP Mess Detector

Source : http://pear.phpmd.org/
On installe souvent avec PHPcs la librairie PHP Mess Detector (PHPmd). Pour cela, il faut ajouter un channel spécifique à PEAR.

# pear channel-discover pear.phpmd.org

On regarde les packages disponibles :

# pear remote-list -c phpmd

Soit :

Channel phpmd Available packages:
=================================
Package Version
PHP_PMD 1.5.0

La ligne de commande suivante va poser problème :

# pear install phpmd/PHP_PMD
# Unknown remote channel: pear.pdepend.org
# phpmd/PHP_PMD requires package "channel://pear.pdepend.org/PHP_Depend" (version >= 1.1.1)
# No valid packages found
# install failed

Il faut rajouter le channel pear.pdepend.org :

# pear channel-discover pear.pdepend.org

Et maintenant, on fait ceci :

# pear install --alldeps phpmd/PHP_PMD

L'option --alldeps va installer toutes les dépendances nécessaires pour PHPmd avant d'installer PHPmd.
Ok, on crée les liens symboliques pour notre Mac :

# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/phpmd /usr/bin/phpmd
# sudo ln -s /Applications/MAMP/bin/php/php5.5.18/bin/pdepend /usr/bin/pdepend

Petit test :

# phpmd --version
# pdepend --version

Et voilà ! C'est fini ! Vous pouvez vous amuser maintenant !

Bonus : PHPUnit

Pour PHPcs, on n'a pas besoin de PHPUnit… Qu'on se le dise. Mais, je me dis que cela peut servir à certains. Alors voici la méthode.
Comme on peut le lire sur https://github.com/sebastianbergman..., on ne passe plus par PEAR pour installer PHPUnit mais par un fichier phar.
Sur la doc, on passe par des lignes de commandes aussi pour faire tout cela… Ok… Mais il y a un problème. Sur le Mac, la commande wget ne fonctionnera pas. On va passer par la commande curl pour récupérer le fichier.

D'abord, on va sur le bureau (par exemple)

# cd ~/Desktop/

Et là, on va pouvoir travailler ainsi :

# curl -o phpunit.phar https://phar.phpunit.de/phpunit.phar
# chmod +x phpunit.phar
# sudo mv phpunit.phar /usr/bin/phpunit

Ça vous dit de vérifier ? Simple, même astuce que tout à l'heure :

# phpunit --version
# PHPUnit 4.4.5 by Sebastian Bergmann.

Et voilà ! J'en ai fini avec ce pas à pas. ;-)