GlobalSession::offsetSet() - Code Metrics - Inspection of "Added `kill()` and `rotate()` methods." - jasny/session-middleware - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Push — master ( 407e74...eab238 )

by Arnold

created 2020-04-16 00:01 UTC

GlobalSession::offsetSet() A

↳ Parent: GlobalSession

Complexity

Conditions	1
Paths	1

Size

Total Lines	5
Code Lines	2

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	3
CRAP Score	1

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
cc	1
eloc	2
nc	1
nop	2
dl	0
loc	5
ccs	3
cts	3
cp	1
crap	1
rs	10
c	1
b	0
f	0

<?php

declare(strict_types=1);

namespace Jasny\Session;

use Jasny\Session\Flash\FlashBag;
use Jasny\Session\Flash\FlashTrait;

/**
 * Wrapper round $_SESSION.
 */
class GlobalSession implements SessionInterface
{
    use FlashTrait;

    /** @var array<string,mixed> */
    protected array $options;

    /**
     * Session constructor.
     *
     * @param array<string,mixed> $options   Passed to session_start()
     * @param FlashBag|null       $flashBag
     */
    public function __construct(array $options = [], ?FlashBag $flashBag = null)
    {
        $this->options = $options;
        $this->flashBag = $flashBag ?? new FlashBag();
    }

    /**
     * Start the session.
     * @see session_start()
     */
    public function start(): void
    {
        session_start($this->options);
    }

    /**
     * Write session data and end session.
     * @see session_write_close()
     */
    public function stop(): void
    {
        session_write_close();
    }

    /**
     * Discard session array changes and finish session.
     * @see session_abort()
     *
     * Only a shallow clone is done to save the original data. If the session data contains objects, make sure that
     *   `__clone()` is overwritten, so it does a deep clone.
     */
    public function abort(): void
    {
        session_abort();
    }


    /**
     * Get the sessions status.
     * @see session_status()
     */
    public function status(): int
    {
        return session_status();
    }


    /**
     * Clear all data from the session.
     */
    public function clear(): void
    {
        $this->assertStarted();

        $_SESSION = [];
    }

    /**
     * @inheritDoc
     */
    public function kill(): void
    {
        $this->assertStarted();

        $this->removeCookie(session_name());
        $_SESSION = [];
        session_destroy();
    }

    /**
     * Remove the session cookie.
     * @codeCoverageIgnore
     */
    protected function removeCookie(string $name): void
    {
        if (!(bool)ini_get("session.use_cookies")) {
            return;
        }

        $options = ['expires' => time() - 42000] + session_get_cookie_params();
        setcookie($name, '', $options);
    }

    /**
     * @inheritDoc
     */
    public function rotate(?callable $copy = null): void
    {
        $this->assertStarted();

        $data = isset($copy) ? $copy($_SESSION) : [];

        $_SESSION = [];
        $this->regenerateId(true);

        $_SESSION = $data;
    }

    /**
     * Wrapper around `session_regenerate_id()`
     * @codeCoverageIgnore
     */
    protected function regenerateId(bool $delete): void
    {
        session_regenerate_id($delete);
    }


    /**
     * @param string $offset
     * @return bool
     */
    public function offsetExists($offset): bool
    {
        $this->assertStarted();

        return array_key_exists($offset, $_SESSION);
    }

    /**
     * @param string $offset
     * @return mixed
     */
    public function offsetGet($offset)
    {
        $this->assertStarted();

        return $_SESSION[$offset];
    }

    /**
     * @param string $offset
     * @param mixed  $value
     */
    public function offsetSet($offset, $value): void

    {
        $this->assertStarted();

        $_SESSION[$offset] = $value;
    }

    /**
     * @param string $offset
     */
    public function offsetUnset($offset): void
    {
        $this->assertStarted();

        unset($_SESSION[$offset]);
    }


    /**
     * Assert that there is an active session.
     *
     * @throws NoSessionException
     */
    protected function assertStarted(): void
    {
        if (session_status() !== \PHP_SESSION_ACTIVE) {
            throw new NoSessionException("Session not started");
        }
    }
}


1		<?php
2
3		declare(strict_types=1);
4
5		namespace Jasny\Session;
6
7		use Jasny\Session\Flash\FlashBag;
8		use Jasny\Session\Flash\FlashTrait;
9
10		/**
11		* Wrapper round $_SESSION.
12		*/
13		class GlobalSession implements SessionInterface
14		{
15		use FlashTrait;
16
17		/** @var array<string,mixed> */
18		protected array $options;
19
20		/**
21		* Session constructor.
22		*
23		* @param array<string,mixed> $options Passed to session_start()
24		* @param FlashBag\|null $flashBag
25		*/
26	8	public function __construct(array $options = [], ?FlashBag $flashBag = null)
27		{
28	8	$this->options = $options;
29	8	$this->flashBag = $flashBag ?? new FlashBag();
30	8	}
31
32		/**
33		* Start the session.
34		* @see session_start()
35		*/
36	3	public function start(): void
37		{
38	3	session_start($this->options);
39	3	}
40
41		/**
42		* Write session data and end session.
43		* @see session_write_close()
44		*/
45	3	public function stop(): void
46		{
47	3	session_write_close();
48	3	}
49
50		/**
51		* Discard session array changes and finish session.
52		* @see session_abort()
53		*
54		* Only a shallow clone is done to save the original data. If the session data contains objects, make sure that
55		* `__clone()` is overwritten, so it does a deep clone.
56		*/
57	2	public function abort(): void
58		{
59	2	session_abort();
60	2	}
61
62
63		/**
64		* Get the sessions status.
65		* @see session_status()
66		*/
67	5	public function status(): int
68		{
69	5	return session_status();
70		}
71
72
73		/**
74		* Clear all data from the session.
75		*/
76	1	public function clear(): void
77		{
78	1	$this->assertStarted();
79
80	1	$_SESSION = [];
81	1	}
82
83		/**
84		* @inheritDoc
85		*/
86	1	public function kill(): void
87		{
88	1	$this->assertStarted();
89
90	1	$this->removeCookie(session_name());
91	1	$_SESSION = [];
92	1	session_destroy();
93	1	}
94
95		/**
96		* Remove the session cookie.
97		* @codeCoverageIgnore
98		*/
99		protected function removeCookie(string $name): void
100		{
101		if (!(bool)ini_get("session.use_cookies")) {
102		return;
103		}
104
105		$options = ['expires' => time() - 42000] + session_get_cookie_params();
106		setcookie($name, '', $options);
107		}
108
109		/**
110		* @inheritDoc
111		*/
112	1	public function rotate(?callable $copy = null): void
113		{
114	1	$this->assertStarted();
115
116	1	$data = isset($copy) ? $copy($_SESSION) : [];
117
118	1	$_SESSION = [];
119	1	$this->regenerateId(true);
120
121	1	$_SESSION = $data;
122	1	}
123
124		/**
125		* Wrapper around `session_regenerate_id()`
126		* @codeCoverageIgnore
127		*/
128		protected function regenerateId(bool $delete): void
129		{
130		session_regenerate_id($delete);
131		}
132
133
134		/**
135		* @param string $offset
136		* @return bool
137		*/
138	1	public function offsetExists($offset): bool
139		{
140	1	$this->assertStarted();
141
142	1	return array_key_exists($offset, $_SESSION);
143		}
144
145		/**
146		* @param string $offset
147		* @return mixed
148		*/
149	1	public function offsetGet($offset)
150		{
151	1	$this->assertStarted();
152
153	1	return $_SESSION[$offset];
154		}
155
156		/**
157		* @param string $offset
158		* @param mixed $value
159		*/
160	4	public function offsetSet($offset, $value): void
		0 ignored issues – show introduced 2020-04-16 00:07 UTC by Report Bug Copy Issue Report Parameter #1 $offset (string) of method Jasny\Session\GlobalSession::offsetSet() should be contravariant with parameter $offset (string\|null) of method ArrayAccess<string,mixed>::offsetSet() Loading history...
161		{
162	4	$this->assertStarted();
163
164	3	$_SESSION[$offset] = $value;
165	3	}
166
167		/**
168		* @param string $offset
169		*/
170	1	public function offsetUnset($offset): void
171		{
172	1	$this->assertStarted();
173
174	1	unset($_SESSION[$offset]);
175	1	}
176
177
178		/**
179		* Assert that there is an active session.
180		*
181		* @throws NoSessionException
182		*/
183	7	protected function assertStarted(): void
184		{
185	7	if (session_status() !== \PHP_SESSION_ACTIVE) {
186	1	throw new NoSessionException("Session not started");
187		}
188	6	}
189		}
190

jasny / session-middleware

Push — master ( 407e74...eab238 )

GlobalSession::offsetSet() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like