weber.cloud China Proxy-Cache-Server: Löschen des Caches

Der Aufbau des Caches erfolgt reaktiv. Sobald eine Datei das erste Mal von einem Website-Besucher benötigt wird, stellt der Proxy-Cache-Server eine entsprechende Anfrage an Ihren Webserver. Die Datei wird anschließend im Cache abgelegt. Erneute Anfragen der Datei können dann für die Dauer der Zwischenspeicherung direkt aus dem Cache beantwortet werden und somit wird die Performance Ihrer Website in China deutlich verbessert.

Ein proaktiver Aufbau bzw. ein Aufwärmen des Caches kann erzielt werden, indem Sie den Cache komplett leeren und dann einen Crawler über die Website laufen lassen. Derzeit bedarf dies noch einer eigenen Crawler-Logik, zukünftig wird es die Möglichkeit zum Anstoßen eines Website-Crawlings direkt auf dem Proxy-Cache-Server geben.

Standardmäßig sieht der Proxy-Cache-Server die nachfolgenden Dauern für die Speicherung von Dateien vor:

Die genaue Cache-Logik für Ihre Website wird im Rahmen der Einrichtung des Proxy-Cache-Servers festgelegt. Hierbei können die Cache-Dauern angepasst, zusätzliche Cache-Dauern für bestimmte Dateitypen geschaffen oder bestimmte Bereiche und Seiten komplett vom Caching ausgeschlossen werden. Für jede Datei haben Sie zusätzlich die Möglichkeit, über die Headerinformation "X-Accel-Expires" die gewünschte Cache-Dauer in Sekunden anzugeben. Dieser Wert überschreibt die allgemein definierten Cache-Dauern und ermöglicht Ihnen bei Bedarf, die Cache-Dauern für bestimmte Dateien gezielt festzulegen.

Manuelles Löschen von Dateien aus dem Cache

Aufgrund der Zwischenspeicherung von Dateien werden Änderungen an Ihrer Website erst mit einer gewissen Verzögerung in China sichtbar. Der Proxy-Cache-Server stellt daher mehrere Möglichkeiten zur Verfügung, um einzelne Dateien im Cache manuell zu erneuern oder den gesamten Cache neu aufzubauen.

Das zugehörige Cache-Controlling ist über den Pfad /cache/purge erreichbar und kann daher auch direkt im Browser bedient werden. Die Struktur der URLs ist wie folgt:

http://www.ihr-gewaehlter-name.com/cache/purge/pfad/zu/den/dateien

Beim Verwenden des Cache-Controllings müssen Sie sich mit entsprechenden Zugangsdaten authentifizieren, welche Sie von uns während der Einrichtung des Proxy-Cache-Servers erhalten. Falls Sie die Zugangsdaten nicht mehr zur Hand haben sollten, können Sie gerne mit uns in Kontakt treten.

Bitte beachten Sie stets: Das Löschen von Dateien aus dem Cache hat vorübergehende Performance-Einbußen für Ihre Website in China zur Folge, da der Cache erst wieder aufgebaut werden muss. Aus diesem Grund empfehlen wir dringend: Löschen Sie so viele Dateien wie nötig, aber so wenig wie möglich. Das Löschen des gesamten Caches sollte nur in Ausnahmesituationen erfolgen, da dies den größten negativen Einfluss auf die Performance Ihrer Website in China hat. Sollten Sie feststellen, dass Sie immer wieder die gleichen Seiten oder Bereiche im Cache erneuern, können Sie gerne Kontakt mit uns aufnehmen, damit wir entsprechende Optimierungen an den Cache-Regeln vornehmen und Ihnen manuelle Arbeit ersparen.

1. Erneuern einer einzelnen Datei

Angenommen Sie möchten die nachfolgende Datei im Cache erneuern: http://www.ihr-gewaehlter-name.com/images/image.jpg

In diesem Fall müssen Sie einfach die folgende URL in Ihrem Browser aufrufen: http://www.ihr-gewaehlter-name.com/cache/purge/images/image.jpg

Nach dem Löschen werden Sie auf http://www.ihr-gewaehlter-name.com/images/image.jpg weitergeleitet, wodurch sofort die neuste Version der Datei abgerufen und im Cache abgelegt wird.

2. Mehrere Dateien aus dem Cache löschen

Beim Löschen mehrerer Dateien können Sie eine Wildcard-Notation verwenden.

Variante 1: Löschen aller Dateien mit einer bestimmten Endung in einem Unterordner

Angenommen Sie möchten alle JPG-Bilder im Unterverzeichnis /images/ aus dem Cache löschen. In diesem Fall rufen Sie folgende URL auf: http://www.ihr-gewaehlter-name.com/cache/purge/images/*.jpg

Über diesen Aufruf werden beispielsweise die nachfolgenden Dateien aus dem Cache gelöscht:

• http://www.ihr-gewaehlter-name.com/images/image.jpg
• http://www.ihr-gewaehlter-name.com/images/Water-Slide.jpg

Dateien mit einer anderen Endung oder in einem Unterordner werden nicht gelöscht. D.h. die folgenden Dateien würden weiterhin unverändert aus dem Cache bezogen werden:

• http://www.ihr-gewaehlter-name.com/images/image.jpeg
• http://www.ihr-gewaehlter-name.com/images/image.png
• http://www.ihr-gewaehlter-name.com/images/news/stunning-image.jpg

Variante 2: Rekursives Löschen aller Dateien in einem Ordner und allen Unterordnern

Angenommen Sie möchten alle Dateien im Unterverzeichnis /images/ aus dem Cache löschen. Dann rufen Sie einfach folgende URL auf: http://www.ihr-gewaehlter-name.com/cache/purge/images/*

Im Vergleich zur ersten Variante einer Löschung via Wildcard endet die URL hierbei mit einem Stern. Dadurch erfolgt das Löschen rekursiv und schließt Unterordner mit ein. Es werden also beispielsweise die folgenden Dateien im Cache gelöscht:

• http://www.ihr-gewaehlter-name.com/images/image.jpg
• http://www.ihr-gewaehlter-name.com/images/image.jpeg
• http://www.ihr-gewaehlter-name.com/images/image.png
• http://www.ihr-gewaehlter-name.com/images/news/stunning-image.jpg
• http://www.ihr-gewaehlter-name.com/images/document.pdf
• http://www.ihr-gewaehlter-name.com/images/video.mp4

Bitte beachten Sie, dass beim Löschen von mehreren Dateien genau eine Wildcard-Notation in der URL vorhanden sein darf. Die Verwendung von mehreren Wildcards in der URL ist nicht möglich.

Bei beiden Varianten werden Sie nach dem Löschen auf die Startseite weitergeleitet.

3. Löschen des gesamten Caches

Das Löschen des gesamten Caches ist im Prinzip eine Abwandlung des rekursiven Löschens per Wildcard, bei der kein Unterpfad angegeben wird: http://www.ihr-gewaehlter-name.com/cache/purge/*

Nach dem Löschen werden Sie auf die Startseite weitergeleitet.

4. Löschen per API

Ziel des oben beschriebenen Cache-Controllings ist es, dass das Löschen von Dateien aus dem Cache komfortabel direkt durch den Aufruf einer passenden URL im Browser erfolgen kann. Selbstverständlich kann dieser Prozess automatisiert werden. Die Einsatz von cURL-Anfragen eignet sich dazu besonders gut.

Erneuern einer einzelnen Datei:

curl -u user:password http://www.ihr-gewaehlter-name.com/cache/purge/images/image.jpg

Mehrere Dateien aus dem Cache löschen:

curl -u user:password http://www.ihr-gewaehlter-name.com/cache/purge/images/*

Löschen des gesamten Caches:

curl -u user:password http://www.ihr-gewaehlter-name.com/cache/purge/*

PURGE-Anfragen:

Die Nutzung von PURGE- anstelle von GET-Anfragen zum Löschen aus dem Cache wird auf dem Proxy-Cache-Server derzeit nicht explizit unterstützt. PURGE-Anfragen werden implizit als GET-Anfrage interpretiert. Falls Sie die Nutzung einer PURGE-Anfrage bevorzugen, müssen Sie dennoch sicherstellen, dass Sie die korrekte URL mitsamt dem Pfad /cache/purge aufrufen.

Alte Methode des Löschens via URL-Parameter

Derzeit ist das Löschen via URL-Parameter weiterhin möglich und wir haben hierfür auf den Proxy-Cache-Servern ein entsprechendes Mapping auf das neue Cache-Controlling konfiguriert.

Löschen einer einzelnen Datei

• Alt: http://www.ihr-gewaehlter-name.com/images/image.jpg?proxycachecontrol=renewcurrentpage
• Neu: http://www.ihr-gewaehlter-name.com/cache/purge/images/image.jpg

Löschen des gesamten Caches

• Alt: http://www.ihr-gewaehlter-name.com/?proxycachecontrol=clearcompletecache
• Neu: http://www.ihr-gewaehlter-name.com/cache/purge/*

Obwohl das Löschen via URL-Parameter derzeit weiterhin möglich ist, empfehlen wir Ihnen dringend, dass Sie auf die neue Version des Cache-Controllings umsteigen. Zum einen stehen Ihnen dabei über die Wildcard-Notation umfangreichere Möglichkeiten zur Verfügung. Zum anderen werden wir die Verwendung der URL-Parameter in kommenden Versionen des Cache-Controllings nicht mehr unterstützen.