ResponseFactory.php

Go to the documentation of this file.

<?php

namespace Elgg\Http;

use Elgg\Ajax\Service as AjaxService;
use Elgg\EventsService;
use Elgg\Exceptions\UnexpectedValueException;
use Elgg\Traits\Loggable;
use Symfony\Component\HttpFoundation\Cookie;
use Symfony\Component\HttpFoundation\RedirectResponse as SymfonyRedirectResponse;
use Symfony\Component\HttpFoundation\Response as SymfonyResponse;
use Symfony\Component\HttpFoundation\ResponseHeaderBag;
use Symfony\Component\HttpFoundation\JsonResponse;

class ResponseFactory {

    use Loggable;
    
    protected ResponseTransport $transport;
    
    protected ResponseHeaderBag $headers;
    
    protected ?SymfonyResponse $response_sent = null;

    public function __construct(
        protected Request $request,
        protected AjaxService $ajax,
        protected EventsService $events
    ) {
        $this->transport = \Elgg\Application::getResponseTransport();
        $this->headers = new ResponseHeaderBag();
    }

    public function setHeader(string $name, string $value, bool $replace = true): void {
        $this->headers->set($name, $value, $replace);
    }

    public function setCookie(\ElggCookie $cookie): bool {
        if (!$this->events->trigger('init:cookie', $cookie->name, $cookie)) {
            return false;
        }

        $symfony_cookie = new Cookie(
            $cookie->name,
            $cookie->value,
            $cookie->expire,
            $cookie->path,
            $cookie->domain,
            $cookie->secure,
            $cookie->httpOnly
        );

        $this->headers->setCookie($symfony_cookie);
        return true;
    }

    public function getHeaders(bool $remove_existing = true): ResponseHeaderBag {
        // Add headers that have already been set by underlying views
        // e.g. viewtype page shells set content-type headers
        $headers_list = headers_list();
        foreach ($headers_list as $header) {
            if (stripos($header, 'HTTP/1.1') !== false) {
                continue;
            }

            list($name, $value) = explode(':', $header, 2);
            $this->setHeader($name, ltrim($value), false);
            if ($remove_existing) {
                header_remove($name);
            }
        }

        return $this->headers;
    }

    public function prepareResponse(?string $content = '', int $status = 200, array $headers = []): SymfonyResponse {
        $header_bag = $this->getHeaders();
        $header_bag->add($headers);
        
        $response = new SymfonyResponse($content, $status, $header_bag->all());
        
        return $response->prepare($this->request);
    }

    public function prepareRedirectResponse(string $url, int $status = 302, array $headers = []): SymfonyRedirectResponse {
        $header_bag = $this->getHeaders();
        $header_bag->add($headers);
        
        $response = new SymfonyRedirectResponse($url, $status, $header_bag->all());
        
        return $response->prepare($this->request);
    }
    
    public function prepareJsonResponse($content = '', int $status = 200, array $headers = []): JsonResponse {
        $header_bag = $this->getHeaders();
        $header_bag->add($headers);
        
        $header_bag->remove('Content-Type');
        
        $response = new JsonResponse($content, $status, $header_bag->all());
        
        return $response->prepare($this->request);
    }

    public function send(SymfonyResponse $response): SymfonyResponse|false {
        if (isset($this->response_sent)) {
            if ($this->response_sent !== $response) {
                $this->getLogger()->error('Unable to send the following response: ' . PHP_EOL
                        . (string) $response . PHP_EOL
                        . 'because another response has already been sent: ' . PHP_EOL
                        . (string) $this->response_sent);
            }
        } else {
            if (!$this->events->triggerBefore('send', 'http_response', $response)) {
                return false;
            }

            $request = $this->request;
            $method = $request->getRealMethod() ?: 'GET';
            $path = $request->getElggPath();

            $this->getLogger()->notice("Responding to {$method} {$path}");
            if (!$this->transport->send($response)) {
                return false;
            }

            $this->events->triggerAfter('send', 'http_response', $response);
            $this->response_sent = $response;
            
            $this->closeSession();
        }

        return $this->response_sent;
    }

    public function getSentResponse(): ?SymfonyResponse {
        return $this->response_sent;
    }

    public function respond(ResponseBuilder $response) {
        $response_type = $this->parseContext();
        $response = $this->events->triggerResults('response', $response_type, [], $response);
        if (!$response instanceof ResponseBuilder) {
            throw new UnexpectedValueException("Handlers for 'response', '{$response_type}' event must return an instanceof " . ResponseBuilder::class);
        }

        if ($response->isNotModified()) {
            return $this->send($this->prepareResponse('', ELGG_HTTP_NOT_MODIFIED));
        }

        // Prevent content type sniffing by the browser
        $headers = $response->getHeaders();
        $headers['X-Content-Type-Options'] = 'nosniff';
        $response->setHeaders($headers);
        
        $is_xhr = $this->request->isXmlHttpRequest();

        $is_action = $this->isAction();

        if ($is_action && $response->getForwardURL() === null) {
            // actions must always set a redirect url
            $response->setForwardURL(REFERRER);
        }

        if ($response->getForwardURL() === REFERRER) {
            $response->setForwardURL((string) $this->request->headers->get('Referer'));
        }

        if ($response->getForwardURL() !== null && !$is_xhr && !$response->isRedirection()) {
            // non-xhr requests should issue a forward if redirect url is set
            // unless it's an error, in which case we serve an error page
            if ($is_action || (!$response->isClientError() && !$response->isServerError())) {
                $response->setStatusCode(ELGG_HTTP_FOUND);
            }
        }

        if ($is_xhr && ($is_action || $this->ajax->isAjax2Request())) {
            // Actions and calls from elgg/Ajax always respond with JSON on xhr calls
            $headers = $response->getHeaders();
            $headers['Content-Type'] = 'application/json; charset=UTF-8';
            $response->setHeaders($headers);

            if ($response->isOk()) {
                $response->setContent($this->wrapAjaxResponse($response->getContent(), $response->getForwardURL()));
            }
        }

        if ($response->isRedirection()) {
            $redirect_url = $response->getForwardURL();
            return $this->redirect($redirect_url, $response->getStatusCode());
        }

        if ($this->ajax->isReady() && $response->isSuccessful()) {
            return $this->respondFromContent($response);
        }

        if ($response->isClientError() || $response->isServerError() || $response instanceof ErrorResponse) {
            return $this->respondWithError($response);
        }

        return $this->respondFromContent($response);
    }

    public function respondWithError(ResponseBuilder $response) {
        $error = $this->stringify($response->getContent());
        $status_code = $response->getStatusCode();

        if ($this->ajax->isReady()) {
            return $this->send($this->ajax->respondWithError($error, $status_code));
        }

        if ($this->isXhr()) {
            // xhr calls to non-actions (e.g. ajax/view or ajax/form) need to receive proper HTTP status code
            return $this->send($this->prepareResponse($error, $status_code, $response->getHeaders()));
        }

        $forward_url = $this->getSiteRefererUrl();

        if ($this->isAction()) {
            $forward_url = $this->makeSecureForwardUrl($forward_url);
            return $this->send($this->prepareRedirectResponse($forward_url));
        }
        
        $params = [
            'current_url' => $this->request->getCurrentURL(),
            'forward_url' => $forward_url,
        ];
        
        // For BC, let plugins serve their own error page
        // @todo can this event be dropped
        $forward_reason = (string) $status_code;

        $this->events->triggerResults('forward', $forward_reason, $params, $forward_url);

        if (isset($this->response_sent)) {
            // Response was sent from a forward event
            return $this->response_sent;
        }

        if (elgg_view_exists('resources/error')) {
            $params['type'] = $forward_reason;
            $params['exception'] = $response->getException();
            if (!elgg_is_empty($error)) {
                $params['params']['error'] = $error;
            }
            
            $error_page = elgg_view_resource('error', $params);
        } else {
            $error_page = $error;
        }

        return $this->send($this->prepareResponse($error_page, $status_code));
    }

    public function respondFromContent(ResponseBuilder $response) {
        $content = $this->stringify($response->getContent());
        
        if ($this->ajax->isReady()) {
            return $this->send($this->ajax->respondFromOutput($content, $this->parseContext()));
        }

        return $this->send($this->prepareResponse($content, $response->getStatusCode(), $response->getHeaders()));
    }

    public function wrapAjaxResponse($content = '', ?string $forward_url = null): string {
        $content = $this->stringify($content);

        if ($forward_url === REFERRER) {
            $forward_url = $this->getSiteRefererUrl();
        }

        return $this->stringify([
            'value' => $this->ajax->decodeJson($content),
            'current_url' => $this->request->getCurrentURL(),
            'forward_url' => elgg_normalize_url((string) $forward_url),
        ]);
    }

    public function redirect(string $forward_url = REFERRER, $status_code = ELGG_HTTP_FOUND) {
        $location = $forward_url;
        
        if ($forward_url === REFERRER) {
            $forward_url = $this->getSiteRefererUrl();
        }

        $forward_url = $this->makeSecureForwardUrl($forward_url);

        // allow plugins to rewrite redirection URL
        $params = [
            'current_url' => $this->request->getCurrentURL(),
            'forward_url' => $forward_url,
            'location' => $location,
        ];

        $forward_reason = (string) $status_code;

        $forward_url = (string) $this->events->triggerResults('forward', $forward_reason, $params, $forward_url);
        
        if (isset($this->response_sent)) {
            // Response was sent from a forward event
            // Clearing handlers to void infinite loops
            return $this->response_sent;
        }

        if ($forward_url === REFERRER) {
            $forward_url = $this->getSiteRefererUrl();
        }

        $forward_url = $this->makeSecureForwardUrl($forward_url);

        switch ($status_code) {
            case 'system':
            case 'csrf':
                $status_code = ELGG_HTTP_OK;
                break;
            case 'admin':
            case 'login':
            case 'member':
            case 'walled_garden':
            default:
                $status_code = (int) $status_code;
                if (!$status_code || $status_code < 100 || $status_code > 599) {
                    $status_code = ELGG_HTTP_SEE_OTHER;
                }
                break;
        }

        if ($this->isXhr()) {
            if ($status_code < 100 || ($status_code >= 300 && $status_code <= 399) || $status_code > 599) {
                // We only want to preserve OK and error codes
                // Redirect responses should be converted to OK responses as this is an XHR request
                $status_code = ELGG_HTTP_OK;
            }
            
            $output = ob_get_clean();

            $response = new RedirectResponse($forward_url, $status_code);
            $response->setContent($output);
            $headers = $response->getHeaders();
            $headers['Content-Type'] = 'application/json; charset=UTF-8';
            $response->setHeaders($headers);
            return $this->respond($response);
        }

        if ($this->isAction()) {
            // actions should always redirect on non xhr-calls
            if (!is_int($status_code) || $status_code < 300 || $status_code > 399) {
                $status_code = ELGG_HTTP_SEE_OTHER;
            }
        }

        $response = new RedirectResponse($forward_url, $status_code);
        if ($response->isRedirection()) {
            return $this->send($this->prepareRedirectResponse($forward_url, $status_code));
        }
        
        return $this->respond($response);
    }

    public function parseContext(): string {
        $segments = $this->request->getUrlSegments();

        $identifier = array_shift($segments);
        switch ($identifier) {
            case 'ajax':
                $page = array_shift($segments);
                if ($page === 'view') {
                    $view = implode('/', $segments);
                    return "view:{$view}";
                } elseif ($page === 'form') {
                    $form = implode('/', $segments);
                    return "form:{$form}";
                }
                
                array_unshift($segments, $page);
                break;

            case 'action':
                $action = implode('/', $segments);
                return "action:{$action}";
        }

        array_unshift($segments, $identifier);
        $path = implode('/', $segments);
        return "path:{$path}";
    }

    public function isXhr(): bool {
        return $this->request->isXmlHttpRequest();
    }

    public function isAction(): bool {
        return str_starts_with($this->parseContext(), 'action:');
    }

    public function normalize($content = '') {
        if ($content instanceof \ElggEntity) {
            $content = (array) $content->toObject();
        }
        
        if (is_array($content)) {
            foreach ($content as $key => $value) {
                $content[$key] = $this->normalize($value);
            }
        }
        
        return $content;
    }

    public function stringify($content = ''): string {
        $content = $this->normalize($content);
        
        if (is_object($content) && is_callable([$content, '__toString'])) {
            return (string) $content;
        }
        
        if (is_scalar($content)) {
            return (string) $content;
        }
        
        if (empty($content)) {
            return '';
        }
        
        return json_encode($content, ELGG_JSON_ENCODING);
    }

    public function setTransport(ResponseTransport $transport): void {
        $this->transport = $transport;
    }
    
    protected function getSiteRefererUrl(): string {
        return (string) elgg_normalize_site_url((string) $this->request->headers->get('Referer'));
    }
    
    protected function makeSecureForwardUrl(string $url): string {
        $url = elgg_normalize_url($url);
        if (!preg_match('/^(http|https|ftp|sftp|ftps):\/\//', $url)) {
            return elgg_get_site_url();
        }
        
        return $url;
    }
    
    protected function closeSession(): void {
        $session = elgg_get_session();
        if ($session->isStarted()) {
            $session->save();
        }
    }
}