Tutorials

Net en Overzichtelijk programmeren

Een tutorial over netjes en overzichtelijk programmeren in PHP

Pagina 1

Inleiding

Hallo allemaal!

Naar aanleiding van de tutorial over dubbele en enkele quotes, heb ik besloten om maar een uitgebreide tutorial te schrijven over netjes en overzichtelijk programmeren.

Voor de mensen die al langere tijd programmeren, zal dit al wel vrij bekend zijn, maar misschien hebben jullie nog wel op- en aanmerkingen hier over, om dit alsnog te kunnen verbeteren.

Ik ben mij ervan bewust dat er in 2003 al een tut is geschreven door ene Bas Kregeler (never heard of), Maar ik vond die vrij beknopt, en toch zal ik daar wat uit gaan herhalen.

Dan maar even over wat ik allemaal te vertellen heb in deze tutorial over netjes en overzichtelijk programmeren.
Ik wou beginnen met het inspringen, dit omdat dit eigenlijk een beetje de basis is van het overzichtelijke programmeren.
Daarna zal er een stukje over comments in je script, zodat jezelf en andere makkelijk dingen kunnen terug vinden.
En dan komt het gedeelte over quotes, niet alleen het gebruik van dubbele of enkele, maar ook het buiten de quotes halen.
Daarna wou ik nog wat dingen afsluiten, hierin zullen kleine dingen in naar voren komen, van een paar regels, die nog wel handig zijn voor het programmeren.

Na dit alles zal ik nog een korte conclusie schrijven.

Veel plezier bij het lezen van de rest van de tutorial!!
Pagina 2

Quotes

Dit stuk schrijf ik eigenlijk naar aanleiding van de andere tut die net op phphulp stond.
Hierin stond het één en ander over het gebruiken van enkele en dubbele quotes.

Om maar eens met de php technische kant te beginnen, zal ik het eerst hebben over het verschil van de output.
Alles wat binnen enkele quotes staat word letterlijk weergeven.
Dit betekent dus dat ook variablen en php functies worden weergeven.

<?php
	$variable = "variable";
	Echo 'Dit is een $variable';
?>

Geeft als output:
Dit is een $variable

Zou je dubbele quotes gebruiken.
<?php
$variable = "Vastgestelde variable ";
Echo "Dit is een $variable";
?>
[/code]
Dan word de output:
Dit is een Vastgestelde variable

Ook de \n functie kan niet worden gebruikt in enkele quotes.
Dan zijn er nog een aantal kleine dingen waarop je moet letten, zoals dat je een US $ binnen enkele quotes moet weergeven, omdat hij anders naar een variable gaat zoeken.

Dit eenmaal gezegd te hebben, en het deel van variablen binnen de quotes zijn vergeten.
Gaan we variablen buiten quotes halen, omdat dit gewoon netter en overzichtelijker is.
Waarom??
Kasper
Variabelen buiten quotes halen werkt veiliger, sneller en geeft minder kans op fouten.

En het is overzichtelijker

Hoe werkt het dan,

Iedere keer dat je een variable in een echo gebruikt, moet je voor het gebruiken van vastgestelde tekst openen of sluiten met een “.”.
Ook als je twee variablen achter elkaar gebruikt, moet je die scheiden met een “.”.
Hier een aantal voorbeelden voor het buiten de quotes halen van variablen.

<?php
	$voornaam = "Nico";
	$achternaam = "Kaag";
	// Alleen een variable achter de quotes
	Echo 'Uw voornaam is '. $voornaam;
	
	// Alleen variable voor de quotes
	Echo $voornaam .' is uw voornaam!';

	// 2 variablen naast elkaar
	Echo 'Uw naam is '. $voornaam . $achternaam;
	// Let Op!! Hier zit nog geen spatie tussen!!

	// Variablen tussen quotes
	Echo 'Uw voornaam is '. $voornaam .', en uw achternaam is '. $achternaam;
	// Let op de spaties voor het sluiten van de quote, zodat er daar wel een spatie komt.
?>


Nu hebben we dus een beetje de php technische kant gehad, en de netheid ermee verbonden.
Dan wil ik jullie nu nog een klein beetje over de snelheid inlichten.

Ik ga hier geen uitgebreid punt van maken, omdat dit al voor mij is gedaan.
Daarom een link naar een site waar het snelheids verschil tussen dubbele- en enkele quotes word onderzocht.
KlikerDeKlik

Hieruit blijkt dus dat enkele quotes sneller zijn.
(resultaten vind je dus op de site.)
Pagina 3

Inspringen

Het eerste wat ik dacht toen ik dit hoorde was, waarom zou ik inspringen, kost toch alleen maar tijd en energie!!
Maar toen ik eenmaal wat uitgebreidere en complexere scripts ging maken, toen zag ik door de letters de code niet meer.

Dus hoe werkt het.
Je begint, zoals in de meeste scripts, met het openen van de script tags,
In ons geval:

<?php
?>


Dit zullen we allemaal wel kennen, maar hier worden we niks wijzer van.
Je kan nu 2 dingen doen.
Je kan Iedere regel code alvast gaan inspringen.
Dan krijg je dus:

<?php
	echo "Dit is al vanaf het begin met in Tab ingesprongen";
	echo "En dat blijf je dan doen";
?>

(Dit kan eventueel ook met alleen een spatie).

En de tweede mogelijkheid is om bij het begin helemaal nog niet in te springen.
Dan krijg je dus de volgende code:

<?php
echo "Dit is al vanaf het begin met in Tab ingesprongen";
echo "En dat blijf je dan doen";
?>


Dit is op zich niet zo heel overzichtelijk, maar dit is nog prima te doen, tenzij je met grote regelmaat php moet openen en sluiten, dan raad ik toch echt het inspringen aan.


Dan heb je dus het begin gehad, maar je kan nog op veel meer momenten inspringen.
Zodra je je script iets laat uitvoeren op een bepaalde conditie, dan is moet er worden ingesprongen.
Zonder inspringen zou een code met if en else statements, lussen, en al dat soort dingen heel onoverzichtelijk worden, zoals dit:

<?php
while($var1 == $var2)
{
if($var3)
{
if($var4)
{
foreach($var5 AS $var6 => $var7)
{
echo "Wousers";
}
}
}
elseif(!$var3)
{
echo "Dan toch niet";
}	
else
{
echo "Nog meer voorbeeld onzin";
}
}
?>


Bij deze code zie ik niet direct welke { bij welke } hoort, en waar welk if en else word afgesloten.

Maar als ik nou eens na het openen van { even inspring, hoe ziet het er dan uit?


<?php
	while($var1 == $var2)
	{
		if($var3)
		{
			if($var4)
			{
				foreach($var5 AS $var6 => $var7)
				{
					echo "Wousers";
				}
			}
			else
			{
				echo "Var4 bestaat niet?";
			}
		}
		elseif(!$var3)
		{
			echo "Dan toch niet";
		}	
		else
		{
			echo "Nog meer voorbeeld onzin";
		}
	}
?>


Blijkbaar zo dus.
Het is nu heel makkelijk te zien wat waar begint en eindigt.
Je ziet dat de { } van de while loop op één verticale lijn staan, wat betekent dat ze bij elkaar horen.
Hierdoor kan je ook heel makkelijk zien of je iets bent vergeten af te sluiten.
Als er geen } staat voordat je op dat stuk een nieuw statement gebruikt, weet je dat hij daar niet is afgesloten.
Pagina 4

Afronding

Nou, dit was dus mijn tutorial over net en overzichtelijk programmeren.

Ik heb nog één linkje die ik met iedereen wil delen, zodat de wat oudere scripts, die nog niet overzichtelijk zijn geprogrameerd, in één keer netjes worden gezet, zonder daar iets voor te doen.
Namelijk de PHP Beautifier

Ik hoop dat het voor iedereen duidelijk is, en dat iedereen hier wat aan heeft gehad.
Voor alle op en aanmerkingen mag je gewoon reacties posten, en dan zal ik kijken wat ik eraan kan doen.

Mijn laatste wens is dat iedereen nu het nut inziet van netjes en overzichtelijk programeren.
En dat mijn stukje over quotes wat beter was als de andere ;)

Prettige dag nog,
En misschien tot ziens.
Pagina 5

Comments

Zoals ik hiervoor ook al heb gedaan, weer een korte inleiding over het waarom van comments.

Eigenlijk is het heel simpel.
Heb je een lap code van pakweg 600 regels, dan weet je niet precies waar wat gebeurt.
Heb je nergens comments geplaatst, dan mag je iedere regel doorlezen om te kijken wat je precies gebeurt.
Als je er comments bijzet, dan is dat verleden tijd, en hoef je alleen maar comments door te spitten.

Je hebt in php drie mogelijkheden tot comments.
Je hebt 2 mogelijkheden voor line comments.
Je kan:

<?php
# Dit is een comment met een hekje
echo "Hier weer code."; 
// Dit is een comment met een dubbele slash.
Echo "En hier weer code.";
?>


Dit is dus een manier om hele korte comments in je script te plaatsen.
Dit gebruik ik zelf vaak om een if of while van comments te voorzien.
Om bijvoorbeeld via een if te kijken of een gebruiker is ingelogd, kan je je code zo commenten:

<?php
// Kijken of bezoeker is ingelogd
	if($_SESSION['loggedin'])
	{
		//Gebruiker is ingelogd
	}
?>


Als je grotere stukken tekst nodig hebt, dan kan je gebruik maken van block comments.

<?php
	/**
	 * Zo worden alle regels in dit blok genegeerd door php, zodat je ze alleen zelf kan lezen, zonder dat er iets gebeurt.
	 * Je kan eventueel, iedere nieuwe regel beginnen met een *, dat is niet nodig, maar wel wat overzichtelijker.
	 * Het afsluiten gaat als volgt.
   	*/
echo "Hier weer code."; 
?>


Dit is vooral handig wanneer je langere ingewikkelde code maakt, die uiteindelijk maar één doel heeft.
Je kan bijvoorbeeld, als je een plaatje wilt verkleinen, eerst in een block comment opschrijven wat je gaat doen, en het daarna in een keer uitschrijven, zonder verdere comments.

Reacties

0
Nog geen reacties.