Appcache Handler

Files

/engine/handler.appcache.php

Introduction

Appcache Handler is used to return an appcache manifest to the browser for pages that use Appcache. If this appcache file already exists in project root folder, then it is returned directly from that source. Otherwise the file will be generated.

Workflow

This script can only be executed through Index Gateway and it throws a 403 Forbidden message if accessed directly.

Sets the content type to 'text/cache-manifest', which is the required content type for Appcache manifest files.

Returns the content of existing manifest file, if such is present. Otherwise generates new manifest content that is returned to user agent instead. When file is being generated, then it uses the general version number from Configuration file to determine if it should generate a new Appcache file or use the previous one.

Handler also includes an optional Database connection, which can be used if it is necessary at some point to load manifest details from Database instead.

Appcache Handler returns content with appropriate HTTP response headers, including the last-modified timestamp.

Appcache Handler also makes an entry in the log file about the request, if Logger is used.