Voorbereiden van jouw Symfony project

Wat moet je doen om Symfony te laten werken?

Symfony heeft een aantal basis onderdelen nodig die je moet installeren. In deze handleiding gaan we in op de installatie van Windows en Apple computers (laptop of desktop). We gaan er ook vanuit dat jij zelf vaardig genoeg bent om deze installaties te doorlopen/ regelen. Meer informatie kan je, in het Engels, vinden op de Symfony documentatie pagina's (https://symfony.com/doc/current)

Wat moet je installeren?

Je hebt de volgende onderdelen nodig op jouw computer om te werken met Symfony:

  • PHP versie 8.2 of hoger (voor Symfony 6.4 of hoger)
  • Composer
Daarnaast kan het handig zijn om een van de volgende onderdelen ook te installeren, dit maakt jouw werk een stuk makkelijker:
  • PHPMyAdmin
  • Symfony-CLI
  • Git versiebeheer

Windows installatie

In deze sectie leggen we je uit hoe je alles onder Windows kan installeren of waar je het kan vinden.

PHP en XAMPP

Onder Windows is het makkelijskte om PHP te installeren vanuit een programma dat heet XAMPP. Deze kan je downloaden op de pagina van Apache Friends. Download de meest recente versie (de PHP versie moet dan minimaal 8.2 zijn) van XAMPP.
XAMPP
X - Cross-platform, het is voor Windows, Linux en MacOS machines
A - Apache, een webserver om je applicatie te tonen
M - MySQL/MariaDB, een database programma waarvan de sub-versie MariaDB heet
P - PHP, de programmeer taal die wij gebruiken
P - Python/ Perl, andere programmeertalen die je kan gebruiken

Ondanks dat XAMPP, of versies zoals WAMP, LAMP & MAMP, ook op Linux en MacOS werken raden wij het gebruik van deze tool alleen onder Windows aan. Voor de basis van Symfony heb je uit deze installatie alleen de PHP programmeertaal en de database MySQL/ MariaDB nodig.

Composer

Composer is een programma welke met PHP werkt, deze kan je dus ook pas installeren als PHP/ XAMP goed geinstalleerd is. Met composer kan je PHP-pakketjes installeren die door anderen gemaakt zijn. Deze maken je werk vaak een stuk makkelijker. Zo een pakketje kan bijvoorbeeld een integratie met het betaalplatform van Mollie zijn, of om Excel bestanden te uploaden en te verwerken. Symfony maakt gebruik van veel van dit soort pakketjes.
Ook hiervoor geldt dat er een basis installatie programma is die je kan downloaden en installeren.
Deze vind je op de GetComposer website.
Download de Windows installatie (direct bovenaan, genaamd Composer-Setup.exe.

Symfony CLI

CLI staat voor Command Line Interface. Een duur woord voor het gebruik van je terminal of DOS-box/ command-prompt in Windows. (of Linux/ MacOS terminal). Met de Symfony CLI kan je in je terminal (ook in PHPStorm beschikbaar) makkelijk commando's uitvoeren via het commando: 

symfony <commando> <opties>

Scoop

Als eerste heb je een hulp programma nodig genaamd Scoop. Meer informatie en de meest recente installatie handleiding vind je op scoop.sh. Scoop is een hulp programma voor diverse installatie pakketten zoals Symfony CLI.
Als eerste moet je in Windows een Powershell terminal openen en dan voer je de volgende twee commando's in die Powershell terminal uit: 

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

Synmfony CLI (met Scoop)

Als Scoop geinstalleerd is kan je vervolgens de Symfony CLI installeren met het volgende commando: 

scoop install symfony-cli
Je kan daarna testen of het werkt met het commando: 
symfony -v
LET OP: als dit niet werkt moet je jouw Powershell terminal afsluiten en opnieuw openen. Probeer het dan nog eens.