Skip to content

Firefly III: a personal finances manager

7.4 KB
Raw Blame
<?php

/**
 * AttachmentController.php
 * Copyright (c) 2019 [email protected]
 *
 * This file is part of Firefly III (https://github.com/firefly-iii).
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
declare(strict_types=1);

namespace FireflyIII\Http\Controllers;

use FireflyIII\Exceptions\FireflyException;
use FireflyIII\Http\Requests\AttachmentFormRequest;
use FireflyIII\Models\Attachment;
use FireflyIII\Repositories\Attachment\AttachmentRepositoryInterface;
use FireflyIII\Support\Facades\Preferences;
use Illuminate\Contracts\View\Factory;
use Illuminate\Http\RedirectResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response as LaravelResponse;
use Illuminate\View\View;

/**
 * Class AttachmentController.
 */
final class AttachmentController extends Controller
{
    private AttachmentRepositoryInterface $repository;

    /**
     * AttachmentController constructor.
     */
    public function __construct()
    {
        parent::__construct();

        // translations:
        $this->middleware(function ($request, $next) {
            app('view')->share('mainTitleIcon', 'bi-paperclip');
            app('view')->share('title', (string) trans('firefly.attachments'));
            $this->repository = app(AttachmentRepositoryInterface::class);

            return $next($request);
        });
    }

    /**
     * Form to delete an attachment.
     *
     * @return Factory|View
     */
    public function delete(Attachment $attachment): Factory|\Illuminate\Contracts\View\View
    {
        $subTitle = (string) trans('firefly.delete_attachment', ['name' => $attachment->filename]);

        // put previous url in session
        $this->rememberPreviousUrl('attachments.delete.url');

        return view('attachments.delete', ['attachment' => $attachment, 'subTitle' => $subTitle]);
    }

    /**
     * Destroy attachment.
     */
    public function destroy(Request $request, Attachment $attachment): RedirectResponse
    {
        $name = $attachment->filename;

        $this->repository->destroy($attachment);

        $request->session()->flash('success', (string) trans('firefly.attachment_deleted', ['name' => $name]));
        Preferences::mark();

        return redirect($this->getPreviousUrl('attachments.delete.url'));
    }

    /**
     * Download attachment to PC.
     *
     * @return LaravelResponse|View
     *
     * @throws FireflyException
     */
    public function download(Attachment $attachment)
    {
        if ($this->repository->exists($attachment)) {
            $content  = $this->repository->getContent($attachment);
            $quoted   = sprintf('"%s"', addcslashes(basename($attachment->filename), '"\\'));

            /** @var LaravelResponse $response */
            $response = response($content);
            $response
                ->header('Content-Description', 'File Transfer')
                ->header('Content-Type', 'application/octet-stream')
                ->header('Content-Disposition', 'attachment; filename='.$quoted)
                ->header('Content-Transfer-Encoding', 'binary')
                ->header('Connection', 'Keep-Alive')
                ->header('Expires', '0')
                ->header('Cache-Control', 'must-revalidate, post-check=0, pre-check=0')
                ->header('Pragma', 'public')
                ->header('Content-Length', (string) strlen($content))
            ;

            return $response;
        }
        $message = 'Could not find the indicated attachment. The file is no longer there.';

        return view('errors.error', ['message' => $message]);
    }

    /**
     * Edit an attachment.
     *
     * @return Factory|View
     */
    public function edit(Request $request, Attachment $attachment): Factory|\Illuminate\Contracts\View\View
    {
        $subTitleIcon = 'bi-pencil';
        $subTitle     = (string) trans('firefly.edit_attachment', ['name' => $attachment->filename]);

        // put previous url in session if not redirect from store (not "return_to_edit").
        if (true !== session('attachments.edit.fromUpdate')) {
            $this->rememberPreviousUrl('attachments.edit.url');
        }
        $request->session()->forget('attachments.edit.fromUpdate');
        $preFilled    = ['notes' => $this->repository->getNoteText($attachment)];
        $request->session()->flash('preFilled', $preFilled);

        return view('attachments.edit', ['attachment' => $attachment, 'subTitleIcon' => $subTitleIcon, 'subTitle' => $subTitle]);
    }

    /**
     * Index of all attachments.
     *
     * @return Factory|View
     */
    public function index(): Factory|\Illuminate\Contracts\View\View
    {
        $set = $this->repository->get()->reverse();
        $set = $set->each(function (Attachment $attachment): Attachment {
            $attachment->file_exists = $this->repository->exists($attachment);

            return $attachment;
        });

        return view('attachments.index', ['set' => $set]);
    }

    /**
     * Update attachment.
     */
    public function update(AttachmentFormRequest $request, Attachment $attachment): RedirectResponse
    {
        $data     = $request->getAttachmentData();
        $this->repository->update($attachment, $data);

        $request->session()->flash('success', (string) trans('firefly.attachment_updated', ['name' => $attachment->filename]));
        Preferences::mark();

        $redirect = redirect($this->getPreviousUrl('attachments.edit.url'));
        if (1 === (int) $request->input('return_to_edit')) {
            $request->session()->put('attachments.edit.fromUpdate', true);

            $redirect = redirect(route('attachments.edit', [$attachment->id]))->withInput(['return_to_edit' => 1]);
        }

        // redirect to previous URL.
        return $redirect;
    }

    /**
     * View attachment in browser.
     *
     * @throws FireflyException
     */
    public function view(Attachment $attachment): LaravelResponse|View
    {
        if ($this->repository->exists($attachment)) {
            $content = $this->repository->getContent($attachment);

            // prevent XSS by adding a new secure header.
            $csp     = [
                "default-src 'none'",
                "object-src 'none'",
                "script-src 'none'",
                "style-src 'self' 'unsafe-inline'",
                "base-uri 'none'",
                "font-src 'none'",
                "connect-src 'none'",
                "img-src 'self'",
                "manifest-src 'none'",
            ];

            return response()->make($content, 200, [
                'Content-Security-Policy' => implode('; ', $csp),
                'Content-Type'            => $attachment->mime,
                'Content-Disposition'     => 'inline; filename="'.$attachment->filename.'"',
            ]);
        }

        $message = 'Could not find the indicated attachment. The file is no longer there.';

        return view('errors.error', ['message' => $message]);
    }
}