2. Een werkomgeving installeren

De scripts zijn geschreven en getest in de volgende omgeving:

een Apache-webserveromgeving / SGBD MySQL / PHP 7.3, genaamd Laragon;
de NetBeans 10.0-ontwikkelomgeving IDE;

2.1. Installatie van Laragon

Laragon is een pakket dat verschillende programma’s bevat:

een Apache-webserver. Deze zullen we gebruiken voor het schrijven van webscripts in PHP;
de SGBD MySQL;
de scripttaal PHP;
een Redis-server die een cache voor webapplicaties implementeert:

Laragon kan (maart 2019) worden gedownload via de volgende link:

https://laragon.org/download/

De installatie [1-5] resulteert in de volgende mapstructuur:

in [6] de installatiemap van PHP;

Bij het starten van [Laragon] verschijnt het volgende venster:

[1]: het hoofdmenu van Laragon;
[2]: de knop [Start All] start de Apache-webserver en de SGBD MySQL;
[3]: de knop [WEB] geeft de webpagina [http://localhost] weer, die overeenkomt met het bestand PHP [<laragon>/www/index.php], waarbij <laragon> de installatiemap van Laragon is;
[4]: met de knop [Database] kunt u de SGBD en MySQL beheren met de tool [phpMyAdmin]. Deze moet eerst worden geïnstalleerd;
[5]: de knop [Terminal] opent een opdrachtprompt;
[6]: de knop [Root] opent Windows Verkenner, waarbij de map [<laragon>/www] is geselecteerd, de hoofdmap van de website [http://localhost]. Hier moeten alle webapplicaties worden geplaatst die door de Apache-server van Laragon worden beheerd;

Laten we een Laragon-terminal [5] openen:

in [1], het type terminal. Er zijn drie soorten terminals beschikbaar in [6];
in [2, 3]: de huidige map;
in [4] voert u het commando [echo %PATH%] in, dat de lijst weergeeft van mappen die worden doorzocht bij het zoeken naar een uitvoerbaar bestand. Alle belangrijke mappen van Laragon zijn opgenomen in dit pad naar de uitvoerbare bestanden, wat niet het geval zou zijn als men een opdrachtvenster [cmd] in Windows zou openen. Wanneer in dit document opdrachten moeten worden ingevoerd om bepaalde software te installeren, gebeurt dit doorgaans in een Laragon-terminal;

2.2. Installatie van IDE NetBeans 10.0

IDE NetBeans 10.0 kan worden gedownload via de volgende link (maart 2019):

https://netbeans.apache.org/download/index.HTML

Het gedownloade bestand is een zip-bestand dat je gewoon hoeft uit te pakken. Zodra NetBeans is geïnstalleerd en gestart, kun je een eerste project PHP aanmaken.

in [1], kies je de optie File / New Project;
in [2], kies je de categorie [PHP];
in [3], kies het projecttype [PHP Application];

in [4], geef het project een naam;
in [5], kies een map voor het project;
in [6], kies de gedownloade versie van PHP;
in [7], de codering UTF-8 voor de bestanden PHP kiezen;
in [8] de modus [Script] kiezen om de scripts PHP in de opdrachtregelmodus uit te voeren. Kies [Local WEB Server] om een script PHP in een webomgeving uit te voeren;
in [9,10] de installatiemap van de PHP-interpreter uit het Laragon-pakket opgeven:

kies [Finish] om de wizard voor het aanmaken van het project PHP af te ronden;

in [11] wordt het project aangemaakt met een script [index.php];
in [12] wordt een minimaal script PHP geschreven;
in [13] wordt [index.php] uitgevoerd;

in [14] verschijnen de resultaten in het venster [output] van NetBeans;
in [15] wordt een nieuw script aangemaakt;
in [16], het nieuwe script;

De lezer kan alle volgende scripts aanmaken in verschillende mappen van hetzelfde project PHP. De broncodes van de scripts in dit document zijn beschikbaar in de vorm van de volgende NetBeans-boomstructuur:

De scripts in dit document zijn ondergebracht in de projectstructuur van het project [scripts-console] [1]. We zullen ook gebruikmaken van bibliotheken uit PHP, die worden geplaatst in de map [<laragon-lite>/www/vendor] [2], waarbij <laragon-lite> de installatiemap van de Laragon-software is. Om ervoor te zorgen dat NetBeans de bibliotheken van [2] herkent als onderdeel van het project [scripts-console], moeten we de mappen [vendor] en [2] opnemen in de tak [Include Path] en [3] van het project. We gaan NetBeans zo configureren dat de map [<laragon-lite>/www/vendor] [2] wordt opgenomen in elk nieuw project PHP en niet alleen in het project [scripts-console]:

in [1-2] gaan we naar de opties van NetBeans;
in [3-4] configureer je de opties van PHP;
in [5-7] configureer je [Global Include Path] vanuit PHP: de mappen die in [7] worden vermeld, worden automatisch opgenomen in [Include Path] van elk project PHP;

in [9] krijgt men toegang tot de eigenschappen van de branch [Include Path];
in [10-11] worden de nieuwe bibliotheken door NetBeans gescand. NetBeans scant de code PHP van deze bibliotheken en slaat hun klassen, interfaces, functies enz. op om de ontwikkelaar hulp te kunnen bieden;

in [12] maakt een stuk code gebruik van de klasse [PhpMimeMailParser\Parser] uit de bibliotheek [vendor/php-mime-mail-parser];
in [13] stelt NetBeans de methoden van deze klasse voor;
in [14-15] geeft NetBeans de documentatie van de geselecteerde methode weer;

Het begrip [Include Path] is hier specifiek voor NetBeans. PHP kent dit begrip ook, maar het gaat hier a priori om twee verschillende begrippen.

Nu de werkomgeving is geïnstalleerd, kunnen we de basisbeginselen van PHP bespreken.