7. Kommentarer - Hjælp til programmøren

Du er her: StartIndholdsfortegnelse → Kommentarer - Hjælp til programmøren
Indhold

Indledning

Kommentarer i PHP er en hjælp til dig selv i din egenskab af "programmør".

Du bruger kommentarer til at indsætte små bemærkninger i din kode, der kan hjælpe dig, når du senere vender tilbage og skal rette i koden.

Der er 2 typer kommentarer du har brug for at lære:

Kommentar på èn linie

Kommentarer på én linie bruges til ganske korte kommentarer (siger vel egentlig sig selv).

Syntaks:

<?
//Dette er en kommentar
?>

Altså bare to skrå streger: //. Kommentarer skal altid være indenfor PHP-koderne (dvs. <? og ?> ).

Eksempel 1:

Her følger et eksempel på praktisk brug af en kort kommentar:

<?
$visnavn = $_GET['navn']; //hent formularfeltet navn 
echo $visnavn; 
echo "</p>"; //slut på afsnit
?>

I det første eksempel (//hent formularfeltet navn) handler kommentaren om, at $navn kommer fra formularen på foregående side.

I det næste eksempel (//slut på afsnit) handler kommentaren om, hvorfor jeg skal huske </p>.

Eksempel 2:

Kommentarer kan også bruges til at indsætte "grafisk tegn" til at opdele koden med:

<?
//start-------------------------------
$visnavn = $_GET['navn']; 
echo $visnavn; 
echo "</p>"; 
//slut--------------------------------
?>

Kommentar over flere linier

Hvis du har brug for at skrive længere kommentarer så skal du bruge en lidt anden form:

Syntaks:

<?
/* Her er en kommentar, der strækker sig
over flere linier. 
Man kan selv bestemme, hvor mange. */
?>

Altså en streg og en stjerne til start og en stjerne og en streg til slut:
/*   */

Eksempel 3:

Kommentarer over flere linier bliver ofte brugt til at angive, hvem der har skrevet koden:

<?
/*
Denne applikation er skrevet af:
Lars Christensen
PC-vænget 23
2860 Søborg
Du er velkommen til at bruge koden, 
men slet ikke denne kommentar.
*/
?>

Eksempel 4:

Selvfølgelig kan kommentarer over flere linier også bruges til at kommentere nede i selve koden:

<?
/* navn stammer fra formularen
på foregående side */
$visnavn = $_GET['navn']; 
echo $visnavn; 
echo "</p>"; 
/* husk at afslutte afsnittet, 
før koden fortsætter */
?>

Øvelse 7.1

  1. Hent nogle af de opgaver, du har lavet tidligere og indsæt passende kommentarer. Brug 1-linies og fler-liniers kommentarer.