Winkelbeheer & operations
Problemen met een winkelinstallatie oplossen
Onderzoek installatie, routering, achtergrondwerk, betalingen, pakketten en back-ups zonder destructieve omwegen.
Op deze pagina
Begin met bewijs en beperk de gevolgen
Leg vast wat misging, wanneer het begon, welke applicatie- en pakketrevisie actief zijn en of er kort daarvoor configuratie of migraties veranderden. Beperk afrekenen als betaal- of leveringsstatus onzeker is. Bewaar relevante logs privé en verwijder klantgegevens, sleutels, cookies en autorisatieheaders voordat je een fragment deelt.
Voer vanuit de applicatiemap met de bedoelde PHP-runtime uit:
php artisan agovena:doctor
composer check-platform-reqs --no-dev
Het doctor-commando onderscheidt verplichte fouten van waarschuwingen. Het kan slagen terwijl het waarschuwt over e-mail, mislukte taken, HTTPS, ontbrekende assets of opslag. Een geslaagde exit is geen reden om waarschuwingen te negeren. De vereistencontrole kan ook de publieke opslagkoppeling proberen aan te maken; doctor is dus niet strikt alleen-lezen.
Installatie- en schemaproblemen
| Symptoom | Controle en vervolg |
|---|---|
| PHP-extensie ontbreekt | Vergelijk CLI en FPM en activeer de extensie in de juiste runtime. Negeer Composer-platformvereisten niet. |
| Databaseverbinding mislukt | Controleer host, database, accountrechten en mogelijk verouderde configuratiecache. Toon het wachtwoord niet. |
| Installer meldt ontbrekende migraties | Volg de schemastap van installatie, of de upgradeprocedure met back-up voor een bestaande winkel. |
| Installer meldt al geïnstalleerd | Gebruik normaal aanmelden. Verwijder markering of installatie-instellingen niet om een andere eigenaar te maken. |
| Waarschuwing over installatieherstel | Herstel bij elkaar horende database en storage/app/agovena/installed.json; onderzoek een afwijkend herstelpunt. |
vendor of assetmanifest ontbreekt |
Plaats het juiste release-archief of installeer vastgelegde afhankelijkheden en bouw bronassets. Verwijder controles niet om ontbrekende bestanden te verbergen. |
Een migratiefout kan een gedeeltelijk aangepast schema achterlaten. Houd de winkel afgeschermd en onderzoek de eerste fout. Gebruik nooit migrate:fresh om een live winkel te repareren.
Web- en mediaproblemen
502: controleer de FPM-service, echte socketnaam en toegangsrechten. De eigen pool gebruikt een andere socket dan het standaard Nginx-sjabloon. Zie Nginx.
Startpagina werkt, andere routes geven 404: controleer documentroot public/, Nginx try_files of Apache-rewrite- en overrideconfiguratie. Zie Apache.
PHP wordt gedownload of broncode is zichtbaar: sluit publieke toegang onmiddellijk. Herstel de PHP-handler en onderzoek wat zichtbaar is geweest voordat je heropent.
Afbeeldingen ontbreken: controleer of de publieke bestanden bestaan en voer php artisan storage:link uit als de koppeling ontbreekt. Private bestanden moeten privé blijven.
Upload geweigerd: onderscheid limieten van proxy/webserver, PHP POST/upload, Livewire-validatie en product- of pakketspecifieke limieten. Alleen één limiet verhogen kan zonder effect blijven.
Verkeerde aanmeld- of callbackomleidingen: controleer APP_URL, TLS-afhandeling, vertrouwde proxies en sessieopslag. Schakel CSRF of tweefactorauthenticatie niet uit als omweg.
E-mail en achtergrondwerk
Controleer bij ontbrekende mail MAIL_MAILER: log bezorgt niet. Bekijk de echte SMTP-instellingen, toestemming voor de afzender, Admin → E-maillog en Mislukte taken. Providerweigering, een defecte worker en spamfiltering vragen verschillende oplossingen.
Controleer achtergrondwerk met:
sudo systemctl status agovena-queue.service
php artisan schedule:list
Bekijk de schedulerheartbeat in Admin en controleer een echte queuetaak. Een heartbeat bewijst geen queueverwerking. Een draaiende worker kan de verkeerde verbinding of oude configuratie gebruiken. Wis na een bewuste configuratiereparatie de configuratiecache en herstart workers volgens de beheerprocedure.
Voer alleen geselecteerde mislukte taken opnieuw uit nadat de oorzaak is opgelost. Controleer bij betaal- en provisioningtaken eerst het externe resultaat. Wis foutrecords niet om een schoon dashboard te krijgen.
Provider- en pakketfouten
Voer php artisan agovena:verify-providers uit voor beschikbare verbindingscontroles. Een waarschuwing dat geen healthcallback bestaat is geen providersucces. Is de provider betaald maar de winkel nog in afwachting, controleer webhookbereikbaarheid, ondertekening en accountconfiguratie voordat je een tweede betaling vraagt. Volg betalingen.
Controleer bij pakketfouten compatibiliteit, afhankelijkheden, vrije opslag, schrijftoegang tot storage/app/packages, Composer, uitgaand HTTPS en de ingestelde journaalverbinding. Bewerk pakketvlaggen niet handmatig en verwijder de Composer-map voor pakketten niet. Zie pakketherstel.
Back-upfouten en escalatie
Een onleesbare back-up kan wijzen op een verkeerde APP_KEY, beschadiging of ontbrekende opslag. Een databaseclientfout kan betekenen dat dump- of herstelsoftware ontbreekt of onvoldoende rechten heeft. Een geslaagde verificatie bewijst geen volledig herstel. Gebruik back-up en herstel, nooit een ongetest live herstel als diagnose van een archief.
Escaleer met de mislukte opdracht of actie, opgeschoonde eerste fout, versies, databasedriver, webserver, queuebackend en reeds uitgevoerde stappen. Deel .env of een volledige databasedump nooit publiek. Gebruik voor beveiligingsproblemen de private procedure in SECURITY.md.