<div class="gmail_quote"><div class="gmail_quote"><div class="im">Hi,<br><br>I work for a company which uses a lot the proxy module and the proxy cache feature.<br></div>We always have problems on clearing the cache because it has to be done url by url.<div class="im">
<br><br>Thinking in a way to solve this I made the patch in attachment <br>

(nginx_cache_with_groups.patch (<a href="http://pastebin.com/Gy6N6knq">http://pastebin.com/Gy6N6knq</a>), for nginx 1.0.10 and 0001-adding-parameter-to-purge-cache-by-groups.patch (<a href="http://pastebin.com/kegfRPUH">http://pastebin.com/kegfRPUH</a>), for ngx_cache_purge 1.4).<br>
<br>Basically it changes the (fastcgi|proxy|scgi|uwsgi)_cache_key directives adding an optional value named "group key".<br></div>

This value accept any variable available on nginx configuration file (query parameters, headers,...) just like the key value.<div class="im"><br><br>When using this value a directory is created using the same structure of levels to store all files which have the same group key.<br>


Doing this we can purge the cache using a specific file, like is done today, or all files from a group. (I change the cache_purge_module to make this possible too)<br><br>I will give an example to be clear.<br></div>Imagine the configuration attached (nginx.conf - <a href="http://pastebin.com/DVyeSrQT">http://pastebin.com/DVyeSrQT</a>) and that "html/static" folder has some files like test.css, test1.html and test2.html.<div class="im">
<br>

With that configuration the extension file will be used as the group key and the uri as cache key.<br><br>When we execute the following commands the corresponded files are created:<br>command: curl -v '<a href="http://localhost:8090/test1.html" target="_blank">http://localhost:8090/test1.html</a>'<br>


file:    ./e/53/a/fc35fdc70d5fc69d269883a822c7a53e/1/3d/9/bcccd499fbe303221add1b6e57d693d1 -> where fc35fdc70d5fc69d269883a822c7a53e is from group key and bcccd499fbe303221add1b6e57d693d1 from file key<br><br>command: curl -v '<a href="http://localhost:8090/test2.html" target="_blank">http://localhost:8090/test2.html</a>'<br>


file:    ./e/53/a/fc35fdc70d5fc69d269883a822c7a53e/4/86/6/558156b89af1ccd4844556ab699d6864 -> where fc35fdc70d5fc69d269883a822c7a53e is from group key and 558156b89af1ccd4844556ab699d6864 from file key<br><br>command: curl -v '<a href="http://localhost:8090/test.css" target="_blank">http://localhost:8090/test.css</a>'<br>


file:    ./a/66/2/c7a628cba22e28eb17b5f5c6ae2a266a/a/f0/d/9a96e0fe2f89d77e756fa45ae882df0a -> where c7a628cba22e28eb17b5f5c6ae2a266a is from group key and 9a96e0fe2f89d77e756fa45ae882df0a from file key<br><br>Now we can purge the cache from css file doing<br>


curl -v 'localhost:8090/purge/test.css' -H 'X-Group-Clean:0'<br><br>Or purge all html files doing<br></div>curl -v 'localhost:8090/purge/_.html' -H 'X-Group-Clean:1' (the underline in _.html is only to do a match on location)<div class="im">
<br>
<br>The Group key can be as general or as specific like we want/need.<br>
<br>The default value for directive group_clean_cache_purge is 0, and the value used to it must be a text which converted to a number (ngx_atoi) results in a zero, purge only the selected file, or non zero, purge all files from selected group.<br>


<br><br>Another example of use is we have a service to resize images, and the desired size is passed through the uri like <br><a href="http://localhost/480x360/1361234.jpg" target="_blank">http://localhost/480x360/1361234.jpg</a> or <a href="http://localhost/x240/1361234.jpg" target="_blank">http://localhost/x240/1361234.jpg</a><br>


<br>With that patch we can group all resized images using the image id (1361234, in the example) as the group key and than purge all cached files at once.<br><br>I hope this patch can be applied in future versions of Nginx and made available to everyone.<br>


<br>Regards,<br>Wandenberg<br><br>
</div></div><br>
</div><br>