Caching nach Importen
Diese Seite ist für Integratoren und Betreiber, die nach einem Import alte Inhalte sehen oder genau so viel leeren möchten wie nötig und nicht mehr. Exponential cacht auf mehreren Ebenen. Inhalte, die über die unterstützten Funktionen geändert werden, leeren ihre eigenen Caches; auf anderem Weg geänderte Inhalte, Einstellungen, Code und äußere Caches brauchen Nachhilfe. Die Übersicht über jeden Cache ist Caches.
Inhalt
- Was das Veröffentlichen selbst leert
- Wann mehr zu leeren ist
- Die Cache-IDs
- Äußere Caches
- Nach Änderungen an Einstellungen und Code
- Rezepte
Was das Veröffentlichen selbst leert
eZContentFunctions::createAndPublishObject(), updateAndPublishObject(), die REST-Route zum Anlegen und die
Schreibvorgänge von expservices durchlaufen alle den Veröffentlichungsvorgang, der über eZContentCacheManager die
View-Caches der Knoten des Objekts und der davon abhängigen Knoten leert (übergeordnete, verwandte Objekte, laut
viewcache.ini) und für Listener das Ereignis content/cache meldet
(Event-Listener).
Hinweis Wenn eine Änderung mehr Knoten leeren würde, als die Aufräumschwelle erlaubt, leert der Kernel stattdessen jeden View-Cache, schreibt eine Warnung ins Protokoll und meldet
content/cache/all. Ein großer Import kann daher die nächsten Aufrufe überall langsamer machen; führen Sie große Importe zu ruhigen Zeiten aus.
Wann mehr zu leeren ist
| Situation | Was zu leeren ist |
|---|---|
| Inhalte wurden außerhalb des Veröffentlichungsvorgangs geändert (direktes SQL, eine Reparatur) | Die View-Caches der Objekte: eZContentCacheManager::clearContentCacheIfNeeded( $objectID ) in PHP oder expobject::expireCache über expservices; besser ändern Sie Inhalte gar nicht auf diese Weise |
Template-Blöcke (cache-block) zeigen Listen importierter Inhalte | template-block, oder auf ihr Ablaufen vertrauen |
| Menüs zeigen importierte Ordner | content_tree_menu (Baum der Administration), template-block |
| RSS-Exporte müssen importierte Einträge sofort zeigen | rss_cache |
| Importierte Objekte haben neue URL-Aliase bekommen | Meist nichts; urlalias nur nach einer Reparatur |
| Klassen oder Klassenattribute wurden geändert (ein neues Klassenpaket) | classid, sortkey und die Inhalts-View-Caches |
| Suchergebnisse sind veraltet | Kein Cache: den Index neu aufbauen (Anbindung einer Suchmaschine) |
Die Cache-IDs
php bin/php/ezcache.php --list-ids --allow-root-user listet sie auf. Die, denen eine Integration am häufigsten
begegnet:
| ID | Enthält |
|---|---|
content | View-Caches der Inhalte |
template-block | Ausgabe von Template-cache-blocks |
exphttpcache | Den HTTP-Cache ganzer Seiten |
querycache | Den SQL-Abfrage-Cache |
rss_cache | Geschriebene RSS-Exporte |
urlalias | Nachschlagen von URL-Aliasen |
classid, sortkey | Nachschlagen von Klassen |
content_tree_menu | Das Baummenü der Administration |
ini, global_ini | Einstellungen (leeren mit --clear-tag=ini) |
template, template-override | Kompilierte Templates und den Override-Index |
php bin/php/ezcache.php --clear-id=content,template-block --allow-root-user
php bin/php/ezcache.php --clear-tag=content --allow-root-user
php bin/php/console exp:cache clear --id=content --dry-run --allow-root-user # what would be cleared, with sizesVermeiden Sie --clear-all auf einer stark besuchten Produktionswebsite nach einem Import: Es leert jeden Cache auf
einmal, und jeder Besucher bezahlt für den Neuaufbau.
Äußere Caches
| Ebene | Leeren |
|---|---|
| Der Antwort-Cache von Velocity (wenn Velocity die Website ausliefert) | php bin/php/console exp:velocity cache clear --apply |
| Der HTTP-Cache | Cache-ID exphttpcache (HTTP-Cache) |
| Ein CDN oder Reverse Proxy, den Sie betreiben | Seine eigene Purge-API, angestoßen durch content/cache-Ereignisse (Beispiel) |
| Browser | Cache-Header Ihrer Seiten; nichts zu leeren |
Der statische Cache ist in den mitgelieferten Einstellungen ausgeschaltet; hat eine Website ihn eingeschaltet, müssen auch seine Dateien neu erzeugt werden (Generator für den statischen Cache).
Nach Änderungen an Einstellungen und Code
Eine neue Version Ihrer Integrationserweiterung zu deployen ist kein Import und braucht mehr:
php bin/php/ezpgenerateautoloads.php -e, wenn Klassen hinzugefügt oder umbenannt wurden.php bin/php/ezcache.php --clear-tag=ini --allow-root-usernach Änderungen an Einstellungen (nicht--clear-id=ini, das den globalen INI-Cache stehen lässt).- PHP-FPM neu laden und Velocity neu starten: Die Worker von Velocity behalten die Klassen, die sie beim Start geladen haben.
- Dann den Inhalts-View-Cache und den Antwort-Cache von Velocity leeren, nach dem Neuladen, damit keine vom alten Code erzeugte Seite erneut gecacht wird.
php bin/php/console exp:velocity deploy erledigt diese Schritte in der richtigen Reihenfolge
(Deployen).
Rezepte
# after a nightly product import that publishes through eZContentFunctions: usually nothing; lists in cache-blocks:
php bin/php/ezcache.php --clear-id=template-block --allow-root-user
after installing a package with classes and content (indexing was delayed)
php bin/php/updatesearchindex.php --allow-root-user
php bin/php/ezcache.php --clear-id=content,template-block,classid,sortkey --allow-root-user
php bin/php/console exp:velocity cache clear --apply
after a repair that changed content tables directly
php bin/php/ezcache.php --clear-id=content,template-block,urlalias --allow-root-userVerwandte Seiten
- Caches
- Cache-Tags und Leeren
- Caching in Anwendungen
- Velocity und Performance für Integrationen
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.