feat: Fix PHP 8.4 deprecations (#238)

* feat(dx): Split commands in Dockerfile to individual RUN to improve caching

* feat: Explicitly mark formatter as nullable

* chore: Change Dockerfile

Author: exaby73

src/Bolt/BoltDriver.php

@@ -65,7 +65,7 @@ public function __construct(
      *
      * @psalm-suppress MixedReturnTypeCoercion
      */
-    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, FormatterInterface $formatter = null): self
+    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, ?FormatterInterface $formatter = null): self
     {
         if (is_string($uri)) {
             $uri = Uri::create($uri);

src/Bolt/Session.php

@@ -79,7 +79,7 @@ public function runStatements(iterable $statements, ?TransactionConfiguration $c
     /**
      * @param iterable<Statement>|null $statements
      */
-    public function openTransaction(iterable $statements = null, ?TransactionConfiguration $config = null): UnmanagedTransactionInterface
+    public function openTransaction(?iterable $statements = null, ?TransactionConfiguration $config = null): UnmanagedTransactionInterface
     {
         return $this->beginTransaction($statements, $this->mergeTsxConfig($config));
     }

src/Common/GeneratorHelper.php

@@ -30,7 +30,7 @@ final class GeneratorHelper
      *
      * @return T
      */
-    public static function getReturnFromGenerator(Generator $generator, float $timeout = null)
+    public static function getReturnFromGenerator(Generator $generator, ?float $timeout = null)
     {
         $start = microtime(true);
         while ($generator->valid()) {

src/Databags/HttpPsrBindings.php

@@ -47,7 +47,7 @@ final class HttpPsrBindings
      * @param callable():StreamFactoryInterface|StreamFactoryInterface|null   $streamFactory
      * @param callable():RequestFactoryInterface|RequestFactoryInterface|null $requestFactory
      */
-    public function __construct(callable|ClientInterface|null $client = null, callable|StreamFactoryInterface $streamFactory = null, callable|RequestFactoryInterface $requestFactory = null)
+    public function __construct(callable|ClientInterface|null $client = null, callable|StreamFactoryInterface|null $streamFactory = null, callable|RequestFactoryInterface|null $requestFactory = null)
     {
         $this->client = $client ?? static fn (): ClientInterface => Psr18ClientDiscovery::find();
         $this->streamFactory = $streamFactory ?? static fn (): StreamFactoryInterface => Psr17FactoryDiscovery::findStreamFactory();
@@ -61,7 +61,7 @@ public function __construct(callable|ClientInterface|null $client = null, callab
      * @param callable():StreamFactoryInterface|StreamFactoryInterface|null   $streamFactory
      * @param callable():RequestFactoryInterface|RequestFactoryInterface|null $requestFactory
      */
-    public static function create(callable|ClientInterface $client = null, callable|StreamFactoryInterface $streamFactory = null, callable|RequestFactoryInterface $requestFactory = null): self
+    public static function create(callable|ClientInterface|null $client = null, callable|StreamFactoryInterface|null $streamFactory = null, callable|RequestFactoryInterface|null $requestFactory = null): self
     {
         return new self($client, $streamFactory, $requestFactory);
     }

src/DriverFactory.php

@@ -46,7 +46,7 @@ final class DriverFactory
      *           : DriverInterface<OGMResults>
      *           )
      */
-    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, FormatterInterface $formatter = null, ?string $logLevel = null, ?LoggerInterface $logger = null): DriverInterface
+    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, ?FormatterInterface $formatter = null, ?string $logLevel = null, ?LoggerInterface $logger = null): DriverInterface
     {
         if (is_string($uri)) {
             $uri = Uri::create($uri);
@@ -77,7 +77,7 @@ public static function create(string|UriInterface $uri, ?DriverConfiguration $co
      *           : DriverInterface<OGMResults>
      *           )
      */
-    private static function createBoltDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, FormatterInterface $formatter = null): DriverInterface
+    private static function createBoltDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, ?FormatterInterface $formatter = null): DriverInterface
     {
         if ($formatter !== null) {
             return BoltDriver::create($uri, $configuration, $authenticate, $formatter);
@@ -97,7 +97,7 @@ private static function createBoltDriver(string|UriInterface $uri, ?DriverConfig
      *           : DriverInterface<OGMResults>
      *           )
      */
-    private static function createNeo4jDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, FormatterInterface $formatter = null): DriverInterface
+    private static function createNeo4jDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, ?FormatterInterface $formatter = null): DriverInterface
     {
         if ($formatter !== null) {
             return Neo4jDriver::create($uri, $configuration, $authenticate, $formatter);
@@ -119,7 +119,7 @@ private static function createNeo4jDriver(string|UriInterface $uri, ?DriverConfi
      *
      * @pure
      */
-    private static function createHttpDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, FormatterInterface $formatter = null): DriverInterface
+    private static function createHttpDriver(string|UriInterface $uri, ?DriverConfiguration $configuration, ?AuthenticateInterface $authenticate, ?FormatterInterface $formatter = null): DriverInterface
     {
         if ($formatter !== null) {
             return HttpDriver::create($uri, $configuration, $authenticate, $formatter);

src/Exception/Neo4jException.php

@@ -34,7 +34,7 @@ final class Neo4jException extends RuntimeException
     /**
      * @param non-empty-list<Neo4jError> $errors
      */
-    public function __construct(array $errors, Throwable $previous = null)
+    public function __construct(array $errors, ?Throwable $previous = null)
     {
         $error = $errors[0];
         $message = sprintf(self::MESSAGE_TEMPLATE, $error->getCode(), $error->getMessage() ?? 'NULL');

src/Http/HttpDriver.php

@@ -70,7 +70,7 @@ public function __construct(
      *
      * @pure
      */
-    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, FormatterInterface $formatter = null): self
+    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, ?FormatterInterface $formatter = null): self
     {
         if (is_string($uri)) {
             $uri = Uri::create($uri);

src/Neo4j/Neo4jDriver.php

@@ -68,7 +68,7 @@ public function __construct(
      *
      * @psalm-suppress MixedReturnTypeCoercion
      */
-    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, FormatterInterface $formatter = null, ?AddressResolverInterface $resolver = null): self
+    public static function create(string|UriInterface $uri, ?DriverConfiguration $configuration = null, ?AuthenticateInterface $authenticate = null, ?FormatterInterface $formatter = null, ?AddressResolverInterface $resolver = null): self
     {
         if (is_string($uri)) {
             $uri = Uri::create($uri);

src/Neo4j/RoutingTable.php

@@ -45,7 +45,7 @@ public function getTtl(): int
      *
      * @return list<string>
      */
-    public function getWithRole(RoutingRoles $role = null): array
+    public function getWithRole(?RoutingRoles $role = null): array
     {
         /** @psalm-var list<string> $tbr */
         $tbr = [];

src/Types/AbstractCypherSequence.php

@@ -248,7 +248,7 @@ public function reversed(): self
      *
      * @psalm-mutation-free
      */
-    public function slice(int $offset, int $length = null): self
+    public function slice(int $offset, ?int $length = null): self
     {
         return $this->withOperation(function () use ($offset, $length) {
             if ($length !== 0) {

src/Types/Map.php

@@ -186,7 +186,7 @@ public function pairs(): ArrayList
      *
      * @return static<TValue>
      */
-    public function ksorted(callable $comparator = null): Map
+    public function ksorted(?callable $comparator = null): Map
     {
         return $this->withOperation(function () use ($comparator) {
             $pairs = $this->pairs()->sorted(static function (Pair $x, Pair $y) use ($comparator) {