InstantFPC/fr: what changed

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

Old	New		Line
1		-	\
2		-	\
3	1		=Overview=
4	2
5	3		Cet outil vous permet d'exécuter un programme Pascal comme un script sous Linux, BSD, OS X et Windows. P.ex. :
6	4
7	5		``` pascal
8	6		#!/usr/bin/env instantfpc
9	7		begin
10	8		writeln('Hello fpc user');
11	9		end.
12	10		```
13	11
14	12		Enregistrez le fichier en hello.pas, définissez la permission en exécution (pour Linux et consort) et exécutez-le:
15	13
16	14		``` bash
17	15		[]$ chmod a+x hello.pas
18	16		[]$ ./hello.pas
19	17		Hello fpc user
20	18		```
21	19
22	20		Notes:
23	21
24	22		- La première ligne est appelée shebang et est débarrassée du source avant de le passer au compilateur.
25	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.
26	24
27	25		Bien sûr vous pouvez passer des paramètres à votre script:
28	26
29	27		``` pascal
30	28		#!/usr/bin/env instantfpc
31	29		var
32	30		i: Integer;
33	31		begin
34	32		for i:=0 to ParamCount do writeln(ParamStr(i));
35	33		end.
36	34		```
37	35
38	36		Enregistrez le fichier comme params.pas, définissez la permission en exécution et exécutez-le:
39	37
40	38		``` bash
41	39		[]$ chmod a+x params.pas
42	40		[]$ ./params.pas A B
43	41		/home/mattias/.cache/instantfpc/params.pas
44	42		A
45	43		B
46	44		```
47	45
48	46		# Télécharger
49	47
50	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.
51	49
52	50		## Anciennes versions
53	51
54	52		Pour fpc 2.5.1 et suivantes: c'est dans les sources de fpc:
55	53
56	54		``` bash
57	55		svn co http://svn.freepascal.org/svn/fpc/trunk/utils/instantfpc instantfpc
58	56		```
59	57
60	58		Pour fpc 2.4.4 et 2.4.5:
61	59
62	60		``` bash
63	61		svn co https://lazarus-ccr.svn.sourceforge.net/svnroot/lazarus-ccr/applications/instantfpc instantfpc
64	62		```
65	63
66	64		# Installation
67	65
68	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.
69	67
70	68		1. Compilez le projet instantfpc.lpi avec Lazarus ou Lazbuild. Ou compilez-le directement avec fpc instantfpc.pas.
71	69		2. Placez l'exécutable dans un répertoire de votre PATH, par exemple /usr/bin:
72	70
73	71		``` bash
74	72		sudo cp instantfpc /usr/bin/
75	73		```
76	74
77	75		# Comment ça marche
78	76
79	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.
80	78
81	79		# Paramètres de instantfpc
82	80
83	81		- -h: Affiche l'aide et se termine
84	82		- -v: Affiche la version courante et se termine.\>
85	83		- --get-cache: Affiche le répertoire cache courant et se termine.
86	84		- --set-cache=\<directory\>: Définit le cache courant.
87	85		- -B: force la compilation même si le programme en cache est valide.
88	86		- --compiler=\<path to compiler\> utilise ce compilateur. Par défaut, fpc est recherché dans le PATH.
89	87		- --skip-run: N'exécute pas le programme. Utile pour tester si le script compile. Meilleur si combiné avec -B.
90	88		- Variable d'environnement INSTANTFPCCACHE: Définit le répertoire du cache. L'option --get-cache peut surcharger ceci.
91	89		- Variable d'environnement INSTANTFPCOPTIONS: Les options à passer au compilateur, passées avant les paramètres de la ligne de commande.
92	90
93	91		# Passage de paramètres au compilateur
94	92
95	93		Les paramètres du compilateur peuvent être passés dans la ligne shebang. Remarque: vous ne pouvez pas utiliser la commande 'env'.
96	94
97	95		``` pascal
98	96		#!/usr/bin/instantfpc -O1 -Ci
99	97		begin
100	98		end.
101	99		```
102	100
103	101		Et/Ou vous pouvez placer les options du compilateur dans la variable d'environnement INSTANTFPCOPTIONS:
104	102
105	103		``` bash
106	104		export INSTANTFPCOPTIONS="-Fu~/lazarus/components/codetools/units/x86_64-linux/"
107	105		```
108	106
109	107		``` pascal
110	108		#!/usr/bin/instantfpc
111	109		uses FileProcs; // unit FileProcs is in codetools
112	110		begin
113	111		end.
114	112		```
115	113
116	114		# Exemple
117	115
118	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:
119	117
120	118		``` pascal
121	119		#!/usr/bin/env instantfpc
122	120		uses
123	121		SysUtils;
124	122		var
125	123		theWord: String;
126	124		begin
127	125		if ParamStr(1) = '' then
128	126		begin
129	127		write('SVP, entrez le mot à "numéronymiser": ');
130	128		readln(theWord);
131	129		end
132	130		else
133	131		theWord := ParamStr(1);
134	132		if length(theWord) > 2 then
135	133		writeln(theWord[1] + IntToStr(length(theWord)-2) + theWord[length(theWord)])
136	134		else
137	135		writeln('N/A');
138	136		end.
139	137		```
140	138
141	139		# Usage avec Lazarus
142	140
143	141		Depuis Lazarus 0.9.31, l'EDI ignore la ligne shebang. Vous obtenez toutes les caractéristiques normal du code.
144	142
145	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.
146	144
147	145		## Compiler dans Lazarus
148	146
149	147		Comment convertir un projet Lazarus pour le compiler avec instantfpc:
150	148
151	149		Requiert:
152	150
153	151		- Le source principal du projet Lazarus est le programme instantfpc.
154	152
155	153		Réglage:
156	154
157	155		- Aller vers Projet / Options du projet / Compiler commands / Compilation
158	156		- Désactivez tout les cases à cocher Appel sur pour Compiler
159	157		- Définissez dans Exécuter avant la Commande en:
160	158
161	159		``` bash
162	160		instantfpc --skip-run -B -gl "-Fu$(ProjUnitPath)" $Name($(ProjFile))
163	161		```
164	162
165	163		- Activez les cases à cocher des scan make et fpc
166	164
167	165		Remarques:
168	166
169	167		- L'option -gl demande à FPC de compiler avec les informations de débogage
170	168		- L'option --skip-run -B compile sans exécuter après.
171	169		- Voir [[IDE Macros in paths and filenames\|IDE Macros]]
172	170
173	171		## Débogage avec Lazarus
174	172
175	173		Comment convertir un projet Lazarus pour déboguer un programme instantfpc:
176	174
177	175		Requiert:
178	176
179	177		- Ci dessus Compiler dans Lazarus
180	178
181	179		Réglages:
182	180
183	181		- Aller vers Exécuter / Paramètres d'exécution
184	182		- Définissez Local / Application hôte vers \$(InstantFPCCache)/\$NameOnly(\$(ProjFile))
185	183		- Definissez Répertoire de travail vers \$(ProjPath)
186	184
187	185		# Usage dans Apache
188	186
189	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).
190	188
191	189		``` bash
192	190		mkdir /var/apacheinstantfpc
193	191		chown www-data.www-data /var/apacheinstantfpc
194	192		```
195	193
196	194		Passez une variable d'environnement pour les script CGI en ajoutant la ligne suivante dans les configs Apache:
197	195
198	196		`SetEnv INSTANTFPCCACHE /var/apacheinstantfpc`
199	197
200	198		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.
201	199
202	200		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.
203	201
204	202		## Exemple Apache montrant env
205	203
206	204		Configurer un répertoire pour exécuter les scripts cgi. P.ex.:
207	205
208	206		ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
209	207		<Directory "/usr/lib/cgi-bin">
210	208		AllowOverride None
211	209		Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch
212	210		Order allow,deny
213	211		Allow from all
214	212		SetEnv INSTANTFPCCACHE /var/apacheinstantfpc
215	213		# You can put fpc options into /etdc/fpc.cfg or here:
216	214		#SetEnv INSTANTFPCOPTIONS -Fu/path/to/somevar/ppufiles
217	215
218	216		# If this is root directory, you might have to set:
219	217		#Require all granted
220	218		</Directory>
221	219
222	220		Si votre Apache n'a pas encore activé le module cgi:
223	221
224	222		`a2enmod cgi`
225	223
226	224		Placez le script suivant dans /usr/lib/cgi-bin/showenv.pas:
227	225
228	226		``` pascal
229	227		#!/usr/bin/instantfpc
230	228		{$mode objfpc}{$H+}
231	229		uses SysUtils;
232	230		var i: Integer;
233	231		begin
234	232		writeln('Content-type: text/html');
235	233		writeln;
236	234		writeln('<HTML><BODY>');
237	235		for i:=0 to Paramcount do
238	236		writeln('Param ',i,' ',ParamStr(i),'<br>');
239	237		for i:=1 to GetEnvironmentVariableCount do
240	238		writeln('Env ',GetEnvironmentString(i),'<br>');
241	239		writeln('</BODY></HTML>');
242	240		end.
243	241		```
244	242
245	243		# Bugs / A faire / Limitations
246	244
247	245		- 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).
248	246		- Sous Windows, seul le premier paramètre est passé au script.
249	247		- 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.
250	248		- 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.
251	249
252	250		# Alternatives
253	251
254	252		L'astuce suivante marche en utilisant le shell bash. Placez le programme dans le fichier fpc_script.sh:
255	253
256	254		``` pascal
257	255		// 2>/dev/null; fpc fpc_script.pp &> build.log && exec ./fpc_script "$@" \|\| cat build.log; exit
258	256		begin
259	257		writeln('');
260	258		end.
261	259		```
262	260
263	261		---
264	262		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