Source de cours/scripts.php

<?
  
require ("../page.inc");
  require (
"lessons.inc");
  
  
$currentPage = new LessonPage("scripts");

  
$currentPage->setContent('');

  
$currentPage->addChapter('prepar''Préparation''
<p>
Un shell-script (ou <strong>script shell</strong>) est un fichier texte simple. Il peut donc être écrit avec votre éditeur de texte préféré. La toute première ligne du fichier doit contenir le nom de l\'<strong>interpréteur</strong> à utiliser (cela est valable pour tous les langages de script). Cette ligne doit commencer par <strong>#!</strong> suivi de l\'exécutable à utiliser. Pour un shell-script <acronym xml:lang="en" lang="en" title="Bourne Again SHell">bash</acronym>, on aura donc en début de fichier&nbsp;:
</p>
<code>#!/bin/bash<br /></code>
<p>
Ce fichier doit également être exécutable. Pour cela on lui attribuera ces droits à l\'aide de <strong>chmod</strong>. Si le fichier s\'appelle mon_programme, on peut le faire de cette manière&nbsp;:
</p>
<code class="terminal">&gt; chmod +x mon_programme</code>
<p>
Pour plus de détails sur les options de chmod, vous pouvez lire les explications sur la <a href="fichiers.php#perm">gestion des permissions</a> ou consulter sa page de manuel.
</p><p>
A présent, on peut dans ce fichier mettre des commandes shell ou appeler des programmes comme on le ferait dans une ligne de commande. Ensuite il sera invoqué en tapant son nom comme pour n\'importe quel autre exécutable.
</p><p>
On peut insérer des <strong>commentaires</strong> dans un script. Ce sont des lignes qui seront ignorées par le bash. A partir d\'un <strong>#</strong> tout le reste de la ligne est considéré comme un commentaire
</p>
<code>#!/bin/bash<br />
<br />
#Ceci est un commentaire<br />
echo ceci est affiché #Un autre commentaire<br />
</code><p>
Un script se termine lorsque la dernière ligne a été exécutée. On peut toutefois forcer sa sortie avant en utilisant la commande <strong>exit</strong>. Le code de retour du script sera celui de la dernière commande exécutée. Cela à moins de préciser une valeur numérique à la suite de exit. C\'est alors celle-ci qui sera renvoyée.
</p><p>
Des exemples de shell-scripts se trouvent dans la <a href="/boite.php">boîte à outils</a> et peuvent être consultés pour compléter ce cours.
</p>
'
);

  
$currentPage->addChapter('vars''Les variables spéciales''
<p>
Lorsqu\'un shell-script est exécuté, bash initialise certaines variables particulières qui sont alors accessibles en lecture seule. C\'est à dire qu\'elles ne peuvent pas être directement modifiées par une affectation.
</p><p>
La première pré-définie est <strong>$$</strong> qui contient le <acronym xml:lang="en" lang="en" title="Process IDentifier">PID</acronym> du script. Ce <strong xml:lang="en" lang="en">Process ID</strong>, ou en français l\'identifiant de processus, est un nombre qui à un moment donné identifie de manière unique une instance de programme en cours d\'exécution sur le système. Cette valeur peut servir par exemple à générer un nom de fichier temporaire ou pour envoyer un <a href="#signal">signal</a>.
</p><p>
Ensuite on trouve <strong>$?</strong> dont la valeur va changer au fil de l\'exécution du script. Il contiendra le code de retour de la dernière commande exécutée. A noter qu\'un code de retour de 0 signifie qu\'il n\'y a eu aucune erreur. Si cette valeur est différente de 0, il s\'agit d\'un code d\'erreur.
</p><p>
Il y a aussi les paramètres passés lors de l\'appel au script. La variable <strong>$*</strong> contient l\'ensemble de toutes ces valeurs et <strong>$#</strong> permet de connaître leur nombre. Pour accéder à un paramètre en particulier, on utilisera une des <strong>variables positionnelles</strong> $1, $2, $3, ... Pour celles après 9, il faut encadrer le nombre par des accolades&nbsp;: ${10}, ${11}, ${12}, ...
</p><p>
La variable $0 contient le nom du script tel qu\'il a été lancé, c\'est-a-dire avec les spécifications de chemin éventuelles.
</p>
'
);

  
$currentPage->addChapter('test''Réaliser des tests''
<p>
Pour réaliser un test sur des variables ou des fichiers, on utilisera comme instruction la commande intégrée <strong>test</strong> qui permet d\'opérer des comparaisons. Voici des exemples des opérations les plus courantes. Pour le moyen de réaliser d\'autres tests (sur le type du fichier par exemple), consultez la page de manuel du programme test ou celle de bash pour la commande intégrée. Est indiqué en commentaire dans quelles conditions le test est vérifié, c\'est-à-dire quand test renverra 0.
</p>
<code>
test -e /tmp/mon_fichier # /tmp/mon_fichier existe<br />
test "$VAR" = "valeur" # La variable VAR contient la chaîne valeur<br />
test "$VAR1" != "$VAR2" # Les 2 variables ont des contenus différents<br />
test "$VAR" -lt "3" # VAR contient un numérique inférieur à 3<br />
test -n "$VAR" # VAR contient une chaîne de longueur non nulle<br />
test -z "$VAR" # VAR contient une chaîne de longueur nulle<br />
</code>
<p>
Si on utilise des variables pour les expressions de test, il vaut mieux les mettre entre guillemets. Car dans le cas où cette variable ne serait pas initialisée, un argument serait manquant. Alors que de cette manière, il y a une chaîne vide dans le pire des cas. Ceci est particulièrement utile avec les options -n et -z.
</p><p>
Si on essaye de faire une comparaison arithmétique avec une des valeurs qui ne serait pas un nombre, on obtient une erreur. La liste de ces opérations est&nbsp;: -eq (=), -ne (!=), -lt (&lt;), -le (&lt;=), -gt (&gt;), -ge (&gt;=). Entre parenthèses étant indiqués leurs équivalents mathématiques.
</p><p>
On peut demander à inverser le résultat du test en utilisant l\'opérateur de négation <strong>!</strong> (point d\'exclamation). On peut aussi utiliser <strong>-a</strong> et <strong>-o</strong> pour respectivement avoir un ET et un OU logique entre plusieurs expressions. Voici un exemple&nbsp;:
</p>
<code>test "$VAR" -lt 3 -o "$VAR" -ge 8
</code>
<p>
Celui-ci sera vérifié si VAR contient un numérique inférieur à 3 ou bien supérieur ou égal à 8.
</p><p>
Une version abrégée de test existe. Il suffit de remplacer son nom par <strong>[</strong> et de mettre un <strong>]</strong> à la fin de l\'expression. Cela permet de mieux faire ressortir les tests. Sur d\'anciens systèmes, [ était un lien symbolique vers l\'exécutable test. A présent, les deux sont différents et sont intégrés au shell.
</p>
'
);

  
$currentPage->addChapter('control''Les structures de contrôle''
<p>
Dans les scripts, il est utile de faire des tests pour n\'exécuter certaines parties que quand les conditions requises sont présentes. Cela se fait à l\'aide de <strong>if</strong>. Sa syntaxe est la suivante&nbsp;:
</p>
<code>if instructions<br />
then<br />
&nbsp;&nbsp;#1er bloc d\'instructions<br />
else<br />
&nbsp;&nbsp;#2nd bloc d\'instructions<br />
fi
</code>
<p>
Juste après le <strong>if</strong>, on trouve un nombre quelconque d\'instructions (pouvant être sur plusieurs lignes). Elles seront toutes exécutées jusqu\'à ce qu\'un <strong>then</strong> soit trouvé. Ensuite ce qui importera est le code de retour de la dernière instruction. Si la valeur est 0 (ce qui correpond à aucune erreur pour bash) le premier bloc d\'instructions est alors exécuté. Dans le cas contraire, ce sera le second. Le <strong>else</strong> et le second bloc d\'instructions sont facultatifs. Si le résultat est faux et que l\'on n\'a pas cette deuxième partie, rien ne sera fait. Le <strong>fi</strong> devra en tous les cas être présent pour indiquer la fin du bloc de test.
</p><p>
Dans ce genre de situation, la commande test sera très utile. Par exemple pour tester que la variable VAR contient la chaîne VALEUR (en version abrégée)&nbsp;:
</p>
<code>if [ "$VAR" = "VALEUR" ]<br />
then<br />
&nbsp;&nbsp;echo VAR contient bien VALEUR<br />
else<br />
&nbsp;&nbsp;echo VAR ne contient pas VALEUR<br />
fi
</code>
<p>
Pour comparer une variable à plusieurs valeurs, on peut utiliser des if imbriqués (<strong>else if</strong> peut alors être abrégé en <strong>elif</strong>). Mais il y a un moyen plus simple en utilisant <strong>case in</strong>. Un exemple permettra de mieux comprendre son utilisation&nbsp;:
</p>
<code>case $variable in<br />
&nbsp;valeur1)<br />
&nbsp;&nbsp;#1er bloc d\'instructions<br />
&nbsp;&nbsp;;;<br />
&nbsp;valeur2)<br />
&nbsp;&nbsp;#2ème bloc d\'instructions<br />
&nbsp;&nbsp;;;<br />
&nbsp;valeur3)<br />
&nbsp;&nbsp;#3ème bloc d\'instructions<br />
&nbsp;&nbsp;;;<br />
&nbsp;*)<br />
&nbsp;&nbsp;#Traitement des autres valeurs<br />
&nbsp;&nbsp;;;<br />
esac<br />
</code>
<p>Entre <strong>case</strong> et <strong>in</strong> se trouve la chaîne à comparer. Ensuite on a un nombre quelconque de motifs qui sont terminés par une parenthèse fermante. Le bloc d\'instructions qui suit indique ce qu\'il faut faire si la chaîne correspond à ce modèle. La fin de celui-ci est indiqué par <strong>;;</strong> (double point virgule).
</p><p>
On peut aussi indiquer un bloc d\'instructions devant être exécutée si aucune correspondance n\'est trouvée. Il se note par <strong>*</strong> (étoile). Il est facultatif. S\'il n\'est pas présent et que la chaîne à tester ne correspond à aucune des valeurs, aucun des traitements n\'est effectué. Si une valeur correspond, les instructions sont exécutées et le déroulement du script se poursuit après <strong>esac</strong> qui indique la fin de ce bloc de tests.
</p><p>
On a parfois besoin de faire un même traitement plusieurs fois de suite. Pour cela bash met à disposition plusieurs types de <strong>boucles</strong>. <strong>while</strong> et <strong>until</strong> permettent cela de manières quasiment similaires.
</p>
<code>while instructions<br />
do<br />
&nbsp;&nbsp;# Traitement à répéter<br />
done<br /><br />
until instructions<br />
do<br />
&nbsp;&nbsp;# Traitement à répéter<br />
done<br />
</code>
<p>
Pour le <strong>while</strong>, le traitement est répété <strong>tant que</strong> la dernière des instructions précédant le mot <strong>do</strong> se déroule bien (renvoit 0).
</p><p>
Pour le <strong>until</strong>, le traitement est répété <strong>jusqu\'à ce que</strong> la dernière des instructions précédant le mot <strong>do</strong> se déroule bien (renvoit 0).
</p><p>
La fin de ces instructions est indiquée par <strong>done</strong>.
</p><p>
Il existe un autre type de boucle différent qui s\'utilise avec <strong>for</strong>. Contrairement aux précédentes, le nombre d\'itérations est connu à l\'avance. Sa syntaxe générale est de la forme&nbsp;:
</p>
<code>for variable in liste_de_valeurs<br />
do<br />
&nbsp;&nbsp;# Traitement à répéter<br />
done<br />
</code>
<p>
La liste suivant le <strong>in</strong> est constituée de plusieurs valeurs séparées par des espaces. Le traitement sera alors répété et on aura accès à $variable qui prendra successivement ces valeurs dans l\'ordre indiqué. Dès que toutes les valeurs auront été parcourues, la boucle s\'arrêtera.
</p><p>
Voici un petit exemple qui va afficher à l\'écran les nombres de 1 à 10&nbsp;:
</p>
<code>for i in 1 2 3 4 5 6 7 8 9 10<br />
do<br />
&nbsp;&nbsp;echo $i<br />
done<br />
</code>
<p>
On peut bien sûr mettre comme liste de valeurs le résultat d\'un programme en utilisant les guillemets inversés. D\'une manière générale, tout ce qui est une chaîne de caractères peut se trouver là. Si l\'on a besoin qu\'une des valeurs contienne des espaces, on l\'encadrera de guillemets. Cette liste est soumise aux expansions réalisées par le shell. Voici donc un moyen de répéter un traitement (plus utile que celui-là dans la pratique) sur tous les fichiers d\'extension .txt du répertoire courant.
</p>
<code>for fichier in *.txt<br />
do<br />
&nbsp;&nbsp;echo $fichier<br />
done<br />
</code>
<p>
Si on ne spécifie pas de liste de valeurs (en omettant le <strong>in</strong>), la boucle travaillera sur les variables positionnelles ($1, $2, ...)
</p>
'
);

  
$currentPage->addChapter('opt''Manipulation des paramètres''
<p>
Un shell-script un peu perfectionné pourra accepter de nombreux paramètres et options. Ceux-ci pourront éventuellement être facultatifs et l\'ordre ne doit pas importer. Faire cela avec ce qui a été vu jusque-là serait fastidieux. Heureusement des facilités sont fournies.
</p><p>
En tout premier, <strong>shift</strong> permet de décaler les variables positionnelles. Son appel sans paramètre va affecter à $1 la valeur de $2, à $2 la valeur de $3 et ainsi de suite. Si on lui passe une valeur numérique, le décalage se fera de cette valeur plutôt que d\'un rang.
</p><p>
bash fournit la commande integrée <strong>getopts</strong> qui permet de facilement parcourir tous les paramètres. Voici un exemple classique d\'utilisation qui sera expliqué ensuite&nbsp;:
</p>
<code>
while getopts a:bc:d option<br />
do<br />
&nbsp;case $option in<br />
&nbsp;&nbsp;a)<br />
&nbsp;&nbsp;&nbsp;echo "option a : $OPTARG"<br />
&nbsp;&nbsp;&nbsp;;;<br />
&nbsp;&nbsp;b)<br />
&nbsp;&nbsp;&nbsp;echo "option b"<br />
&nbsp;&nbsp;&nbsp;;;<br />
&nbsp;&nbsp;c)<br />
&nbsp;&nbsp;&nbsp;echo "option c : $OPTARG"<br />
&nbsp;&nbsp;&nbsp;;;<br />
&nbsp;&nbsp;d)<br />
&nbsp;&nbsp;&nbsp;echo "option d"<br />
&nbsp;&nbsp;&nbsp;;;<br />
&nbsp;esac<br />
done<br />
</code>
<p>
getopts va successivement mettre dans la variable passée en paramètre (ici option) les différents paramètres lors de l\'appel au script. Il les vérifie en même temps et retourne une erreur si un de ceux-ci ne correspond pas. Pour connaître les valeurs autorisées, on lui spécifie les options possibles. Ici on avait la chaîne a:bc:d qui jouaient ce rôle. Elle indique que les options a, b, c et d sont autorisées uniquement. Une lettre suivie de : (deux points) indique qu\'un paramètre est nécessaire pour cette option. getopts le mettra alors dans la variable d\'environnement $OPTARG pour permettre d\'accéder à sa valeur.
</p><p>
En supposant que le code précédent ait été inséré dans un shell-script s\'appelant mon_script, voici des exemples d\'exécution qui produiront tous le même résultat. Pour ce script, l\'ordre d\'affichage sera bien sûr différent. Mais un véritable programme sauvegardera dans des variables d\'environnement les options pour les utiliser par la suite.
</p>
<code class="terminal">
&gt; mon_script -a paramètre -bd<br />
&gt; mon_script -b -aparamètre -d<br />
&gt; mon_script -dba paramètre<br />
</code>
<p>
Ce que l\'on remarquera principalement, c\'est que les options peuvent ou non être regroupées, -bd étant identique à -b -d. Et également le paramètre passé à l\'option -a peut ou non être séparé par un espace.
</p>
'
);

  
$currentPage->addChapter('signal''Gestion des signaux''
<p>
Les <strong>signaux</strong> constituent un moyen de communication entre plusieurs programmes. Ceci est plutôt utilisé dans des programmes en C, mais peut très bien être utilisé dans un script.
</p><p>
Pour obtenir la liste des signaux disponibles, tapez la commande&nbsp;:
</p>
<code class="terminal">&gt; kill -l</code>
<p>
La commande <strong>kill</strong> (qui est intégrée au bash) ne vous est pas inconnue si vous utilisez GNU/Linux depuis quelques temps. Elle permet d\'envoyer un signal à un programme. Or certains signaux vont provoquer l\'arrêt du programme. C\'est le cas du signal SIGTERM (numéro 15) notamment qui est celui envoyé par défaut par kill. Dans le cas d\'un programme récalcitrant (qui ne répond plus ou a choisi d\'ignorer ce signal), il peut être stoppé, sans qu\'il ne puisse rien y faire, par l\'envoi d\'un signal SIGKILL (9). La commande kill prend comme argument le numéro du signal précédé du signe -, puis l\'identifiant du programme (PID).
</p><p>
Dans un shell-script, on peut définir comment il doit réagir aux différents signaux qu\'il recevra. Cela se fait à l\'aide de la commande <strong>trap</strong> qui définit quoi exécuter pour chaque signal. On l\'utilise comme ceci&nbsp;:
</p>
<code>trap commande liste_signal</code>
<p>
liste_signal contient la liste des signaux concernés par cette commande. Ils peuvent être indiqués par leurs noms ou par leurs numéros. En n\'indiquant aucune commande, cela permet de rétablir le gestionnaire de signal à sa valeur par défaut. Bien évidemment, le signal SIGKILL ne peut pas être intercepté à l\'aide de cette commande.
</p><p>
Si le signal a pour valeur 0, la commande associée sera appelée lorsque le shell sera terminé. Il s\'agit de l\'utilisation la plus courante de trap dans un shell-script. On définit une fonction de nettoyage, et on l\'associe au signal 0 (EXIT). Cela permet que même si le script est interrompu, on remette les choses en place avant de quitter. Voici un tel exemple&nbsp;:
</p>
<code>
function nettoyage()<br />
{<br />
&nbsp;# Tout nettoyer<br />
&nbsp;# Par exemple supprimer les fichiers temporaires<br />
&nbsp;rm -f /tmp/mon_fichier<br />
}<br />
trap "nettoyage" 0<br />
</code>
'
);

  
$currentPage->addChapter('group''Regrouper des commandes''
<p>
Pour exécuter une suite de commandes sur une seule ligne, on peut les placer les unes à la suite des autre en les séparant par des points-virgules. Dans un script, cela n\'a que peu d\'intérêt. Mais il est possible de les entourer par des parenthèses <strong>( )</strong> ou des accolades <strong>{ }</strong>. Alors cela sera considéré comme un sous-script et l\'expression totale vaudra le code de retour de la dernière commande. Voici des exemples des deux notations&nbsp;:
</p>
<code>( echo "liste des fichiers"; ls; )<br />
{ echo "liste des fichiers"; ls; }</code>
<p>
Il est important de respecter l\'espace entre les commandes et les délimiteurs. Il y a une différence entre ces deux notations. Celle avec des parenthèses, va exécuter les commandes dans un sous-shell. Celle avec les accolades va le faire dans le shell courant. Cela peut provoquer un comportement différent si l\'on utilise à l\'intérieur des variables extérieures qui n\'ont pas été exportées.
</p><p>
Si l\'on souhaite utiliser plusieurs fois un groupe de commandes, on peut les regrouper dans une <strong>fonction</strong>. Comme déjà abordé dans <a href="bash.php">l\'utilisation du bash</a>, une fonction se déclare sous la forme&nbsp;:
</p>
<code>function ma_fonction()<br />
{<br />
&nbsp;#Liste des commandes<br />
}<br />
</code>
<p>
Dans un script, on peut mettre les différentes commandes sur plusieurs lignes pour augmenter la lisibilité. On peut ne pas mettre le mot-clé <strong>function</strong> ou les parenthèses. Mais au moins un des deux est obligatoire.
</p><p>
Les variables passées en paramètre lors de l\'appel à la fonction sont accessibles par les variables positionnelles. Cela se passe de la même manière que pour accéder aux variables du script avec $1, $2, ... mais aussi $* et $#. Par conséquent si une fonction à l\'intérieur d\'un script doit accéder à un des paramètres du script, il faut lui passer explicitement lors de l\'appel car elle ne les voit pas directement.
</p><p>
Une fonction est terminée lorsqu\'il y a une accolade fermante. Mais parfois on souhaite en sortir avant, à la suite d\'un test par exemple. Pour cela on peut utiliser la commande <strong>return</strong>. On peut lui passer une valeur. Ce sera le code de retour de la fonction qui peut être utilisé directement pour un test ou dans une boucle, ou alors par la variable $?. Comme pour exit, le code de retour sera en l\'absence de cette valeur celui de la dernière commande exécutée.
</p>
<code>
function une_fonction()<br />
{<br />
&nbsp;echo paramètre : $1<br />
&nbsp;return 5<br />
}<br />
<br />
une_fonction test<br />
echo retour : $?<br />
</code>
<p>
On aura alors, si le script s\'appelle essai_fonction&nbsp;:
</p>
<code class="terminal">&gt; essai_fonction<br />
paramètre : test<br />
retour : 5<br />
</code>
'
);

  
$currentPage->display();
?>