[11.x] Add typed getters to session store

[AlexandreGerault]

Hi 😄

I previously submitted a PR #50140 for typed configuration getters that have been approved and then enhanced by #50287.

I tried to make the same features for the session store as I believe it can help to have static analysis. Not sure though the way I wrote the tests.

Let me know if any changes needed (and also I didn't find a pint or lint command)

EDIT: Tests for type errors are not correct, changing to draft

[AlexandreGerault]

I fixed the tests but I wonder if these could be more readable or more clean:

public function testSessionTypedGettersWithWrongTypes(): void
{
    $session = $this->getSession();
    $session->getHandler()->shouldReceive('read')->once()->with($this->getSessionId())->andReturn(serialize([
        'integer' => '12',
        'array' => null,
        'boolean' => 'true',
        'float' => '12.34',
        'string' => 12,
    ]));
    $session->start();

    $this->assertTypeError(fn () => $session->integer('integer'), 'integer');
    $this->assertTypeError(fn () => $session->array('array'), 'array');
    $this->assertTypeError(fn () => $session->boolean('boolean'), 'boolean');
    $this->assertTypeError(fn () => $session->float('float'), 'float');
    $this->assertTypeError(fn () => $session->string('string'), 'string');
}

private function assertTypeError(callable $callback, string $expectedType): void
{
    try {
        $callback();
        $this->fail("Expected TypeError for $expectedType type.");
    } catch (\TypeError $e) {
        $this->assertMatchesRegularExpression("/Session value for key \[(.*)\] must be (.*) {$expectedType}, (.*) given./", $e->getMessage());
    }
}

[taylorotwell]

I really am not sure this needs to propagate throughout the entire framework. 😬 Where else might this also apply?

[AlexandreGerault]

I don't know, I'm just figuring out when using the framework with static analysis (phpstan in my case)

I let the core team decide whether or not it has to be a framework feature. I guess if not it can still be done via the extend method of the container 😁(package ?)

[taylorotwell]

Going to hold off on this for now I think.