InstantFPC/fr: what changed

Revision 2 to 3. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		=Overview=
2	2
3	3		Cet outil vous permet d'exécuter un programme Pascal comme un script sous Linux, BSD, OS X et Windows. P.ex. :
4	4
5	5		``` pascal
6	6		#!/usr/bin/env instantfpc
7	7		begin
8	8		writeln('Hello fpc user');
9	9		end.
10	10		```
11	11
12	12		Enregistrez le fichier en hello.pas, définissez la permission en exécution (pour Linux et consort) et exécutez-le:
13	13
14	14		``` bash
15	15		[]$ chmod a+x hello.pas
16	16		[]$ ./hello.pas
17	17		Hello fpc user
18	18		```
19	19
20	20		Notes:
21	21
22	22		- La première ligne est appelée shebang et est débarrassée du source avant de le passer au compilateur.
23	23		- La ligne 'program hello;' est optionnelle dans FPC. Comme instantfpc passe l'option -o au compilateur, la ligne est ignorée, donc vous pouvez l'omettre.
24	24
25	25		Bien sûr vous pouvez passer des paramètres à votre script:
26	26
27	27		``` pascal
28	28		#!/usr/bin/env instantfpc
29	29		var
30	30		i: Integer;
31	31		begin
32	32		for i:=0 to ParamCount do writeln(ParamStr(i));
33	33		end.
34	34		```
35	35
36	36		Enregistrez le fichier comme params.pas, définissez la permission en exécution et exécutez-le:
37	37
38	38		``` bash
39	39		[]$ chmod a+x params.pas
40	40		[]$ ./params.pas A B
41	41		/home/mattias/.cache/instantfpc/params.pas
42	42		A
43	43		B
44	44		```
45	45
46	46		# Télécharger
47	47
48	48		Pas besoin de télécharger: instantfpc fait partie des sources de FPC 2.6+ dans utils/instantfpc et est installé par défaut.
49	49
50	50		## Anciennes versions
51	51
52	52		Pour fpc 2.5.1 et suivantes: c'est dans les sources de fpc:
53	53
54	54		``` bash
55	55		svn co http://svn.freepascal.org/svn/fpc/trunk/utils/instantfpc instantfpc
56	56		```
57	57
58	58		Pour fpc 2.4.4 et 2.4.5:
59	59
60	60		``` bash
61	61		svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/applications/instantfpc instantfpc
62	62		```
63	63
64	64		# Installation
65	65
66	66		Note: C'est déjà installé avec fpc 2.5.1 et suivantes. Les utilisateurs sous Windows doivent placer instantfpc.exe dans un dossier de leur PATH.
67	67
68	68		1. Compilez le projet instantfpc.lpi avec Lazarus ou Lazbuild. Ou compilez-le directement avec fpc instantfpc.pas.
69	69		2. Placez l'exécutable dans un répertoire de votre PATH, par exemple /usr/bin:
70	70
71	71		``` bash
72	72		sudo cp instantfpc /usr/bin/
73	73		```
74	74
75	75		# Comment ça marche
76	76
77	77		Il utilise un répertoire cache pour compiler. Par défaut c'est \$HOME/.cache/instantfpc. Si la variable \$HOME n'est pas définie, cela déclenche une erreur. Vous pouvez surcharger le dossier en définissant la variable d'environnement INSTANTFPCCACHE. Il compare le source avec celui enregistré dans le cache et s'il diffère, le source est compilé en tenant compte des paramètres passés dans la ligne shebang (la première ligne dans le script après \#!). Après la compilation réussie, il exécute le programme. Si la compilation échoue, il écrit la sortie de fpc sur la sortie standard.
78	78
79	79		# Paramètres de instantfpc
80	80
81	81		- -h: Affiche l'aide et se termine
82	82		- -v: Affiche la version courante et se termine.\>
83	83		- --get-cache: Affiche le répertoire cache courant et se termine.
84	84		- --set-cache=\<directory\>: Définit le cache courant.
85	85		- -B: force la compilation même si le programme en cache est valide.
86	86		- --compiler=\<path to compiler\> utilise ce compilateur. Par défaut, fpc est recherché dans le PATH.
87	87		- --skip-run: N'exécute pas le programme. Utile pour tester si le script compile. Meilleur si combiné avec -B.
88	88		- Variable d'environnement INSTANTFPCCACHE: Définit le répertoire du cache. L'option --get-cache peut surcharger ceci.
89	89		- Variable d'environnement INSTANTFPCOPTIONS: Les options à passer au compilateur, passées avant les paramètres de la ligne de commande.
90	90
91	91		# Passage de paramètres au compilateur
92	92
93	93		Les paramètres du compilateur peuvent être passés dans la ligne shebang. Remarque: vous ne pouvez pas utiliser la commande 'env'.
94	94
95	95		``` pascal
96	96		#!/usr/bin/instantfpc -O1 -Ci
97	97		begin
98	98		end.
99	99		```
100	100
101	101		Et/Ou vous pouvez placer les options du compilateur dans la variable d'environnement INSTANTFPCOPTIONS:
102	102
103	103		``` bash
104	104		export INSTANTFPCOPTIONS="-Fu~/lazarus/components/codetools/units/x86_64-linux/"
105	105		```
106	106
107	107		``` pascal
108	108		#!/usr/bin/instantfpc
109	109		uses FileProcs; // unit FileProcs is in codetools
110	110		begin
111	111		end.
112	112		```
113	113
114	114		# Exemple
115	115
116	116		L'exemple de script suivant délivre le "numéronyme" d'une chaîne (p.ex. i18n pour internationalization) qui peut être fourni soit par un paramètre ou, si manquant, saisi par l'utilisateur:
117	117
118	118		``` pascal
119	119		#!/usr/bin/env instantfpc
120	120		uses
121	121		SysUtils;
122	122		var
123	123		theWord: String;
124	124		begin
125	125		if ParamStr(1) = '' then
126	126		begin
127	127		write('SVP, entrez le mot à "numéronymiser": ');
128	128		readln(theWord);
129	129		end
130	130		else
131	131		theWord := ParamStr(1);
132	132		if length(theWord) > 2 then
133	133		writeln(theWord[1] + IntToStr(length(theWord)-2) + theWord[length(theWord)])
134	134		else
135	135		writeln('N/A');
136	136		end.
137	137		```
138	138
139	139		# Usage avec Lazarus
140	140
141	141		Depuis Lazarus 0.9.31, l'EDI ignore la ligne shebang. Vous obtenez toutes les caractéristiques normal du code.
142	142
143	143		Installez le paquet EDI instantfpclaz, qui est fourni avec Lazarus. Ceci ajoutera un nouveau modèle de projet pour créer des programmes instantfpc, par exemple, sous Fichier / Nouveau / Projet / InstantFPC program.
144	144
145	145		## Compiler dans Lazarus
146	146
147	147		Comment convertir un projet Lazarus pour le compiler avec instantfpc:
148	148
149	149		Requiert:
150	150
151	151		- Le source principal du projet Lazarus est le programme instantfpc.
152	152
153	153		Réglage:
154	154
155	155		- Aller vers Projet / Options du projet / Compiler commands / Compilation
156	156		- Désactivez tout les cases à cocher Appel sur pour Compiler
157	157		- Définissez dans Exécuter avant la Commande en:
158	158
159	159		``` bash
160	160		instantfpc --skip-run -B -gl "-Fu$(ProjUnitPath)" $Name($(ProjFile))
161	161		```
162	162
163	163		- Activez les cases à cocher des scan make et fpc
164	164
165	165		Remarques:
166	166
167	167		- L'option -gl demande à FPC de compiler avec les informations de débogage
168	168		- L'option --skip-run -B compile sans exécuter après.
169	169		- Voir [[IDE Macros in paths and filenames\|IDE Macros]]
170	170
171	171		## Débogage avec Lazarus
172	172
173	173		Comment convertir un projet Lazarus pour déboguer un programme instantfpc:
174	174
175	175		Requiert:
176	176
177	177		- Ci dessus Compiler dans Lazarus
178	178
179	179		Réglages:
180	180
181	181		- Aller vers Exécuter / Paramètres d'exécution
182	182		- Définissez Local / Application hôte vers \$(InstantFPCCache)/\$NameOnly(\$(ProjFile))
183	183		- Definissez Répertoire de travail vers \$(ProjPath)
184	184
185	185		# Usage dans Apache
186	186
187	187		Ceci montre comment utiliser instantfpc dans un serveur Web Apache. Instantfpc nécessite un répertorie cache qui doit être accessible en écriture par un compte Apache. Disons qu'Apache tourne avec le compte utilisateur www-data et le groupe www-data (Redhat, Fedora: apache.apache, voir la config. pour l'utilisateur et le groupe).
188	188
189	189		``` bash
190	190		mkdir /var/apacheinstantfpc
191	191		chown www-data.www-data /var/apacheinstantfpc
192	192		```
193	193
194	194		Passez une variable d'environnement pour les script CGI en ajoutant la ligne suivante dans les configs Apache:
195	195
196		-	~~`SetEnv INSTANTFPCCACHE /var/apacheinstantfpc`~~
	196	+	``` pascal
	197	+	SetEnv INSTANTFPCCACHE /var/apacheinstantfpc
	198	+	```
197	199
198	200		Conseil de sécurité: Bien que l'utilisateur apache doit avoir un accès complet au répertoire de cache, assurez-vous que le répertoire n'est pas disponible à partir de l'extérieur (par exemple, ne pas mettre sous /var/www). Il peut contenir des anciens scripts. Et comme tout autre type de script: Vérifiez toutes les entrées pour les attaques.
199	201
200	202		Remarque sur l'optimisation: Le cache de instantfpc utilise un fichier par nom de script. Ne pas utiliser le même nom de script deux fois, sinon il sera compilé de nombreuses fois. Vous pouvez créer plusieurs répertoires de cache. Chaque section \<Directory\> et \<VirtualHost\> peut définir leurs propres variables d'environnement, et donc vous pouvez configurer un répertoire de cache pour chacun.
201	203
202	204		## Exemple Apache montrant env
203	205
204	206		Configurer un répertoire pour exécuter les scripts cgi. P.ex.:
205	207
206	208		ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
207	209		<Directory "/usr/lib/cgi-bin">
208	210		AllowOverride None
209	211		Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
210	212		Order allow,deny
211	213		Allow from all
212	214		SetEnv INSTANTFPCCACHE /var/apacheinstantfpc
213	215		# You can put fpc options into /etdc/fpc.cfg or here:
214	216		#SetEnv INSTANTFPCOPTIONS -Fu/path/to/somevar/ppufiles
215	217
216	218		# If this is root directory, you might have to set:
217	219		#Require all granted
218	220		</Directory>
219	221
220	222		Si votre Apache n'a pas encore activé le module cgi:
221	223
222		-	~~`a2enmod cgi`~~
	224	+	```text
	225	+	a2enmod cgi
	226	+	```
223	227
224	228		Placez le script suivant dans /usr/lib/cgi-bin/showenv.pas:
225	229
226	230		``` pascal
227	231		#!/usr/bin/instantfpc
228	232		{$mode objfpc}{$H+}
229	233		uses SysUtils;
230	234		var i: Integer;
231	235		begin
232	236		writeln('Content-type: text/html');
233	237		writeln;
234	238		writeln('<HTML><BODY>');
235	239		for i:=0 to Paramcount do
236	240		writeln('Param ',i,' ',ParamStr(i),'<br>');
237	241		for i:=1 to GetEnvironmentVariableCount do
238	242		writeln('Env ',GetEnvironmentString(i),'<br>');
239	243		writeln('</BODY></HTML>');
240	244		end.
241	245		```
242	246
243	247		# Bugs / A faire / Limitations
244	248
245	249		- Les changements dans le compilateur ou les unités en sont pas vérifiés. Si vous installez un nouveau compilateur, vous devez nettoyer le cache (i.e. supprimer le répertoire ~/.cache/instantfpc).
246	250		- Sous Windows, seul le premier paramètre est passé au script.
247	251		- Avec les versions de instantfpc antérieures à 1.3, vous ne pouvez pas compiler en parallèle. Le compilateur crée des fichiers cachés comme 'link.res' pendant la compilation. Depuis la version 1.3, instantfpc utilise des répertoires temporaires pour la compilation.
248	252		- Le cache utilise le nom de fichier sans le chemin d'accès. Donc vous ne pouvez pas exécuter deux scripts en parallèle avec le même nom et le script sera compilé à chaque fois.
249	253
250	254		# Alternatives
251	255
252	256		L'astuce suivante marche en utilisant le shell bash. Placez le programme dans le fichier fpc_script.sh:
253	257
254	258		``` pascal
255	259		// 2>/dev/null; fpc fpc_script.pp &> build.log && exec ./fpc_script "$@" \|\| cat build.log; exit
256	260		begin
257	261		writeln('');
258	262		end.
259	263		```
260	264
261	265		---
262	266		From the Free Pascal wiki, page "InstantFPC/fr", as it stood on 2020-02-17 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history