File: basic-syntax.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (169 lines) | stat: -rw-r--r-- 6,104 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
  <chapter id="language.basic-syntax">
   <title>La syntaxe de base</title>
   <sect1 id="language.basic-syntax.phpmode">
    <title>Le passage du HTML au PHP</title>
    <para>
     Lorsque PHP commence &agrave; traiter un fichier, il ne fait qu'afficher
     le texte HTML qu'il rencontre. Si vous renommez un fichier .html
     en .php, il s'affichera exactement comme avant.
    </para>
     <para>
      Si vous voulez ins&eacute;rer des commandes PHP dans votre fichier, vous
      devez indiquer &agrave; PHP le d&eacute;but d'une telle s&eacute;quence,
      en passant en mode PHP. Il y a quatre moyens pour passer du mode HTML au
      mode PHP :
    </para>
    <para>
     <example>
      <title>Le passage du HTML au PHP </title>
      <programlisting role="php">
1.  &lt;? echo ("Ceci est un exemple d'affichage &agrave; l'&eacute;cran en PHP, sous forme d'expression SGML.\n"); ?&gt;
    &lt;?= expression ?&gt;  Raccourci de "&lt;? echo expression ?&gt;"
2.  &lt;?php echo("Si vous voulez afficher du XML ou du XHTML, faites comme ceci.\n"); ?&gt;
3.  &lt;script language="php">
        echo ("Certains &eacute;diteurs HTML (comme FrontPage)
         n'acceptent pas les expressions telles que celle-ci.");
    &lt;/script>
4.  &lt;% echo ("Vous pouvez aussi utiliser le style ASP comme d&eacute;limiteur."); %>
    &lt;%= $variable; # ceci est un raccourci pour  "&lt;%%echo .." %&gt;
      </programlisting>
     </example>
    </para>
    <para>
     La deuxi&egrave;me m&eacute;thode est g&eacute;n&eacute;ralement utilis&eacute;e,
     car elle permet une impl&eacute;mentation ais&eacute;e de PHP avec la
     prochaine g&eacute;n&eacute;ration de XHTML.
    </para>
    <para>
     La premi&egrave;re possibilit&eacute; n'est valable que si vous
     l'avez activ&eacute;e. Soit en faisant appel &agrave; la fonction
     short_tags() (NdT : semble avoir disparu), soit en utilisant l'option
     d'ex&eacute;cution <link linkend="ini.short-open-tag">short_open_tag</link>
     dans le fichier de configuration, soit en utilisant l'option de
     compilation <link linkend="install.configure.disable-short-tags">--enable-short-tags</link>.
    </para>
    <para>
     La quatri&egrave;me possibilit&eacute; est seulement disponible
     si vous l'avez activ&eacute;e en utilisant soit l'option
     d'ex&eacute;cution <link linkend="ini.asp-tags">asp_tags</link>,
     soit en utilisant l'option de compilation --enable-asp-tags.
    <note>
     <para>
      Le support de la quatri&egrave;me possibilit&eacute;,
      ASP-style, a &eacute;t&eacute; ajout&eacute; dans la
      version 3.0.4.
     </para>
    </note>
   </para>
   <para>
    La marque de fermeture d'un bloc (?&gt;) comprend la nouvelle
    ligne suivante, s'il y en a une.
    </para>
    <para> <!-- TODO: find a better place for this para -->
     PHP vous permet d'utiliser des structures telles que :
     <example>
      <title>M&eacute;thode avanc&eacute;e</title>
      <programlisting role="php">
&lt;?php
  if ( expression-bool&eacute;enne ) {
?&gt;
  &lt;strong&gt;Ceci est vrai.&lt;/strong&gt;
&lt;?php
  } else {
?&gt;
&lt;strong&gt;Ceci est faux.&lt;/strong&gt;
&lt;?php
  }
?&gt;
     </programlisting>
    </example>
     Cela fonctionne comme on peut s'y attendre, car PHP traite le texte
     entre ?&gt; et &lt;?php comme une fonction <function>echo</function>,
     sans remplacer les variables &eacute;ventuelles par leur valeur.
    </para>
   </sect1>
   <sect1 id="language.basic-syntax.instruction-separation">
    <title>Le s&eacute;parateur d'instruction</title>
    <simpara>
     Les instructions sont s&eacute;par&eacute;es par un point virgule &agrave; 
     chaque fin d'instruction, comme en langage C ou en Perl.
    </simpara>
    <para>
     La balise de fin (?&gt;) implique la fin d'un instruction, et donc
     ajoute implicitement un point virgule. Les deux exemples suivants
     sont &eacute;quivalents.
     <informalexample>
      <programlisting role="php">
&lt;?php
    echo "Ceci est un test";
?&gt;
&lt;?php echo "Ceci est un test" ?&gt;
      </programlisting>
     </informalexample>
     </para>
     </sect1>
   <sect1 id="language.basic-syntax.comments">
    <title>Commentaires</title>
    <para>
     Le PHP supporte les commentaires comme en C, C++ et Shell Unix. Par exemple:
     <informalexample>
      <programlisting role="php">
&lt;?php
    echo "Ceci est un test"; // Ceci est un commentaire sur une ligne comme en C++
    /* Ceci est un commentaire sur plusieurs lignes,
       comme en C et C++  */
    echo "Ceci est encore un test";
    echo "Enfin, le test final"; # Ceci est un commentaire comme en Shell Unix
?&gt;
      </programlisting>
     </informalexample>
    </para>
    <simpara>
     Le premier type de commentaire ne commente que jusqu'&agrave; la
     fin de la ligne ou bien jusqu'&agrave; la fin du bloc, cela
     d&eacute;pend du premier rencontr&eacute;.
    </simpara>
    <informalexample>
     <programlisting role="php">
&lt;h1>Ceci est un &lt;?php echo "simple";?&gt; exemple.&lt;/h1>
&lt;p>
     </programlisting>
    </informalexample>
    <simpara>
     La ligne du dessus affichera 'Ceci est un simple exemple'.
    </simpara>
    <simpara>
     Faites attention &agrave; ne pas embo&icirc;ter les
     commentaires de type 'C', ce qui arrive de temps en temps
     lorsque vous voulez commenter une grande partie de code.
    </simpara>
    <informalexample>
     <programlisting role="php">
&lt;?php
 /*
    echo "Ceci est un test"; /* Ce commentaire va poser un probl&egrave;me */
 */
?&gt;
    </programlisting>
   </informalexample>
  </sect1>
  </chapter>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
 sgml-omittag:t
 sgml-shorttag:t
 sgml-minimize-attributes:nil
 sgml-always-quote-attributes:t
 sgml-indent-step:1
 sgml-indent-data:t
indent-tabs-mode:nil
 sgml-parent-document:nil
 sgml-default-dtd-file:"../manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil
 End:
 -->