Completed
Push — middleware-wip ( ebb7ba...1dfeb0 )
by Romain
03:37
created

StepDispatchingMiddleware::process()   C

Complexity

Conditions 7
Paths 4

Size

Total Lines 36
Code Lines 19

Duplication

Lines 0
Ratio 0 %

Importance

Changes 0
Metric Value
dl 0
loc 36
rs 6.7272
c 0
b 0
f 0
cc 7
eloc 19
nc 4
nop 0
1
<?php
2
/*
3
 * 2017 Romain CANON <[email protected]>
4
 *
5
 * This file is part of the TYPO3 FormZ project.
6
 * It is free software; you can redistribute it and/or modify it
7
 * under the terms of the GNU General Public License, either
8
 * version 3 of the License, or any later version.
9
 *
10
 * For the full copyright and license information, see:
11
 * http://www.gnu.org/licenses/gpl-3.0.html
12
 */
13
14
namespace Romm\Formz\Middleware\Item\Step;
15
16
use Romm\Formz\Exceptions\InvalidArgumentTypeException;
17
use Romm\Formz\Middleware\Item\DefaultMiddleware;
18
use Romm\Formz\Middleware\Item\Step\Service\StepMiddlewareService;
19
use Romm\Formz\Middleware\Processor\PresetMiddlewareInterface;
20
21
/**
22
 * This middleware should be the last one called, as it is used to dispatch the
23
 * request to the next step, if there is one.
24
 */
25
class StepDispatchingMiddleware extends DefaultMiddleware implements PresetMiddlewareInterface
26
{
27
    /**
28
     * @var int
29
     */
30
    protected $priority = self::PRIORITY_STEP;
31
32
    /**
33
     * @var StepMiddlewareService
34
     */
35
    protected $service;
36
37
    /**
38
     * Inject the step service.
39
     */
40
    public function initializeMiddleware()
41
    {
42
        $this->service = StepMiddlewareService::get();
43
    }
44
45
    /**
46
     * @see StepDispatchingMiddleware
47
     */
48
    protected function process()
49
    {
50
        $formObject = $this->getFormObject();
51
        $formResult = $formObject->getFormResult();
52
53
        if ($formObject->getDefinition()->hasSteps()
54
            && $formObject->formWasSubmitted()
55
            && false === $formResult->hasErrors()
56
        ) {
57
            if ($formObject->getCurrentSubstepDefinition()
58
                && false === $formObject->getCurrentSubstepDefinition()->isLast()
59
            ) {
60
                return;
61
            }
62
63
            /*
64
             * The form was submitted, and no error was found, we can safely
65
             * dispatch the request to the next step.
66
             */
67
            $currentStep = $this->getCurrentStep();
68
            $currentStepDefinition = $this->service->getStepDefinition($currentStep);
0 ignored issues
show
Bug introduced by
It seems like $currentStep defined by $this->getCurrentStep() on line 67 can be null; however, Romm\Formz\Middleware\It...ce::getStepDefinition() does not accept null, maybe add an additional type check?

Unless you are absolutely sure that the expression can never be null because of other conditions, we strongly recommend to add an additional type check to your code:

/** @return stdClass|null */
function mayReturnNull() { }

function doesNotAcceptNull(stdClass $x) { }

// With potential error.
function withoutCheck() {
    $x = mayReturnNull();
    doesNotAcceptNull($x); // Potential error here.
}

// Safe - Alternative 1
function withCheck1() {
    $x = mayReturnNull();
    if ( ! $x instanceof stdClass) {
        throw new \LogicException('$x must be defined.');
    }
    doesNotAcceptNull($x);
}

// Safe - Alternative 2
function withCheck2() {
    $x = mayReturnNull();
    if ($x instanceof stdClass) {
        doesNotAcceptNull($x);
    }
}
Loading history...
69
70
            // Saving submitted form data for further usage.
71
            $this->service->markStepAsValidated($currentStep, $this->getFormRawValues());
0 ignored issues
show
Bug introduced by
It seems like $currentStep defined by $this->getCurrentStep() on line 67 can be null; however, Romm\Formz\Middleware\It...::markStepAsValidated() does not accept null, maybe add an additional type check?

Unless you are absolutely sure that the expression can never be null because of other conditions, we strongly recommend to add an additional type check to your code:

/** @return stdClass|null */
function mayReturnNull() { }

function doesNotAcceptNull(stdClass $x) { }

// With potential error.
function withoutCheck() {
    $x = mayReturnNull();
    doesNotAcceptNull($x); // Potential error here.
}

// Safe - Alternative 1
function withCheck1() {
    $x = mayReturnNull();
    if ( ! $x instanceof stdClass) {
        throw new \LogicException('$x must be defined.');
    }
    doesNotAcceptNull($x);
}

// Safe - Alternative 2
function withCheck2() {
    $x = mayReturnNull();
    if ($x instanceof stdClass) {
        doesNotAcceptNull($x);
    }
}
Loading history...
72
            $this->service->addValidatedFields($formResult->getValidatedFields());
73
74
            if ($currentStepDefinition->hasNextSteps()) {
75
                $nextStep = $currentStepDefinition
76
                    ->getNextSteps()
77
                    ->getDefaultStep()
78
                    ->getStep();
79
80
                $this->service->redirectToStep($nextStep, $this->redirect());
81
            }
82
        }
83
    }
84
85
    /**
86
     * Fetches the raw values sent in the request.
87
     *
88
     * @return array
89
     * @throws InvalidArgumentTypeException
90
     */
91
    protected function getFormRawValues()
92
    {
93
        $formName = $this->getFormObject()->getName();
94
        $formArray = null;
95
96
        if ($this->getRequest()->hasArgument($formName)) {
97
            /** @var array $formArray */
98
            $formArray = $this->getRequest()->getArgument($formName);
99
        }
100
101
        if (false === is_array($formArray)) {
102
            throw InvalidArgumentTypeException::formArgumentNotArray($this->getFormObject(), $formArray);
103
        }
104
105
        return $formArray;
106
    }
107
}
108