Symfony Deployment Checklist

Gebruik deze checklist om te controleren of je Symfony-applicatie correct is geconfigureerd voor de productieomgeving.

OPcache

OPcache is een PHP-extensie die je PHP-code als gecompileerde bytecode cached zodat je code niet voor elk request opnieuw hoeft worden geïnterpreteerd. Sinds 8.5 is OPcache standaard onderdeel van PHP. Voor oudere versies moet de extensie soms eerst geïnstalleerd worden. Controleer de volgende configuratiewaarden, bijvoorbeeld via phpinfo() of in php.ini:

• OPcache is ingeschakeld (opcache.enable = 1)
• OPcache preloading is ingeschakeld (opcache.preload bevat het volledige pad naar Symfony's config/preload.php)
• opcache.preload_user bevat de naam van de webserver user (meestal www-data)
• opcache.memory_consumption is 256 of hoger
• opcache.max_accelerated_files is 32531 of hoger
• OPcache is ingesteld om niet bij elk request te controleren of PHP-bestanden zijn gewijzigd: opcache.validate_timestamps = 0

Zie Runtime Configuration voor alle configuratieopties van OPcache.

realpath cache

Relatieve bestandspaden worden door PHP omgezet naar absolute paden en het resultaat daarvan wordt gecached in de "realpath cache". Controleer of deze cache goed staat ingesteld:

• realpath_cache_size is 4096K of hoger
• realpath_cache_ttl is 600 seconden (10 minuten) of langer

Xdebug

• De Xdebug extensie is in productie afwezig of uitgeschakeld

Symfony configuratie

Controleer de volgende configuratiewaarden in Symfony:

• framework.enabled_locales (meestal te vinden in config/packages/translation.yaml) is geconfigureerd met alleen de locales die in de applicatie gebruikt worden
• .container.dumper.inline_factories: true is toegevoegd als parameter in config/services.yaml

Doctrine configuratie

Controleer bovendien de volgende configuratiewaarden indien Doctrine ORM wordt gebruikt (meestal te vinden in config/packages/doctrine.yaml):

• doctrine.dbal.server_version (of de serverVersion parameter in de DATABASE_URL environment variable) is ingesteld en bevat de database-versie die in productie draait
• De Query Cache is geconfigureerd: doctrine.orm.query_cache_driver
• De Result Cache is geconfigureerd: doctrine.orm.result_cache_driver

Zie ook: Caching Drivers.

Deploymentproces

Controleer het build/deploymentproces van je applicatie:

• De applicatie gebruikt een geoptimaliseerde class map (composer dump-autoload --no-dev --classmap-authoritative)
• OPcache wordt geleegd na elke deployment (bijvoorbeeld door de webserver te herstarten) zodat wijzigingen in bestanden door OPcache gedetecteerd worden

Zie ook: Performance.

Security

• Er worden geen Composer packages gebruikt met bekende kwetsbaarheden (composer audit)
• Er wordt een up-to-date en ondersteunde versie van Symfony gebruikt
• Op de server draait een up-to-date en ondersteunde versie van PHP
• De webserver user (meestal www-data) heeft geen rechten om de bronbestanden van de applicatie aan te passen, alleen om te lezen
• De public directory bevat geen bestanden met gevoelige informatie (zoals een .env)
• Er is recent een security audit uitgevoerd om de applicatiecode te controleren op kwetsbaarheden

Als de applicatie achter een load balancer of reverse proxy draait (bijvoorbeeld een ingress controller in een Kubernetes cluster), controleer dan ook het volgende:

• De IP-adressen van de load balancers / proxies zijn geconfigureerd via de SYMFONY_TRUSTED_PROXIES environment variable of via framework.trusted_proxies (meestal in config/packages/framework.yaml)

Zie ook: How to Configure Symfony to Work behind a Load Balancer or a Reverse Proxy.

User Experience

• Er zijn custom error pages ingesteld voor HTTP-foutcodes zoals 404, 403, 500 (meestal te vinden in templates/bundles/TwigBundle/Exception/)
• Er is een custom favicon ingesteld

Zie: How to Customize Error Pages.

Zoekmachineoptimalisatie

• De website bevat een robots.txt bestand in de public directory
• Symfony genereert een XML-sitemap die kan worden ingediend bij zoekmachines, bijvoorbeeld met behulp van PrestaSitemapBundle