CacheHandler.php

Go to the documentation of this file.

<?php

namespace Elgg\Application;

use Elgg\Application;
use Elgg\Cache\SimpleCache;
use Elgg\Config;
use Elgg\Database\ConfigTable;
use Elgg\Http\Request;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
use Symfony\Component\HttpFoundation\Response;

class CacheHandler {
    
    public static $extensions = [
        'bmp' => 'image/bmp',
        'css' => 'text/css',
        'eot' => 'application/vnd.ms-fontobject',
        'gif' => 'image/gif',
        'html' => 'text/html',
        'ico' => 'image/x-icon',
        'jpeg' => 'image/jpeg',
        'jpg' => 'image/jpeg',
        'js' => 'text/javascript',
        'json' => 'application/json',
        'map' => 'application/json',
        'mjs' => 'text/javascript',
        'otf' => 'application/font-otf',
        'png' => 'image/png',
        'svg' => 'image/svg+xml',
        'swf' => 'application/x-shockwave-flash',
        'tiff' => 'image/tiff',
        'ttf' => 'application/font-ttf',
        'webp' => 'image/webp',
        'woff' => 'application/font-woff',
        'woff2' => 'application/font-woff2',
        'xml' => 'text/xml',
    ];

    public static $utf8_content_types = [
        'text/css',
        'text/html',
        'text/javascript',
        'application/json',
        'image/svg+xml',
        'text/xml',
    ];
    
    protected bool $simplecache_enabled;

    public function __construct(
        protected Config $config,
        protected Request $request,
        protected SimpleCache $simplecache,
        ConfigTable $config_table
    ) {
        $this->simplecache_enabled = $config->simplecache_enabled;
        if (!$this->config->hasInitialValue('simplecache_enabled')) {
            $db_value = $config_table->get('simplecache_enabled');
            if (isset($db_value)) {
                $this->simplecache_enabled = (bool) $db_value;
            }
        }
    }

    public function handleRequest(Request $request, Application $app) {
        $parsed = $this->parsePath($request->getElggPath());
        if (!$parsed) {
            return $this->send403();
        }
        
        $ts = $parsed['ts'];
        $view = $parsed['view'];
        $viewtype = $parsed['viewtype'];

        $content_type = $this->getContentType($view);
        if (empty($content_type)) {
            return $this->send403('Asset must have a valid file extension');
        }

        $response = new Response();
        if (in_array($content_type, self::$utf8_content_types)) {
            $response->headers->set('Content-Type', "{$content_type};charset=utf-8", true);
        } else {
            $response->headers->set('Content-Type', $content_type, true);
        }
        
        $response->headers->set('X-Content-Type-Options', 'nosniff', true);

        if (!$this->simplecache_enabled) {
            $app->bootCore();
            if (!headers_sent()) {
                header_remove('Cache-Control');
                header_remove('Pragma');
                header_remove('Expires');
            }
            
            if (!$this->isCacheableView($view)) {
                return $this->send403("Requested view ({$view}) is not an asset");
            }

            $content = $this->getProcessedView($view, $viewtype);
            if ($content === false) {
                return $this->send403();
            }

            $etag = '"' . md5($content) . '"';
            $this->setRevalidateHeaders($etag, $response);
            if ($this->is304($etag)) {
                $response = new Response();
                $response->setNotModified();
                
                return $response;
            }

            return $response->setContent($content);
        }

        $etag = "\"{$ts}\"";
        if ($this->is304($etag)) {
            $response = new Response();
            $response->setNotModified();
            
            return $response;
        }

        // trust the client but check for an existing cache file
        $filename = $this->simplecache->getCachedAssetLocation($ts, $viewtype, $view);
        if (!empty($filename)) {
            $this->sendCacheHeaders($etag, $response);

            return new BinaryFileResponse($filename, 200, $response->headers->all());
        }

        // the hard way
        $app->bootCore();
        header_remove('Cache-Control');
        header_remove('Pragma');
        header_remove('Expires');

        elgg_set_viewtype($viewtype);
        if (!$this->isCacheableView($view)) {
            return $this->send403('Requested view is not an asset');
        }

        if ((int) $this->config->lastcache === $ts) {
            $this->sendCacheHeaders($etag, $response);

            $content = $this->getProcessedView($view, $viewtype);

            // store in simplecache for use later
            $this->simplecache->cacheAsset($viewtype, $view, $content);
        } else {
            // if wrong timestamp, don't send HTTP cache
            // also report that the resource has gone away
            $response->setStatusCode(ELGG_HTTP_GONE);
            
            $content = $this->getProcessedView($view, $viewtype);
        }

        return $response->setContent($content);
    }

    public function parsePath($path) {
        // no '..'
        if (str_contains($path, '..')) {
            return [];
        }

        // only alphanumeric characters plus /, ., -, and _
        if (preg_match('#[^a-zA-Z0-9/\.\-_]#', $path)) {
            return [];
        }

        // testing showed regex to be marginally faster than array / string functions over 100000 reps
        // it won't make a difference in real life and regex is easier to read.
        // <ts>/<viewtype>/<name/of/view.and.dots>.<type>
        $matches = [];
        if (!preg_match('#^/cache/([0-9]+)/([^/]+)/(.+)$#', $path, $matches)) {
            return [];
        }

        return [
            'ts' => (int) $matches[1],
            'viewtype' => $matches[2],
            'view' => $matches[3],
        ];
    }

    protected function isCacheableView($view) {
        $matches = [];
        if (preg_match('~^languages/(.*)\.js$~', $view, $matches)) {
            return in_array($matches[1],  _elgg_services()->locale->getLanguageCodes());
        }

        return _elgg_services()->simpleCache->isCacheableView($view);
    }

    protected function sendCacheHeaders($etag, Response $response) {
        $response->setSharedMaxAge(86400 * 30 * 6);
        $response->setMaxAge(86400 * 30 * 6);
        $response->headers->set('ETag', $etag);
    }

    protected function setRevalidateHeaders($etag, Response $response) {
        $response->headers->set('Cache-Control', 'public, max-age=0, must-revalidate', true);
        $response->headers->set('ETag', $etag);
    }

    protected function is304($etag) {
        $if_none_match = $this->request->headers->get('If-None-Match');
        if ($if_none_match === null) {
            return false;
        }

        // strip leading W/
        $if_none_match = trim($if_none_match);
        if (str_starts_with($if_none_match, 'W/')) {
            $if_none_match = substr($if_none_match, 2);
        }
        
        // strip -gzip
        $if_none_match = str_replace('-gzip', '', $if_none_match);

        return ($if_none_match === $etag);
    }

    public function getContentType($view) {
        $extension = $this->getViewFileType($view);
        
        return self::$extensions[$extension] ?? null;
    }
    
    public function getViewFileType($view) {
        $extension = (new \SplFileInfo($view))->getExtension();
        if (isset(self::$extensions[$extension])) {
            return $extension;
        }
        
        $matches = [];
        if (preg_match('~(?:^|/)(css|js)(?:$|/)~', $view, $matches)) {
            return $matches[1];
        }
        
        return 'unknown';
    }

    protected function getProcessedView($view, $viewtype) {
        $content = $this->renderView($view, $viewtype);
        if ($content === false) {
            return false;
        }

        $name = $this->simplecache_enabled ? 'simplecache:generate' : 'cache:generate';
        $type = $this->getViewFileType($view);
        
        // treat mjs as js
        if ($type === 'mjs') {
            $type = 'js';
        }
        
        $params = [
            'view' => $view,
            'viewtype' => $viewtype,
            'view_content' => $content,
        ];
        return _elgg_services()->events->triggerResults($name, $type, $params, $content);
    }

    protected function renderView($view, $viewtype) {
        elgg_set_viewtype($viewtype);

        $matches = [];
        if ($viewtype === 'default' && preg_match('#^languages/(.*?)\\.js$#', $view, $matches)) {
            $view = 'languages.js';
            $vars = ['language' => $matches[1]];
        } else {
            $vars = [];
        }

        if (!elgg_view_exists($view)) {
            return false;
        }

        // disable error reporting so we don't cache problems
        $this->config->debug = null;

        return elgg_view($view, $vars);
    }

    protected function send403($msg = 'Cache error: bad request') {
        return new Response($msg, ELGG_HTTP_FORBIDDEN);
    }
}