9443387603

Committed 10 Jun 2024 06:15AM UTC coverage: 0.0%. Remained the same

Build # 9443387603

Build Type

push

github

Committed by

renovate[bot]

Commit Message

[TASK] Allow typo3/coding-standards ^0.7.0

Run Details

0 of 701 relevant lines covered (0.0%)

0.0 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

0.0

/Classes/Controller/MailqueueModuleController.php

<?php

declare(strict_types=1);

/*
 * This file is part of the TYPO3 CMS extension "mailqueue".
 *
 * Copyright (C) 2024 Elias Häußler <e.haeussler@familie-redlich.de>
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 2 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 General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program. If not, see <https://www.gnu.org/licenses/>.
 */

namespace CPSIT\Typo3Mailqueue\Controller;

use CPSIT\Typo3Mailqueue\Configuration;
use CPSIT\Typo3Mailqueue\Enums;
use CPSIT\Typo3Mailqueue\Exception;
use CPSIT\Typo3Mailqueue\Mail;
use CPSIT\Typo3Mailqueue\Traits;
use Psr\Http\Message;
use Symfony\Component\Mailer;
use TYPO3\CMS\Backend;
use TYPO3\CMS\Core;
use TYPO3\CMS\Fluid;

/**
 * MailqueueModuleController
 *
 * @author Elias Häußler <e.haeussler@familie-redlich.de>
 * @license GPL-2.0-or-later
 */
final class MailqueueModuleController
{
    use Traits\TranslatableTrait;

    private readonly Core\Information\Typo3Version $typo3Version;

    public function __construct(
        private readonly Configuration\ExtensionConfiguration $extensionConfiguration,
        private readonly Core\Imaging\IconFactory $iconFactory,
        private readonly Backend\Template\ModuleTemplateFactory $moduleTemplateFactory,
        private readonly Core\Mail\Mailer $mailer,
        private readonly Backend\Routing\UriBuilder $uriBuilder,
        private readonly Core\Context\Context $context,
    ) {
        $this->typo3Version = new Core\Information\Typo3Version();
    }

    public function __invoke(Message\ServerRequestInterface $request): Message\ResponseInterface
    {
        $template = $this->moduleTemplateFactory->create($request);
        $transport = $this->mailer->getTransport();
        $page = $this->resolvePageIdFromRequest($request);
        $sendId = $request->getQueryParams()['send'] ?? null;
        $deleteId = $request->getQueryParams()['delete'] ?? null;

        // Force redirect when page selector was used
        if ($request->getMethod() === 'POST' && !isset($request->getQueryParams()['page'])) {
            return new Core\Http\RedirectResponse(
                $this->uriBuilder->buildUriFromRoute('system_mailqueue', ['page' => $page]),
            );
        }

        if ($transport instanceof Mail\Transport\QueueableTransport) {
            $templateVariables = $this->resolveTemplateVariables($transport, $page, $sendId, $deleteId);
        } else {
            $templateVariables = [
                'unsupportedTransport' => $this->getTransportFromMailConfiguration(),
                'typo3Version' => $this->typo3Version->getMajorVersion(),
            ];
        }

        // @todo Remove once support for TYPO3 v11 is dropped
        $templateVariables['layout'] = $this->typo3Version->getMajorVersion() < 12 ? 'Default' : 'Module';

        if (Core\Utility\ExtensionManagementUtility::isLoaded('lowlevel')) {
            $this->addLinkToConfigurationModule($template);
        }

        // @todo Remove once support for TYPO3 v11 is dropped
        if ($this->typo3Version->getMajorVersion() < 12) {
            return $this->renderLegacyTemplate($template, $templateVariables);
        }

        return $template
            ->assignMultiple($templateVariables)
            ->renderResponse('List')
        ;
    }

    private function resolvePageIdFromRequest(Message\ServerRequestInterface $request): int
    {
        $pageId = $request->getQueryParams()['page'] ?? null;

        if (\is_numeric($pageId)) {
            return (int)$pageId;
        }

        if (!\is_array($request->getParsedBody())) {
            return 1;
        }

        return (int)($request->getParsedBody()['page'] ?? 1);
    }

    /**
     * @return array{
     *     delayThreshold: positive-int,
     *     deleteResult: bool,
     *     failing: bool,
     *     longestPendingInterval: non-negative-int,
     *     pagination: Core\Pagination\SimplePagination,
     *     paginator: Core\Pagination\ArrayPaginator,
     *     queue: list<Mail\Queue\MailQueueItem>,
     *     sendResult: Enums\MailState|null,
     * }
     */
    private function resolveTemplateVariables(
        Mail\Transport\QueueableTransport $transport,
        int $currentPageNumber = 1,
        string $sendId = null,
        string $deleteId = null,
    ): array {
        $failing = false;
        $longestPendingInterval = 0;
        /** @var int $now */
        $now = $this->context->getPropertyFromAspect('date', 'timestamp');
        $sendResult = null;
        $deleteResult = false;

        if (is_string($sendId)) {
            $sendResult = $this->sendMail($transport, $sendId);
        }

        if (is_string($deleteId)) {
            $deleteResult = $this->deleteMail($transport, $deleteId);
        }

        foreach ($transport->getMailQueue() as $mailQueueItem) {
            if ($mailQueueItem->date !== null) {
                $longestPendingInterval = max($longestPendingInterval, $now - $mailQueueItem->date->getTimestamp());
            }

            if ($mailQueueItem->state === Enums\MailState::Failed) {
                $failing = true;
            }
        }

        $queue = $transport->getMailQueue()->get();
        $paginator = new Core\Pagination\ArrayPaginator(
            $queue,
            $currentPageNumber,
            $this->extensionConfiguration->getItemsPerPage(),
        );
        $pagination = new Core\Pagination\SimplePagination($paginator);

        return [
            'delayThreshold' => $this->extensionConfiguration->getQueueDelayThreshold(),
            'deleteResult' => $deleteResult,
            'failing' => $failing,
            'longestPendingInterval' => $longestPendingInterval,
            'pagination' => $pagination,
            'paginator' => $paginator,
            'queue' => $queue,
            'sendResult' => $sendResult,
        ];
    }

    private function sendMail(Mail\Transport\QueueableTransport $transport, string $queueItemId): Enums\MailState
    {
        $mailQueueItem = $this->getMailById($transport, $queueItemId);

        if ($mailQueueItem === null) {
            return Enums\MailState::AlreadySent;
        }

        try {
            $transport->dequeue($mailQueueItem, $this->mailer->getRealTransport());
        } catch (Mailer\Exception\TransportExceptionInterface) {
            return Enums\MailState::Failed;
        }

        return Enums\MailState::Sent;
    }

    private function deleteMail(Mail\Transport\QueueableTransport $transport, string $queueItemId): bool
    {
        $mailQueueItem = $this->getMailById($transport, $queueItemId);

        if ($mailQueueItem === null) {
            return false;
        }

        return $transport->delete($mailQueueItem);
    }

    private function getMailById(
        Mail\Transport\QueueableTransport $transport,
        string $queueItemId,
    ): ?Mail\Queue\MailQueueItem {
        foreach ($transport->getMailQueue() as $mailQueueItem) {
            if ($mailQueueItem->id === $queueItemId) {
                return $mailQueueItem;
            }
        }

        return null;
    }

    private function addLinkToConfigurationModule(Backend\Template\ModuleTemplate $template): void
    {
        $buttonBar = $template->getDocHeaderComponent()->getButtonBar();

        $button = $buttonBar->makeLinkButton();
        $button->setHref(
            (string)$this->uriBuilder->buildUriFromRoute(
                'system_config',
                ['node' => ['MAIL' => 1], 'tree' => 'confVars'],
            )
        );
        $button->setIcon($this->iconFactory->getIcon('actions-cog', Core\Imaging\Icon::SIZE_SMALL));
        $button->setTitle(self::translate('button.config'));
        $button->setShowLabelText(true);

        $buttonBar->addButton($button);
    }

    /**
     * @throws Exception\MailTransportIsNotConfigured
     */
    private function getTransportFromMailConfiguration(): string
    {
        $mailConfiguration = $GLOBALS['TYPO3_CONF_VARS']['MAIL'] ?? null;

        if (!\is_array($mailConfiguration)) {
            throw new Exception\MailTransportIsNotConfigured();
        }

        $spoolType = $mailConfiguration['transport_spool_type'] ?? null;

        if (is_string($spoolType) && trim($spoolType) !== '') {
            return $spoolType;
        }

        $transport = $mailConfiguration['transport'] ?? null;

        if (is_string($transport) && trim($transport) !== '') {
            return $transport;
        }

        throw new Exception\MailTransportIsNotConfigured();
    }

    /**
     * @todo Remove once support for TYPO3 v11 is dropped
     *
     * @param array<string, mixed> $templateVariables
     */
    private function renderLegacyTemplate(
        Backend\Template\ModuleTemplate $template,
        array $templateVariables,
    ): Core\Http\HtmlResponse {
        $view = Core\Utility\GeneralUtility::makeInstance(Fluid\View\StandaloneView::class);
        $view->setTemplateRootPaths(['EXT:mailqueue/Resources/Private/Templates/']);
        $view->setPartialRootPaths(['EXT:mailqueue/Resources/Private/Partials/']);
        $view->setLayoutRootPaths(['EXT:mailqueue/Resources/Private/Layouts/']);
        $view->setTemplate('List');
        $view->assignMultiple($templateVariables);

        $template->setContent($view->render());

        return new Core\Http\HtmlResponse($template->renderContent());
    }
}

1	<?php
2
3	declare(strict_types=1);
4
5	/*
6	* This file is part of the TYPO3 CMS extension "mailqueue".
7	*
8	* Copyright (C) 2024 Elias Häußler <e.haeussler@familie-redlich.de>
9	*
10	* This program is free software: you can redistribute it and/or modify
11	* it under the terms of the GNU General Public License as published by
12	* the Free Software Foundation, either version 2 of the License, or
13	* (at your option) any later version.
14	*
15	* This program is distributed in the hope that it will be useful,
16	* but WITHOUT ANY WARRANTY; without even the implied warranty of
17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18	* GNU General Public License for more details.
19	*
20	* You should have received a copy of the GNU General Public License
21	* along with this program. If not, see <https://www.gnu.org/licenses/>.
22	*/
23
24	namespace CPSIT\Typo3Mailqueue\Controller;
25
26	use CPSIT\Typo3Mailqueue\Configuration;
27	use CPSIT\Typo3Mailqueue\Enums;
28	use CPSIT\Typo3Mailqueue\Exception;
29	use CPSIT\Typo3Mailqueue\Mail;
30	use CPSIT\Typo3Mailqueue\Traits;
31	use Psr\Http\Message;
32	use Symfony\Component\Mailer;
33	use TYPO3\CMS\Backend;
34	use TYPO3\CMS\Core;
35	use TYPO3\CMS\Fluid;
36
37	/**
38	* MailqueueModuleController
39	*
40	* @author Elias Häußler <e.haeussler@familie-redlich.de>
41	* @license GPL-2.0-or-later
42	*/
43	final class MailqueueModuleController
44	{
45	use Traits\TranslatableTrait;
46
47	private readonly Core\Information\Typo3Version $typo3Version;
48
49	public function __construct(	×
50	private readonly Configuration\ExtensionConfiguration $extensionConfiguration,
51	private readonly Core\Imaging\IconFactory $iconFactory,
52	private readonly Backend\Template\ModuleTemplateFactory $moduleTemplateFactory,
53	private readonly Core\Mail\Mailer $mailer,
54	private readonly Backend\Routing\UriBuilder $uriBuilder,
55	private readonly Core\Context\Context $context,
56	) {
57	$this->typo3Version = new Core\Information\Typo3Version();	×
58	}
59
60	public function __invoke(Message\ServerRequestInterface $request): Message\ResponseInterface	×
61	{
62	$template = $this->moduleTemplateFactory->create($request);	×
63	$transport = $this->mailer->getTransport();	×
64	$page = $this->resolvePageIdFromRequest($request);	×
65	$sendId = $request->getQueryParams()['send'] ?? null;	×
66	$deleteId = $request->getQueryParams()['delete'] ?? null;	×
67
68	// Force redirect when page selector was used
69	if ($request->getMethod() === 'POST' && !isset($request->getQueryParams()['page'])) {	×
70	return new Core\Http\RedirectResponse(	×
71	$this->uriBuilder->buildUriFromRoute('system_mailqueue', ['page' => $page]),	×
72	);	×
73	}
74
75	if ($transport instanceof Mail\Transport\QueueableTransport) {	×
76	$templateVariables = $this->resolveTemplateVariables($transport, $page, $sendId, $deleteId);	×
77	} else {
78	$templateVariables = [	×
79	'unsupportedTransport' => $this->getTransportFromMailConfiguration(),	×
80	'typo3Version' => $this->typo3Version->getMajorVersion(),	×
81	];	×
82	}
83
84	// @todo Remove once support for TYPO3 v11 is dropped
85	$templateVariables['layout'] = $this->typo3Version->getMajorVersion() < 12 ? 'Default' : 'Module';	×
86
87	if (Core\Utility\ExtensionManagementUtility::isLoaded('lowlevel')) {	×
88	$this->addLinkToConfigurationModule($template);	×
89	}
90
91	// @todo Remove once support for TYPO3 v11 is dropped
92	if ($this->typo3Version->getMajorVersion() < 12) {	×
93	return $this->renderLegacyTemplate($template, $templateVariables);	×
94	}
95
96	return $template	×
97	->assignMultiple($templateVariables)	×
98	->renderResponse('List')	×
99	;	×
100	}
101
102	private function resolvePageIdFromRequest(Message\ServerRequestInterface $request): int	×
103	{
104	$pageId = $request->getQueryParams()['page'] ?? null;	×
105
106	if (\is_numeric($pageId)) {	×
107	return (int)$pageId;	×
108	}
109
110	if (!\is_array($request->getParsedBody())) {	×
111	return 1;	×
112	}
113
114	return (int)($request->getParsedBody()['page'] ?? 1);	×
115	}
116
117	/**
118	* @return array{
119	* delayThreshold: positive-int,
120	* deleteResult: bool,
121	* failing: bool,
122	* longestPendingInterval: non-negative-int,
123	* pagination: Core\Pagination\SimplePagination,
124	* paginator: Core\Pagination\ArrayPaginator,
125	* queue: list<Mail\Queue\MailQueueItem>,
126	* sendResult: Enums\MailState\|null,
127	* }
128	*/
129	private function resolveTemplateVariables(	×
130	Mail\Transport\QueueableTransport $transport,
131	int $currentPageNumber = 1,
132	string $sendId = null,
133	string $deleteId = null,
134	): array {
135	$failing = false;	×
136	$longestPendingInterval = 0;	×
137	/** @var int $now */
138	$now = $this->context->getPropertyFromAspect('date', 'timestamp');	×
139	$sendResult = null;	×
140	$deleteResult = false;	×
141
142	if (is_string($sendId)) {	×
143	$sendResult = $this->sendMail($transport, $sendId);	×
144	}
145
146	if (is_string($deleteId)) {	×
147	$deleteResult = $this->deleteMail($transport, $deleteId);	×
148	}
149
150	foreach ($transport->getMailQueue() as $mailQueueItem) {	×
151	if ($mailQueueItem->date !== null) {	×
152	$longestPendingInterval = max($longestPendingInterval, $now - $mailQueueItem->date->getTimestamp());	×
153	}
154
155	if ($mailQueueItem->state === Enums\MailState::Failed) {	×
156	$failing = true;	×
157	}
158	}
159
160	$queue = $transport->getMailQueue()->get();	×
161	$paginator = new Core\Pagination\ArrayPaginator(	×
162	$queue,	×
163	$currentPageNumber,	×
164	$this->extensionConfiguration->getItemsPerPage(),	×
165	);	×
166	$pagination = new Core\Pagination\SimplePagination($paginator);	×
167
168	return [	×
169	'delayThreshold' => $this->extensionConfiguration->getQueueDelayThreshold(),	×
170	'deleteResult' => $deleteResult,	×
171	'failing' => $failing,	×
172	'longestPendingInterval' => $longestPendingInterval,	×
173	'pagination' => $pagination,	×
174	'paginator' => $paginator,	×
175	'queue' => $queue,	×
176	'sendResult' => $sendResult,	×
177	];	×
178	}
179
180	private function sendMail(Mail\Transport\QueueableTransport $transport, string $queueItemId): Enums\MailState	×
181	{
182	$mailQueueItem = $this->getMailById($transport, $queueItemId);	×
183
184	if ($mailQueueItem === null) {	×
185	return Enums\MailState::AlreadySent;	×
186	}
187
188	try {
189	$transport->dequeue($mailQueueItem, $this->mailer->getRealTransport());	×
190	} catch (Mailer\Exception\TransportExceptionInterface) {	×
191	return Enums\MailState::Failed;	×
192	}
193
194	return Enums\MailState::Sent;	×
195	}
196
197	private function deleteMail(Mail\Transport\QueueableTransport $transport, string $queueItemId): bool	×
198	{
199	$mailQueueItem = $this->getMailById($transport, $queueItemId);	×
200
201	if ($mailQueueItem === null) {	×
202	return false;	×
203	}
204
205	return $transport->delete($mailQueueItem);	×
206	}
207
208	private function getMailById(	×
209	Mail\Transport\QueueableTransport $transport,
210	string $queueItemId,
211	): ?Mail\Queue\MailQueueItem {
212	foreach ($transport->getMailQueue() as $mailQueueItem) {	×
213	if ($mailQueueItem->id === $queueItemId) {	×
214	return $mailQueueItem;	×
215	}
216	}
217
218	return null;	×
219	}
220
221	private function addLinkToConfigurationModule(Backend\Template\ModuleTemplate $template): void	×
222	{
223	$buttonBar = $template->getDocHeaderComponent()->getButtonBar();	×
224
225	$button = $buttonBar->makeLinkButton();	×
226	$button->setHref(	×
227	(string)$this->uriBuilder->buildUriFromRoute(	×
228	'system_config',	×
229	['node' => ['MAIL' => 1], 'tree' => 'confVars'],	×
230	)	×
231	);	×
232	$button->setIcon($this->iconFactory->getIcon('actions-cog', Core\Imaging\Icon::SIZE_SMALL));	×
233	$button->setTitle(self::translate('button.config'));	×
234	$button->setShowLabelText(true);	×
235
236	$buttonBar->addButton($button);	×
237	}
238
239	/**
240	* @throws Exception\MailTransportIsNotConfigured
241	*/
242	private function getTransportFromMailConfiguration(): string	×
243	{
244	$mailConfiguration = $GLOBALS['TYPO3_CONF_VARS']['MAIL'] ?? null;	×
245
246	if (!\is_array($mailConfiguration)) {	×
247	throw new Exception\MailTransportIsNotConfigured();	×
248	}
249
250	$spoolType = $mailConfiguration['transport_spool_type'] ?? null;	×
251
252	if (is_string($spoolType) && trim($spoolType) !== '') {	×
253	return $spoolType;	×
254	}
255
256	$transport = $mailConfiguration['transport'] ?? null;	×
257
258	if (is_string($transport) && trim($transport) !== '') {	×
259	return $transport;	×
260	}
261
262	throw new Exception\MailTransportIsNotConfigured();	×
263	}
264
265	/**
266	* @todo Remove once support for TYPO3 v11 is dropped
267	*
268	* @param array<string, mixed> $templateVariables
269	*/
270	private function renderLegacyTemplate(	×
271	Backend\Template\ModuleTemplate $template,
272	array $templateVariables,
273	): Core\Http\HtmlResponse {
274	$view = Core\Utility\GeneralUtility::makeInstance(Fluid\View\StandaloneView::class);	×
275	$view->setTemplateRootPaths(['EXT:mailqueue/Resources/Private/Templates/']);	×
276	$view->setPartialRootPaths(['EXT:mailqueue/Resources/Private/Partials/']);	×
277	$view->setLayoutRootPaths(['EXT:mailqueue/Resources/Private/Layouts/']);	×
278	$view->setTemplate('List');	×
279	$view->assignMultiple($templateVariables);	×
280
281	$template->setContent($view->render());	×
282
283	return new Core\Http\HtmlResponse($template->renderContent());	×
284	}
285	}

CPS-IT / mailqueue / 9443387603

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous