Installer PHPStorm & configurer Git [Wiki GInfo]

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Installer PHPStorm & configurer Git ====== 
Pour les différents projets de développement au GInfo on utilise PHPStorm qui est un logiciel présentant un bon nombre de fonctionnalités intéressantes (même si on en utilise même pas 10%) et pour lequel on a des licences étudiantes. 

===== Créer un compte JetBrains & Installer PHPStorm =====
Tout commence ici, avec votre mail Centrale : [[https://www.jetbrains.com/shop/eform/students]] 

Une fois l'inscription effectuée, téléchargez PHPStorm et installer le. (Il est disponible pour toutes les plateformes)

===== Configurer PHPStorm pour l'utilisation avec git =====
Git est l'outil que nous utilisons pour développer en équipe. Mais il nécessite un peu de configuration pour que l'intégration avec PHPStorm fonctionne parfaitement. 

==== Sous Windows ==== 

=== Sous Windows 10 ===

== Installer Git ==


Il faut commencer par installer [[https://git-scm.com/downloads|Git]] en laissant tout par défaut.

__ Installer OpenSSH __

OpenSSH est un outils sous Windows 10 permettant les connexions à distance en utilisant le protocole SSH.

Pour installer OpenSSH :

  - Ouvrez les **Paramètres** de votre ordinateur, séléctionnez **Applications > Applications et fonctionnalités**, puis **Fonctionnalités facultatives**
  - Parcourez la liste pour voir si OpenSSH est déjà installé. Si ce n’est pas le cas, sélectionnez **Ajouter une fonctionnalité** en haut de la page, puis recherchez **OpenSSH Client** et cliquez sur **Installer**.

Une fois l’installation terminée, revenez à **Applications > Applications et fonctionnalités** et **Fonctionnalités facultatives**. Vous devriez voir OpenSSH dans la liste.

__Générer une paire de clé__

Pour générer la paire de clé, ouvrez le PowerShell ou le cmd de votre ordinateur puis exécutez :

  ssh-keygen
 
On vous demandera ensuite où vous voulez sauvegarder votre paire de clés puis un mot de passe. Vous pouvez de ne pas mettre de mot de passe mais ce n'est pas recommandé.

Une fois vos clés générées, vous pourrez les retrouver à l'emplacement choisi.

Vous pouvez ouvrir le fichier avec l'extension .pub avec le bloc-notes.

<note warning>Le fichier en .pub est la clé publique. Celui sans extension est la clé privée. Les clés privées sont l'équivalent d'un mot de passe. Il ne faut JAMAIS la divulguer.</note>

=== Autre tuto - Ancienne version pour Windows ===

<note warning>Cette partie du tuto ne semble plus marcher. Vous pouvez tout de même l'essayer et contater le GInfo pour le corriger.</note>

== Installation des outils ==

Il faut commencer par installer plusieurs outils, __**dans l'ordre énoncé**__.
  * [[https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html|PuTTY]], prenez la suite complète (installeur windows) 
    * Dans le cas où vous voudriez les installer un par un, il faut **PuTTY**, **Pageant**, et **PuTTYgen**

<note important>Une fois PuTTY installé, il faut le lancer, et enregistrer au moins un serveur dedans. Il suffit de remplir les deux champs en rouge (avec la configuration de sas1 par exemple comme sur l'image) et de cliquer sur save
{{ :formations:puttyconf.png?direct&400 |}}</note>

  * [[https://gitforwindows.org/|Git For Windows]] tout laisser par défaut et vérfier qu'il utilise bien **(Tortoise)Plink** (Installation détaillée [[formations:configGit|ici]])

----
== Génération d'une paire de clés ==



Il faut maintenant ouvrir PuTTYgen et générer un jeu de clés. Pour ça il faut cliquer sur generate et bouger la souris sur la zone blanche jusqu'à que la barre soit à fond... (Oui c'est étrange)

{{ :formations:puttygen.png?direct&400 |}}

Une fois cela fait, il faut mettre une passphrase si vous le souhaitez (c'est un mot de passe de votre clé, dans le bloc rouge, mais ça veut dire qu'il faudra fournir le mot de passe à chaque utilisation de la clé.) et ensuite il faut faire **save private key**, à un endroit sûr.

Le texte dans **Public key for pasting into OpenSSH** (bloc orange) servira plus tard. Il s'agit de la clé publique. 

Une fois la clé sauvegardée, vous pourrez la rouvrir plus tard avec le bouton **Load** en dessous de **Generate**.
----
== Mise en place de la clé publique == 
Les projets & leurs versions sont stockés sur la [[https://forge.centrale-marseille.fr/|forge de l'école]]. C'est un outil qui fonctionne avec git, pour avoir une meilleure vision des différentes version & gérer les projets. 

Pour ajouter la clé privée, il faut se connecter sur la forge avec sa clé privée, aller dans **Mon compte** en haut à droite, aller dans **Mes clés publiques** et copier le texte du bloc orange précédent (la clé publique) dans le champ texte **clé publique**. 

----
== Ouverture de Pageant ==
La dernière étape pour avoir sa clé fonctionnelle est d'ouvrir Pageant, de l'ouvrir (il se met dans la barre des tâches à droite) et de faire **Add Key** en précisant où la clé privée a été sauvegardée. Si une passphrase a été mise, c'est à ce moment qu'il faudra la renseigner. 

<note important>Pageant devra être ouvert, et il faudra renseigner la clé, à chaque fois qu'on veut utiliser PHPStorm avec Git. </note>

==== Sous Mac & Linux ====
Ouvrez un terminal et tapez la commande suivante : 

  ssh-keygen
 
Les options par défaut sont très bien (sauf si vous voulez mettre une passphrase mettez là au moment voulu) et une fois le la commande exécutée la clé est crée.

Pour obtenir la clé publique, tapez cette commande : 
  cat ~/.ssh/id_rsa.pub
  
Un texte doit s'afficher, celui-ci est à reporter sur la forge. Pour cela voir [[#mise_en_place_de_la_cle_publique|le paragraphe correspondant]]. Le texte de la boite orange du paragraphe correspond au texte qui s'est affiché après la commande.


===== Utilisation basique =====
Ce logiciel fonctionne sous forme de projets. Pour commencer à développer il faut soit créer un nouveau projet, soit en **cloner** un via GIT.

Par exemple si l'on veut cloner le projet calendrier, on commence par se connecter sur la [[https://forge.centrale-marseille.fr/|forge]].

===== Mise en place de votre clé SSH sur GitLab ou GitHub =====
=== Sur GitHub ===
Copier le contenu du fichier **id_rsa.pub**. Si vous êtes sur Windows, ce fichier se trouve dans el dossier **.ssh**. Ensuite, rendez-vous sur GitHub, aller dans les paramètres de votre compte, et cliquer sur **SSH and GPG keys**. Vous pouvez ensuite ajouter votre clé publique.

----

=== Sur GitLab ===
Copier le contenu du fichier **id_rsa.pub**. Si vous êtes sur Windows, ce fichier se trouve dans el dossier **.ssh**. Ensuite, rendez-vous sur GitLab, aller dans **Edit profile**, et cliquer sur **SSH keys**. Vous pouvez ensuite ajouter votre clé publique.