XAccel.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\FileDelivery\FileDeliveryTypes;

use ILIAS\FileDelivery\ilFileDeliveryType;
use ILIAS\Filesystem\Stream\FileStream;
use ILIAS\HTTP\Services;
use ILIAS\HTTP\Response\ResponseHeader;

final class XAccel implements ilFileDeliveryType
{
    use  HeaderBasedDeliveryHelper;
    public const DATA = 'data';
    public const SECURED_DATA = 'secured-data';
    public const X_ACCEL_REDIRECT = 'X-Accel-Redirect';


    public function __construct(private Services $httpService)
    {
    }

    public function doesFileExists(string $path_to_file): bool
    {
        return is_readable($path_to_file);
    }



    public function prepare(string $path_to_file, ?FileStream $possible_stream): bool
    {
        $response = $this->httpService->response()->withHeader(ResponseHeader::CONTENT_TYPE, '');

        $this->httpService->saveResponse($response);

        return true;
    }


    public function deliver(string $path_to_file, bool $file_marked_to_delete): void
    {
        // There is currently no way to delete the file after delivery
        if (str_starts_with($path_to_file, './' . self::DATA . '/')) {
            $path_to_file = str_replace('./' . self::DATA . '/', '/' . self::SECURED_DATA
                                                                 . '/', $path_to_file);
        }

        $response = $this->httpService->response();
        $delivery = function () use ($path_to_file, $response): void {
            $response = $response->withHeader(self::X_ACCEL_REDIRECT, $path_to_file);
            $this->httpService->saveResponse($response);
            $this->httpService->sendResponse();
        };

        if ($file_marked_to_delete) {
            $this->sendFileUnbufferedUsingHeaders($delivery);
        } else {
            $delivery();
        }
    }


    public function supportsInlineDelivery(): bool
    {
        return true;
    }


    public function supportsAttachmentDelivery(): bool
    {
        return true;
    }


    public function supportsStreaming(): bool
    {
        return true;
    }


    public function handleFileDeletion(string $path_to_file): bool
    {
        // No possibilities to do this at the moment
        return true;
    }
}