1. Inleiding 2. php.net how to use 3. php.net how to understand 4. PHP5 functies, wat nu? top1. Inleiding
Je kent het wel. De allombekende situatie op het forum waar een lid een probleem heeft en liever lui is dan moe.
Deze persoon stelt een vraag betreffende een onderwerp waar google binnen de twee minuten antwoord op kan geven.
Een leuk voorbeeld hiervan is: "Wat zijn de parameters voor deze functie: 'count'?".
Een vraag die heel gemakellijk op te lossen is via google.
Er is echter een site die noch sneller antwoord geeft op deze vraag, namelijk php.net.
Dus: mochten er nog van die 'obvious' vragen rond gestrooid worden op het forum, gooi dan gerust een link naar deze tutorial.
Als je hier bent beland door op een link te klikken als antwoord op jou vraag, gelieve deze kleine 'php.net-manual' even door te spitten. top2. php.net inleiding php.net is de 'hoofdsite' van PHP.
Hier staat onder andere informatie over php conferenties en mogelijke updates.
Dit is echter niet van belang bij het oplossen van basis problemen.
We nemen bovenstaand onderwerp ("Wat zijn de parameters voor deze functie: 'count'?") als voorbeeld.
Dit is namelijk heel simpel op te lossen. php.net is namelijk op zo'n manier gemaakt dat je enkel in de url je 'vraag' samengevat moet meegeven en de site geeft al een oplossing.
We willen iets weten over de functie 'count', we zouden in de function list kunnen zoeken of via bovenstaande functionaliteit werken.
We gaan gewoon naar: http://www.php.net/count.
Daar aangekomen vinden we een hele uitleg over de functie count. Onder andere:
int count ( mixed var [, int mode] )
Wat al die woorden ('int', 'mixed', 'var' en 'mode') bekenen leg ik strak uit.
Hierin kan je wel afleiden dat count 2 argumenten accepteert.
1 (var) is noodzakelijk (staat niet tussen [rechte haakjes]).
2 (mode) is niet noodzakelijk (staat tussen [rechte haakjes]).
Mocht je nu bv. een functie zoeken die betrekking heeft tot arrays.
Bv. een functie die een random element uit de array selecteert.
Dan zou je twee dingen kunnen doen:
- als een wilde iets rammen in de header en bij zoiets uitkomen: http://www.php.net/array_random_element en op de achtste plaats zijn functie tegenkomen.
- naar http://www.php.net/array gaan en daar de zoekfunctie (ctrl + f) van de browser gebruiken en het woord 'rand' zoeken.
Dan kom je op de pagina die de functie http://www.php.net/array_rand behandeld.
En dit is nu net de functie die je zoekt.
Hoe lees ik dit?
De functie count accepteert een variabele van eender welk type en stuurt een integer terug.
Het is mogelijk een mode in te stellen die dan invloed zal hebben op de integer die terug gestuurd wordt.
Dus het eerste woord (int) is het type dat de functie terugstuurt. Voorbeelden zijn:
array,
int,
string,
float,
number,
bool,...
Elke link leid naar een functie die het genoemde type terugstuurt.
Vervolgens is er de functienaam zelf (count).
Dan openen er de haakjes, hiertussen komen de argumenten.
mixed is een speciaal type, dit kan elk soort van variabele zijn (array, int, string, float, number, bool of NULL).
(even tussen haakjes, de functie stuurt in alle gevallen 1 of hoger terug behalve bij NULL (als de variabele NIET bestaat) stuurt het 0 terug)
Het woord 'var' staat voor variabele en betekend gewoon dat wat je invoert (zelfde als 'input').
Dan openen de [rechte haakjes] zich en komen er 'optionele waardes' die ik daarnet al heb besproken.
Dan is er nog een speciaal voorval.
Bv. getrandmax
Waarbij er geen argumenten worden meegegeven maar wel iets wordt teruggestuurd.
Dit is het type void wat dus 'leeg' betekend. Er wordt 'niets' meegegeven.
Een functie kan ook van het type void zijn als het niets terugstuurd maar (soms) wel output terugstuurd.
Een voorbeeld hiervan vind je hier.
Dan is er nog een speciaal soort 'argument', namelijk een argument dat geacepteerd word 'by reference'.
Dit klinkt allemaal heel theoretisch maar om het even van naderbij te bekijken nemen we de functie sort.
Daar zie je bij de functie omschrijving.
bool sort ( array &array [, int sort_flags] )
Wat kunnen we al direct zeggen: de functie sort stuurt een bool terug en heeft als argumenten een array en optioneel een integer.
Maar wat doet het 'en-teken' (&) nu voor de tweede keer 'array'.
Dit betekend dat de functie een array accepteert en deze array rechtstreeks veranderd.
De functie voert acties uit op de originele array en niet op een kopie hiervan.
Dus hoef je niet te doen '$array = sort($array);' maar 'sort($array)'.
De array wordt direct gesorteerd.
Meer over references vind je (je kan het al raden) hier: php.net/references.
Als laatste zijn er nog de language constructs (echo, print, include, require, ...).
Dit zijn geen functies en er moeten dus ook geen haakjes rond hun 'argumenten'.
Deze zijn praktisch altijd van het type void en sturen output (of acties) terug.
top4. PHP5 functies, wat nu?
Stel je draait PHP4 en je hebt een bepaalde functie nodig.
Om een voorbeeldje te geven: je wilt een functie die een array terugstuurt met alle bestanden en mappen binnen een bepaalde directory.
Je kan proberen deze functie zelf te schrijven, of even te zoeken op php.net.
Vervolgens kom je op php.net/scandir uit.
Bovenaan staat '(PHP 5)', dit betekend simpelweg dat deze functie vanaf PHP5 beschikbaar is.
Maar we hebben PHP4, wat nu?
Je zou natuurlijk kunnen updaten maar als je hosting bedrijf hier het nut niet van inziet kan je altijd de functie namaken.
OF je kan even op de pagina zelf rondkijken.
Onder de beschrijving en voorbeelden van de functie staan reacties van vrij tot zeer getalenteerde PHP-coders.
Het is altijd de moeite waart om hiertussen te kijken, want de 3e reactie geeft namelijk de oplossing voor het probleem.
Het is een functie die werkt op PHP4 die hetzelfde doet als scandir.
Dus, een tip: zoek altijd tussen de reacties. Hier staat meestal heel waardevolle commentaar.
Hopelijk heb je iets bijgeleerd van deze korte 'php.net-manual'.
Wat is jouw favoriete javascript framework? (S: 18, R: 2)
(4.58) 
Lees de nota's (0)