Winkel- en omgevingsconfiguratie

Scheid serverinstellingen van winkelinstellingen

Serverconfiguratie staat in omgevingsvariabelen en Laravel-configuratie. Winkelvoorkeuren staan in de database en worden via Admin beheerd. Bewaar beide beschermd als onderdeel van je back-upplan. Een afzendernaam aanpassen in Admin configureert geen SMTP en een databasevoorkeur wijzigt niet de virtual host van je webserver.

Stel de productieomgeving expliciet in

Controleer deze sleutels in de bestaande .env zonder het bestand volledig te vervangen:

Vertrouw niet alle proxies met *. Bij directe TLS-afhandeling is geen proxy-uitzondering nodig. Een verkeerde oorsprong kan onveilige links, geweigerde callbacks en aanmeldproblemen veroorzaken. De implementatie staat in applicatieconfiguratie, databaseconfiguratie en middleware-inrichting.

Compensatiejournaal

Core definieert DB_COMPENSATION_CONNECTION, standaard compensation_journal, met een eigen DB_COMPENSATION_DATABASE. Bij MySQL/MariaDB is de standaarddatabasenaam agovena_compensation. Host, poort, gebruikersnaam en wachtwoord erven de hoofddatabase-instellingen tenzij je de bijbehorende DB_COMPENSATION_*-waarden instelt.

Richt deze database in en bescherm haar wanneer je het onafhankelijke journaal gebruikt. Verwijs de verbinding niet ongemerkt naar een andere database en neem niet aan dat hoofdmigraties of hoofdback-ups deze meenemen. Neem het geconfigureerde journaal op in je hersteloverzicht. Laat een verbindingsfout oplossen voordat je herstel van pakketbewerkingen probeert.

Zorg dat e-mail werkelijk wordt bezorgd

Het standaard e-mailtransport is log, dat geen klantmails bezorgt. Stel voor SMTP MAIL_MAILER=smtp en de door je provider voorgeschreven MAIL_HOST, MAIL_PORT, MAIL_SCHEME, MAIL_USERNAME en MAIL_PASSWORD in. Gebruik voor MAIL_FROM_ADDRESS en MAIL_FROM_NAME een toegestane afzender. Volg de echte verbindingsvereisten van de provider; kopieer geen inloggegevens en raad geen versleutelingsinstelling.

De sleutels staan in config/mail.php. Admin → Instellingen → E-mail bevat voorkeuren voor afzendernaam, afzenderadres en antwoordadres. Controleer een echte registratie- of bestelmail in een mailbox. Bekijk bij uitblijven de E-maillog en mislukte taken in Admin. Een werkende SMTP-verbinding bewijst geen inboxbezorging.

Controleer winkelinstellingen vóór de eerste factuur

Stel onder Admin → Instellingen taal, tijdzone, basisvaluta, automatische valutaomrekening, logo, verkopersnaam en -adres, documentvoorvoegsels en klantregistratiebeleid in. De registratie van instellingen definieert deze velden.

Beheer actieve valuta en optionele koerssynchronisatie via Admin → Valuta. Niet iedere provider accepteert iedere geactiveerde valuta. Controleer productspecifieke prijzen na wijziging van het omrekenbeleid.

Beoordeel belastingen via Admin → Belastingen en de winkelinstellingen. De automatische bron bevat standaard EU-btw-tarieven, niet alle verlaagde tarieven of belastingstelsels buiten de EU. Laat je accountant verkooplanden, factuurgegevens en vrijstellingen controleren. Externe koers- en belastingdiensten vereisen uitgaand HTTPS; zie de bronvermelding voor gegevensdiensten.

Pas wijzigingen toe en controleer opslag

Wis na wijzigingen aan servervariabelen verouderde configuratie en herstart langlopende workers:

php artisan config:clear
php artisan queue:restart
php artisan agovena:doctor

Een procesbeheerder moet een afsluitende queueworker opnieuw starten. Bouw bij gebruik van configuratiecache die cache pas opnieuw op nadat je de bedoelde waarden hebt gecontroleerd. Publiceer nooit een configuratiedump. Laravel beschrijft configuratiecaching.

Publieke media horen in storage/app/public, bereikbaar via public/storage. Private downloads en back-ups blijven buiten de webroot. Behoud bij releasevervanging pakketten onder storage/app/packages en het installatiemarkeerbestand onder storage/app/agovena. Zie de bestandssysteemconfiguratie.