Jouw werkomgeving controleren
Voordat je aan het project begint, is het belangrijk dat je controleert of je een goede werkomgeving hebt. De beschikbare ontwikkeltools zijn de laatste jaren sterk geëvolueerd en zien er vandaag de dag heel anders uit dan 10 jaar geleden. Het zou zonde zijn om dit niet ten volle te benutten. Goede tools kunnen je een heel eind op weg helpen.
Sla deze stap alsjeblieft niet over. Of lees in ieder geval het laatste deel over de Symfony CLI.
Een computer
Je hebt een computer nodig. Het goede nieuws is dat elk populair OS gebruikt kan worden: macOS, Windows of Linux. Symfony, en alle hulpmiddelen die we gaan gebruiken, zijn hier allemaal compatibel mee.
Uitgesproken keuzes
Ik wil snel handelen met de beste opties die er zijn. Ik heb voor dit boek uitgesproken keuzes gemaakt.
PostgreSQL wordt onze keuze voor alles: van database tot queues, van cache tot het opslaan van sessies. Voor de meeste projecten is PostgreSQL de beste optie. Het schaalt goed en houdt de infrastructuur eenvoudig door het bijhouden van 1 enkele service.
Aan het einde van het boek leren we om RabbitMQ te gebruiken voor queues en Redis voor sessies.
IDE
Je kan Notepad gebruiken als je dat wilt. Ik zou het echter niet aanraden.
Ik werkte vroeger met Textmate. Nu niet meer. Het comfort van het gebruik van een "echte" IDE is van onschatbare waarde. Automatisch code aanvullen, use statements toevoegen, het automatisch sorteren daarvan en van het ene bestand naar het andere springen zijn een paar functies die je productiviteit zullen verhogen.
Ik zou aanraden om Visual Studio Code of PhpStorm te gebruiken. De eerste is gratis, de tweede niet, maar PhpStorm heeft een betere integratie met Symfony (dankzij de Symfony Support Plugin ). Het is uiteindelijk aan jou. Je wilt vast weten welke IDE ik gebruik. Ik schrijf dit boek in Visual Studio Code.
Terminal
We zullen de hele tijd van de IDE naar de command line overschakelen. Je kan de ingebouwde terminal van jouw IDE gebruiken, maar ik geef de voorkeur aan een echte terminal om meer ruimte te hebben.
Linux wordt geleverd met ingebouwde Terminal. Gebruik iTerm2 op macOS. Op Windows werkt Hyper goed.
Git
Voor versiebeheer zullen we gebruik maken van Git, aangezien iedereen dit tegenwoordig gebruikt.
Op Windows, installeer Git bash.
Zorg ervoor dat je weet hoe je de alledaagse operaties zoals git clone, git log, git show, git diff, git checkout moet uitvoeren.
PHP
We zullen Docker gebruiken voor services, maar ik heb PHP graag op mijn lokale computer geïnstalleerd vanwege snelheid, stabiliteit en eenvoud. Het kan oubollig overkomen, maar de combinatie van een lokale PHP-installatie en Docker services werkt voor mij perfect.
Gebruik PHP 8.1 en controleer of de volgende PHP extensions geïnstalleerd zijn, of installeer ze nu: intl, pdo_pgsql, xsl, amqp, gd, openssl en sodium. Installeer optioneel ook de redis, curl en zip extensies.
Je kunt controleren welke extensies momenteel ingeschakeld zijn door php -m uit te voeren.
We ook hebben php-fpm nodig als jouw platform dit ondersteunt, maar php-cgi werkt net zo goed.
Composer
Het beheren van dependencies is tegenwoordig essentieel voor een Symfony-project. Download de nieuwste versie van de package management tool voor PHP: Composer.
Als je niet bekend bent met Composer, neem dan even de tijd om erover te lezen.
Tip
Je hoeft niet de volledige commando's in te voeren. composer req doet hetzelfde als composer require en composer rem doet bijvoorbeeld hetzelfde als composer remove, ...
NodeJS
We schrijven weinig JavaScript code, maar we zullen JavaScript/NodeJS tools gebruiken om onze assets te beheren. Controleer dat je NodeJS en de Yarn package manager geïnstalleerd hebt.
Docker en Docker Compose
De services worden beheerd door Docker en Docker Compose. Installeer ze en start Docker. Als je voor het eerst gebruik maakt van deze tool, neem dan eerst de tijd om er bekend mee te raken. Maar geen paniek, we gaan er niks ingewikkelds mee doen. Geen buitensporige configuraties, geen complexe instellingen.
Symfony CLI
Tenslotte zullen we de symfony CLI gebruiken om onze productiviteit te verhogen. Van de lokale webserver, tot volledige Docker-integratie en cloud ondersteuning via Platform.sh zal ons veel tijd besparen.
Installeer nu de Symfony CLI.
Om lokaal HTTPS te kunnen gebruiken, moeten we ook een "certificate authority" (CA) installeren voor TLS ondersteuning. Voer het volgende commando uit:
1
$ symfony server:ca:installControleer of jouw computer aan alle vereisten voldoet door het volgende commando uit te voeren:
1
$ symfony book:check-requirementsAls je het helemaal mooi wil doen, dan kan je ook de Symfony-proxy gebruiken. Dit is optioneel, maar het zorgt ervoor dat je een lokale domeinnaam met de extensie .wip kan gebruiken voor je project.
Bij het uitvoeren van een commando in een terminal, zullen we er bijna altijd symfony voor zetten, als in symfony composer in plaats van gewoon composer , of symfony console in plaats van ./bin/console .
De belangrijkste reden daarvoor is dat de Symfony CLI automatisch enkele omgevingsvariabelen instelt op basis van de services die via Docker op jouw machine draaien. Deze omgevingsvariabelen zijn beschikbaar voor HTTP requests omdat de lokale webserver ze automatisch injecteert. Het gebruik van symfony op de CLI zorgt er dus voor dat je over de gehele omgeving hetzelfde gedrag hebt.
Bovendien selecteert de Symfony CLI automatisch de "best mogelijke" PHP-versie voor het project.