DataFirefly Cache Clear: volledige gids
De knop « Cache legen » van DataFirefly installeren en gebruiken in de backoffice van PrestaShop 8 en 9.
Overzicht
DataFirefly Cache Clear voegt een knop “Cache legen” toe aan de werkbalk van de PrestaShop-back-office. Eén klik leegt de caches Smarty, XML, Media en Symfony, reset de PHP-OPcache en leegt de objectcache als die is ingeschakeld, zonder via Geavanceerde instellingen > Prestaties te gaan en zonder de pagina te herladen.
Installatie
- Download het archief
dfclearcache.zipvanuit uw DataFirefly-account. - Open in de back-office Modules > Modulebeheer.
- Klik op Een module uploaden en selecteer de ZIP.
- De module wordt automatisch geïnstalleerd en ingeschakeld.
Geen configuratie nodig: zodra de module is ingeschakeld, verschijnt de knop in de werkbalk van elke beheerpagina.
Update vanaf 1.0.x
Upload de ZIP van versie 1.1.0 in Modules > Modulebeheer, over de geïnstalleerde versie heen. Het updatescript reset OPcache zodat de nieuwe code meteen wordt gebruikt. Er hoeft niets opnieuw te worden ingesteld.
Gebruik
- Klik op de knop “Cache legen” in de werkbalk, naast de pagina-acties en de helpknop.
- Het pictogram draait tijdens de bewerking. De lediging loopt via AJAX en de pagina wordt niet herladen.
- Een groene melding bevestigt de bewerking en toont de geleegde caches, bijvoorbeeld “Cache succesvol geleegd. (Smarty, XML, Media, Symfony, OPcache)”.
Wat wordt geleegd
- de Smarty-cache (gecompileerde templates van front- en back-office);
- de XML-cache;
- de mediacache (gecombineerde en geminimaliseerde CSS/JS);
- de Symfony-cache van PrestaShop 8/9;
- de PHP-OPcache, als de extensie actief is en de host een reset toestaat;
- de objectcache (Memcached, APCu), alleen als die is ingeschakeld in Geavanceerde instellingen > Prestaties.
De Symfony-cache wordt geleegd via het native mechanisme van PrestaShop, aan het einde van het verzoek. Als dat mechanisme niet beschikbaar is, hernoemt de module de map var/cache van de huidige omgeving en verwijdert hem nadat het antwoord is verstuurd. De map wordt dus nooit verwijderd terwijl een pagina hem gebruikt.
Wie de knop ziet
De knop wordt alleen getoond aan medewerkers van wie het profiel toegang heeft tot de module: superbeheerders en het profiel van de medewerker die de module installeerde. Andere profielen zien hem niet, zodat er geen knop is die bij een klik mislukt.
Logboek van ledigingen
Elke lediging wordt vastgelegd in Geavanceerde instellingen > Logboeken met het ID van de medewerker, in de vorm “DataFirefly Cache Clear: cache cleared (Smarty, XML, Media, Symfony, OPcache)”. Een gedeeltelijke lediging verschijnt met de ernst “waarschuwing”.
Compatibiliteit
- PrestaShop 8.0 tot 9.x
- PHP 7.4 tot 8.x
- Enkele winkel en multistore
- Talen: FR, EN, ES, DE, IT, NL, PL, PT (standaard Engels)
- Gebruikte hook:
displayBackOfficeHeader
Probleemoplossing
De knop verschijnt niet
Controleer of de module is ingeschakeld in Modulebeheer en of uw profiel bij de profielen hoort die toegang hebben tot de module (zie “Wie de knop ziet”).
Melding “Uw sessie is verlopen”
Uw back-officesessie is verlopen terwijl de pagina openstond. Herlaad de pagina, log zo nodig opnieuw in en klik nog een keer.
Melding “Cache gedeeltelijk geleegd”
Eén stap is mislukt, de andere zijn uitgevoerd. De foutdetails verschijnen in de browserconsole (F12) en de lediging wordt als waarschuwing gelogd. De meest voorkomende oorzaak is een probleem met schrijfrechten op de cachemappen.
OPcache ontbreekt in de melding
De OPcache-extensie is uitgeschakeld, of de host beperkt opcache_reset() (richtlijn opcache.restrict_api). De stap wordt dan zonder fout overgeslagen. Dit is geen storing van de module.