Cours Netbeans

Cours SubVersion sous NetBeans en pdf


Télécharger Cours SubVersion sous NetBeans en pdf

★★★★★★★★★★3.5 étoiles sur 5 basé sur 1 votes.
Votez ce document:

Télécharger aussi :


Cours SubVersion sous NetBeans

...

Subversion (SVN) est l'évolution de Concurrent Versions System (CVS), ses avantages font que son utilisation commence prendre sérieusement le pas sur son prédécesseur. On trouve de plus en plus de modules parmi les EDI pour se connecter à cette nouvelle référence en matière de gestion de projet. Netbeans ne fait pas exeption à la règle, bien que son intégration fut plus tardive que dans Eclipse, toutes les commandes fondamentales de Subversion sont supportées parle module.

II - Installation

II.1 - NetBeans

Il vous faut une version de Netbeans, 5.5.

Suivez les consignes pour l'installation.

Une fois le logiciel installé, accédez au menu de mise à jour des modules :

Sélectionnez "NetBeans Update Center"

Allez chercher le module SubVersion. D'autres modules seront ajoutés à la liste car ils sont nécessaires à son bon fonctionnement

"Lisez" et acceptez les licences

Si vous rencontrez cette erreur, c'est sans doute car Subversion n'est pas installé.

Si celui-ci est bien installé c'est que la variable d'environnement "PATH" de votre système n'a pas été correctement complétée. Allez la vérifier et au besoin ajoutez le chemin vers les exécutables de Subversion.

Si cela ne marche toujours pas, modifiez le chemin et ajoutez le paramètre suivant à l'exécution de NetBeans:

-J-Dsubversion.path=/path/to/subversion/bin

III - Importer

Pour mettre à disposition notre projet il faut l'envoyer sur le serveur SVN. la procédure ressemble à un envoi en FTP avec quelques compléments d'informations.

La première chose dont on aura besoin pour notre projet et donc la commande d'import.

Accéder au menu d'import SVN :

Préciser les paramètres Adresse, Utilisateur et Mot de passe :

IV - Checkout

Vos collaborateurs vont maintenant pouvoir récupérer le projet sur le serveur.

Pour le récupérer on va utiliser la commande Checkout de Subversion.

Accéder au menu Checkout SVN :

Préciser les paramètres Adresse, Utilisateur et Mot de passe :

Préciser le dossier à récupérer, le dossier où il sera importé et si besoin la version que vous désirez :

Même point noir que pour l'import, on ne sait pas l'avancement de la récupération.

Attendez que tout soit téléchargé.

V - Mise à jour

Une fois que vous avez fini d'éditer vos pages de codes, vous pouvez envoyez votre travail en faisant un "Commit".

Ne faites pas des commit fichier par fichier si vous en avez modifié plusieurs. Effectuer la validation au niveau de la racine commune, cela permettra d'avoir un seul changement de version pour tous vos changements, et non pas une par fichier.

Il est important de préciser au minimum les modifications que vous avez faites dans le message. Cela afin de pouvoir remonter à une version antérieure en cas de problème.

Validez et attendez la fin de la mise à jour.

VI - Les Différences

Avec l'avancement du projet il viendra des moments où il sera nécéssaire de comparer différentes versions,

- aussi bien pour corriger des conflits,

- que pour récupérer une version antérieur.

VI.1 - Vue d'ensemble

Il peut être intéressant de savoir ce qui a été modifié entre la version du serveur et la vôtre.

Pour accéder à la liste des modifications sélectionnez le dossier à comparer et faites un clic droit.

Après quelques secondes on obtient la liste des différences :

VI.2 - Détail sur les sources

Plutôt que d'avoir une vue générale des fichiers qui ont changé ou afin de résoudre des conflits entre les versions, on utilise le menu "diff".

Cette installation concerne la version 7.4 de NetBeans. Elle a été réalisée sous Windows 7 Professionnel 64bits avec WAMP Server 2.4 64 bits (Apache 2.4.4 et PHP 5.4.12).

La connaissance de ces environnements est nécessaire pour suivre ce tutoriel (création et paramétrage d’un projet sous NetBeans, ligne de commande sous Windows, modification des fichiers de configuration de WAMPServer).

NetBeans est un EDI (Environnement de Développement Intégré ou IDE en anglais pour Integrated Development Environment) open source développé à l'origine par Sun Microsystems mais repris depuis 2010 par Oracle Corporation.

Ce type d'environnement regroupe un ensemble d'outils dédiés au développement de logiciels. NetBeans supporte les langages Java, PHP, C/C++, Fortran, JavaScript, Python et Ruby.

Site officiel : netbeans 1. L’extension Xdebug 1.1 Présentation

Xdebug est une extension pour PHP qui permet le débogage et le profilage de code par une exécution pas à pas des instructions.

Exemple d'exécution d'un script sans et avec Xdebug activé :

Script exécuté  

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

1.2 Configuration

Xdebug est déjà préconfiguré avec cette version de WampServer. Il suffit donc de « l’activer » en modifiant son paramétrage.

Ø            Vérifier que vous ayez bien le fichier php_xdebug-2.2.3-5.4-vc9-x86_64.dll dans le dossier C:\wamp\bin\php\php5.4.12\zend_ext

Ø            Ouvrir le fichier php.ini depuis l'application WampServer et ajouter la ligne qui apparait en vert à la fin du fichier :

; XDEBUG Extension



zend_extension = "c:/wamp/bin/php/php5.4.12/zend_ext/php_xdebug-2.2.3-5.4-vc9- x86_64.dll"

[xdebug]

xdebug.remote_enable              = off

xdebug.profiler_enable              = off

xdebug.profiler_enable_trigger = off

xdebug.profiler_output_name                = cachegrind.out.%t.%p

xdebug.profiler_output_dir      = "c:/wamp/tmp"

xdebug.show_local_vars = on

Ø            Redémarrer le service Apache pour une prise en compte des nouveaux paramètres.

Ø            Vérifier que vous obtenez bien le résultat attendu dans le paragraphe 1.1. 1.2.2 Intégration à NetBeans

Ø            Modifier et ajouter les lignes qui apparaissent en vert dans la section Xdebug du fichier php.ini :

Ø            Redémarrer le service Apache pour une prise en compte des nouveaux paramètres.

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

1.3 Mise en œuvre

Ø            Ouvrir NetBeans et lancer l'exécution du script (cf. §1.1) en mode débogage : (ou <Ctrl> + F5)

~b La barre des outils dédiée au débogage est activée :

Ø            Après deux clics sur l'icône         on obtient la trace suivante :

  1. Le "framework" PEAR 2.1 Présentation

PEAR (PHP Extension and Application Repository) est une collection de bibliothèques d'outils développés en PHP. Elle peut être assimilée à un framework. Ce type de bibliothèque propose un ensemble de composants logiciels pouvant être exploités librement et personnalisés.

d Les outils abordés par la suite dans ce tutoriel (ApiGen, Code Sniffer, PMD et PHPUnit) s’appuient sur cette bibliothèque qu’il faut donc installer.

2.2 Installation

… … …

Ø            Lancez une console (avec les droits d’un administrateur) puis placez-vous dans le répertoire C:\wamp\bin\php\php5.4.12

Ø            Lancer l’installation de PEAR :

> php go-pear.phar

- Pour toutes les questions qui suivront, taper la touche entrée pour répondre avec les valeurs proposées par défaut.

Suite à cette installation, un fichier Pear_ENV.reg est créé dans le répertoire C:\wamp\bin\php\php5.4.12

Ø            Double-cliquer sur ce fichier depuis l’explorateur afin de finaliser l'installation PEAR.

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

  1. Générateur ApiGen 3.1 Présentation

ApiGen est un outil de génération automatique de documentation de code PHP qui s'appuie sur des composants logiciels de la bibliothèque PEAR.

Alternative à phpDocumentor, il est recommandé sous NetBeans.

La convention d’écriture des commentaires est PHPDoc (adaptation de JAVADoc). Cette syntaxe est utilisée par PEAR ainsi que par l’outil de modélisation DIA.

3.2 Installation

Ø            Ouvrir une console (avec les droits d’un administrateur) puis placez-vous dans le répertoire C:\wamp\bin\php\php5.4.12 et lancer les commandes suivantes :

> pear config-set auto_discover 1

> pear install pear.apigen.org/apigen

Ø            Configurer l’EDI (Menu : Outils/Options/PHP/Onglet « ApiGen »)

d Cette version nécessite une mise à jour du chemin vers Texy1 :

Ø            Ouvrir le fichier C:\wamp\bin\php\php5.4.12\apigen avec Notepad++ et modifier le chemin vers le script texy.php comme surligné en vert :

 3.3 Mise en œuvre

Ø            Créer un dossier dans lequel la documentation sera générée. Exemple :

1 Texy est une bibliothèque PHP dédiée à la mise en forme de pages WEB.

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

Ø            Depuis l’explorateur de projet de NetBeans, faire un clic droit sur le projet et choisir la fonctionnalité de génération de documentation :

Exemple de résultat :

Le code d’une classe     La documentation générée (extraits)

<?php

/**

* Projet Tuto NetBeans

* Classe de démonstration pour la génération de documentation.

* @author          Nicolas Defaÿ

* @license         CC by-nc-sa

* @version        1.0

*

*/

class Chaise {

/**

* La couleur de la chaise *

* @var string

* @access private */

private $couleur;



/**

* Le constructeur de Chaise *

* @param string $uneCouleur * @access public

*/

public function __construct($uneCouleur)

{

$this->couleur = $uneCouleur;

}

/**

* Retourne la couleur de la chaise

*

* @access public

* @return string

*/

public function getCouleur()

{

return $this->couleur;

}

}

?>

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

  1. Les frameworks Code Sniffer et PMD 4.1 Présentation

CodeSniffer est un analyseur de code qui intègre les conventions de codage de plusieurs standards (PEAR, ZEND...). Il analyse également le code JavaScript et les feuilles de style (CSS). Il est possible de définir ses propres conventions.

PMD (PHP Mess Detector) est à la base un framework d’analyse de code source Java. Il existe également pour PHP et s’intègre facilement sous NetBeans.

Cet outil vérifie la qualité du code (respect des conventions d’écriture, complexité, code mort...)

Ø            Ouvrir une console (avec les droits d’un administrateur) puis placez-vous dans le répertoire C:\wamp\bin\php\php5.4.12 et lancer les commandes suivantes :

>             pear      install PHP_CodeSniffer                             

>             pear      channel-discover pear.phpmd.org

>             pear      channel-discover pear.pdepend.org

> pear install --alldeps phpmd/PHP_PMD

 Ignorer l’avertissement concernant php_bin et l’erreur relative au fichier imagick.dsp

Ø            Configurer l’EDI (Menu : Outils/Options/PHP/Onglet « Code Analysis »)

4.3 Mise en œuvre

Ø            Depuis NetBeans, ouvrir le fichier à tester et lancer l'analyse du code : Menu Source/Inspect...

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

Exemple de résultat obtenu en utilisant la classe abordée en 3.3 :

 Les erreurs affichées concernent le non respect des conventions d’écriture du code. Elles sont générées par Code Sniffer (configuré pour PEAR).

Ø            Ajouter une propriété quelconque dans la classe Chaise et relancer l’analyse du code

 Ici, l’analyse réalisée par PMD fait ressortir la non-utilisation de la propriété ajoutée dans le code.

  1. Le framework PHPUnit 5.1 Présentation

PHPUnit est un framework de tests unitaires développé pour le langage PHP. Il est basé sur JUnit, une référence en termes de tests unitaires pour Java. Il propose également un générateur de squelettes de classes destinées aux tests.

PHPUnit s’intègre très facilement sous NetBeans. Site officiel : http://phpunit.de/  5.2 Installation

Ø            Ouvrir une console (avec les droits d’un administrateur) puis placez-vous dans le répertoire C:\wamp\bin\php\php5.4.12 et lancer les commandes suivantes :

>             pear      channel-discover pear.phpunit.de

>             pear      install --alldeps phpunit/PHPUnit

>             pear      install phpunit/PHPUnit_SkeletonGenerator

Environnement de développement et de test

Ø            Configuration de NetBeans pour PHP   Nicolas Defaÿ

Ø            Configurer l’EDI (Menu : Outils/Options/PHP/Onglet « Unit Testing »)

5.3 Mise en œuvre

Ø            Créer un dossier dans lequel les squelettes de classe seront générés. Exemple :

Ø            Dans l'explorateur de projet, faire un clic droit sur le script à tester et choisir la fonctionnalité de génération de gabarit de test :

Ø            Le cas échéant, choisir l'utilitaire PHPUnit dans la fenêtre qui suit :

 Remarque :

Un dossier nommé        à été rajouté au projet. C’est un alias du dossier précédemment créé.

Exemple de résultat obtenu en utilisant la classe abordée en 3.3 :



244