fix cs to avoid deprecation in php 8.3

cli-config.doctrine_dbal.php.dist

@@ -7,16 +7,17 @@
  * Add instances of commands for eventual implementation specific commands to this array.
  */
 
-$extraCommands = array();
+$extraCommands = [];
 $extraCommands[] = new \Jackalope\Tools\Console\Command\InitDoctrineDbalCommand();
 
-$params = array(
+$params = [
     'driver'    => 'pdo_mysql',
     'host'      => '127.0.0.1',
     'user'      => 'root',
     'password'  => '',
     'dbname'    => 'phpcr_odm_tests',
-);
+    'charset'   => 'utf8mb4',
+];
 
 $dbConn = \Doctrine\DBAL\DriverManager::getConnection($params);
 
@@ -31,7 +32,7 @@ if (isset($argv[1])
     && $argv[1] != 'help'
 ) {
     $factory = new \Jackalope\RepositoryFactoryDoctrineDBAL();
-    $repository = $factory->getRepository(array('jackalope.doctrine_dbal_connection' => $dbConn));
+    $repository = $factory->getRepository(['jackalope.doctrine_dbal_connection' => $dbConn]);
     $credentials = new \PHPCR\SimpleCredentials(null, null);
     $session = $repository->login($credentials, $workspace);
 
@@ -44,11 +45,11 @@ if (isset($argv[1])
 
     $dm = \Doctrine\ODM\PHPCR\DocumentManager::create($session, $config);
 
-    $helperSet = new \Symfony\Component\Console\Helper\HelperSet(array(
+    $helperSet = new \Symfony\Component\Console\Helper\HelperSet([
         'phpcr' => new \PHPCR\Util\Console\Helper\PhpcrHelper($session),
         'phpcr_console_dumper' => new \PHPCR\Util\Console\Helper\PhpcrConsoleDumperHelper(),
         'dm' => new \Doctrine\ODM\PHPCR\Tools\Console\Helper\DocumentManagerHelper(null, $dm),
-    ));
+    ]);
 
     if (class_exists('Symfony\Component\Console\Helper\QuestionHelper')) {
         $helperSet->set(new \Symfony\Component\Console\Helper\QuestionHelper(), 'question');
@@ -57,7 +58,7 @@ if (isset($argv[1])
     }
 } elseif (isset($argv[1]) && $argv[1] == 'jackalope:init:dbal') {
     // special case: the init command needs the db connection, but a session is impossible if the db is not yet initialized
-    $helperSet = new \Symfony\Component\Console\Helper\HelperSet(array(
+    $helperSet = new \Symfony\Component\Console\Helper\HelperSet([
         'connection' => new \Jackalope\Tools\Console\Helper\DoctrineDbalHelper($dbConn)
-    ));
+    ]);
 }

cli-config.jackrabbit.php.dist

@@ -7,7 +7,7 @@
  * Add instances of commands for eventual implementation specific commands to this array.
  */
 
-$extraCommands = array();
+$extraCommands = [];
 $extraCommands[] = new \Jackalope\Tools\Console\Command\JackrabbitCommand();
 
 if (! isset($argv[1])
@@ -19,9 +19,9 @@ if (! isset($argv[1])
     return;
 }
 
-$params = array(
+$params = [
     'jackalope.jackrabbit_uri'  => 'http://127.0.0.1:8080/server/',
-);
+];
 
 $workspace = 'default';
 $user = 'admin';
@@ -42,11 +42,11 @@ $config->setMetadataDriverImpl($driver);
 
 $dm = \Doctrine\ODM\PHPCR\DocumentManager::create($session, $config);
 
-$helperSet = new \Symfony\Component\Console\Helper\HelperSet(array(
+$helperSet = new \Symfony\Component\Console\Helper\HelperSet([
     'phpcr' => new \PHPCR\Util\Console\Helper\PhpcrHelper($session),
     'phpcr_console_dumper' => new \PHPCR\Util\Console\Helper\PhpcrConsoleDumperHelper(),
     'dm' => new \Doctrine\ODM\PHPCR\Tools\Console\Helper\DocumentManagerHelper(null, $dm),
-));
+]);
 
 if (class_exists('Symfony\Component\Console\Helper\QuestionHelper')) {
     $helperSet->set(new \Symfony\Component\Console\Helper\QuestionHelper(), 'question');

docs/en/reference/installation-configuration.rst

@@ -82,6 +82,7 @@ Bootstrap will roughly look like this when using mysql as storage backend::
         'user'      => $user,
         'password'  => $pass,
         'dbname'    => 'phpcr_odm_tutorial',
+        'charset'   => 'utf8mb4', // only when using MySQL
     ];
 
     // Bootstrap Doctrine DBAL
@@ -253,6 +254,7 @@ A complete configuration could look like this::
         'user'      => $user,
         'password'  => $pass,
         'dbname'    => 'phpcr_odm_tutorial',
+        'charset'   => 'utf8mb4',
     ];
     $dbConn = \Doctrine\DBAL\DriverManager::getConnection($params);
     $parameters = ['jackalope.doctrine_dbal_connection' => $dbConn];

docs/en/reference/introduction.rst

@@ -100,6 +100,7 @@ your project root directory::
         'user'      => 'root',
         'password'  => '',
         'dbname'    => 'phpcr_odm_tutorial',
+        'charset'   => 'utf8mb4',
     ];
 
     $workspace = 'default';

lib/Doctrine/ODM/PHPCR/ChildrenCollection.php

@@ -36,7 +36,7 @@ class ChildrenCollection extends PersistentCollection
      * @param int               $fetchDepth Optional fetch depth, -1 to not override
      * @param string|null       $locale     The locale to use during the loading of this collection
      */
-    public function __construct(DocumentManagerInterface $dm, object $document, array|string $filter = null, int $fetchDepth = -1, string $locale = null)
+    public function __construct(DocumentManagerInterface $dm, object $document, array|string|null $filter = null, int $fetchDepth = -1, ?string $locale = null)
     {
         parent::__construct($dm);
         $this->document = $document;

lib/Doctrine/ODM/PHPCR/Decorator/DocumentManagerDecorator.php

@@ -133,7 +133,7 @@ public function createPhpcrQueryBuilder(): PhpcrQueryBuilder
         return $this->wrapped->createPhpcrQueryBuilder();
     }
 
-    public function getDocumentsByPhpcrQuery(QueryInterface $query, string $className = null, string $primarySelector = null): Collection
+    public function getDocumentsByPhpcrQuery(QueryInterface $query, ?string $className = null, ?string $primarySelector = null): Collection
     {
         return $this->wrapped->getDocumentsByPhpcrQuery($query, $className, $primarySelector);
     }
@@ -168,17 +168,17 @@ public function reorder(object $document, string $srcName, string $targetName, b
         $this->wrapped->reorder($document, $srcName, $targetName, $before);
     }
 
-    public function getChildren(object $document, array|string $filter = null, int $fetchDepth = -1, string $locale = null): ChildrenCollection
+    public function getChildren(object $document, array|string|null $filter = null, int $fetchDepth = -1, ?string $locale = null): ChildrenCollection
     {
         return $this->wrapped->getChildren($document, $filter, $fetchDepth, $locale);
     }
 
-    public function getReferrers(object $document, string $type = null, string $name = null, string $locale = null, string $refClass = null): ReferrersCollection
+    public function getReferrers(object $document, ?string $type = null, ?string $name = null, ?string $locale = null, ?string $refClass = null): ReferrersCollection
     {
         return $this->wrapped->getReferrers($document, $type, $name, $locale, $refClass);
     }
 
-    public function flush(object|array $document = null): void
+    public function flush(object|array|null $document = null): void
     {
         $this->wrapped->flush($document);
     }

lib/Doctrine/ODM/PHPCR/DocumentClassMapper.php

@@ -13,7 +13,7 @@
  */
 class DocumentClassMapper implements DocumentClassMapperInterface
 {
-    private function expandClassName(DocumentManagerInterface $dm, string $className = null): ?string
+    private function expandClassName(DocumentManagerInterface $dm, ?string $className = null): ?string
     {
         if (null === $className) {
             return null;
@@ -26,7 +26,7 @@ private function expandClassName(DocumentManagerInterface $dm, string $className
         return $className;
     }
 
-    public function getClassName(DocumentManagerInterface $dm, NodeInterface $node, string $className = null): string
+    public function getClassName(DocumentManagerInterface $dm, NodeInterface $node, ?string $className = null): string
     {
         $className = $this->expandClassName($dm, $className);
 

lib/Doctrine/ODM/PHPCR/DocumentClassMapperInterface.php

@@ -20,7 +20,7 @@ interface DocumentClassMapperInterface
      * @throws ClassMismatchException if $node represents a class that is not
      *                                a descendant of $className
      */
-    public function getClassName(DocumentManagerInterface $dm, NodeInterface $node, string $className = null): string;
+    public function getClassName(DocumentManagerInterface $dm, NodeInterface $node, ?string $className = null): string;
 
     /**
      * Write any relevant meta data into the node to be able to map back to a class name later.

lib/Doctrine/ODM/PHPCR/DocumentManager.php

@@ -61,7 +61,7 @@ class DocumentManager implements DocumentManagerInterface
     private LocaleChooserInterface $localeChooserStrategy;
     private ValueConverter $valueConverter;
 
-    public function __construct(SessionInterface $session, Configuration $config = null, EventManager $evm = null)
+    public function __construct(SessionInterface $session, ?Configuration $config = null, ?EventManager $evm = null)
     {
         $this->session = $session;
         $this->config = $config ?: new Configuration();
@@ -136,7 +136,7 @@ public function getPhpcrSession(): SessionInterface
     /**
      * Factory method to create a Document Manager.
      */
-    public static function create(SessionInterface $session, Configuration $config = null, EventManager $evm = null): DocumentManager
+    public static function create(SessionInterface $session, ?Configuration $config = null, ?EventManager $evm = null): DocumentManager
     {
         return new self($session, $config, $evm);
     }
@@ -342,7 +342,7 @@ public function createPhpcrQueryBuilder(): PhpcrQueryBuilder
         return new PhpcrQueryBuilder($qm->getQOMFactory());
     }
 
-    public function getDocumentsByPhpcrQuery(QueryInterface $query, string $className = null, string $primarySelector = null): Collection
+    public function getDocumentsByPhpcrQuery(QueryInterface $query, ?string $className = null, ?string $primarySelector = null): Collection
     {
         $this->errorIfClosed();
 
@@ -504,14 +504,14 @@ public function refresh($document): void
         $this->unitOfWork->refresh($document);
     }
 
-    public function getChildren(object $document, array|string $filter = null, int $fetchDepth = -1, string $locale = null): ChildrenCollection
+    public function getChildren(object $document, array|string|null $filter = null, int $fetchDepth = -1, ?string $locale = null): ChildrenCollection
     {
         $this->errorIfClosed();
 
         return new ChildrenCollection($this, $document, $filter, $fetchDepth, $locale);
     }
 
-    public function getReferrers(object $document, string $type = null, string $name = null, string $locale = null, $refClass = null): ReferrersCollection
+    public function getReferrers(object $document, ?string $type = null, ?string $name = null, ?string $locale = null, $refClass = null): ReferrersCollection
     {
         $this->errorIfClosed();
 
@@ -530,7 +530,7 @@ public function getReferrers(object $document, string $type = null, string $name
      * @throws InvalidArgumentException if $document is neither null nor a
      *                                  document or an array of documents
      */
-    public function flush(object|array $document = null): void
+    public function flush(object|array|null $document = null): void
     {
         if (null !== $document && !is_object($document) && !is_array($document)) {
             throw new InvalidArgumentException('Parameter $document needs to be an object, '.gettype($document).' given');

lib/Doctrine/ODM/PHPCR/DocumentManagerInterface.php

@@ -236,7 +236,7 @@ public function createPhpcrQueryBuilder(): PhpcrQueryBuilder;
      * @param string|null    $className       document class
      * @param string|null    $primarySelector name of the selector for the document to return in case of a join query
      */
-    public function getDocumentsByPhpcrQuery(QueryInterface $query, string $className = null, string $primarySelector = null): Collection;
+    public function getDocumentsByPhpcrQuery(QueryInterface $query, ?string $className = null, ?string $primarySelector = null): Collection;
 
     /**
      * Bind the translatable fields of the document in the specified locale.
@@ -331,7 +331,7 @@ public function reorder(object $document, string $srcName, string $targetName, b
      *
      * @throws InvalidArgumentException if $document is not an object
      */
-    public function getChildren(object $document, array|string $filter = null, int $fetchDepth = -1, string $locale = null): ChildrenCollection;
+    public function getChildren(object $document, array|string|null $filter = null, int $fetchDepth = -1, ?string $locale = null): ChildrenCollection;
 
     /**
      * Get the documents that refer a given document using an optional name.
@@ -353,7 +353,7 @@ public function getChildren(object $document, array|string $filter = null, int $
      *
      * @throws InvalidArgumentException if $document is not an object
      */
-    public function getReferrers(object $document, string $type = null, string $name = null, string $locale = null, string $refClass = null): ReferrersCollection;
+    public function getReferrers(object $document, ?string $type = null, ?string $name = null, ?string $locale = null, ?string $refClass = null): ReferrersCollection;
 
     /**
      * Gets a reference to the document identified by the given type and identifier
@@ -480,7 +480,7 @@ public function getUnitOfWork(): UnitOfWork;
      * @throws InvalidArgumentException if $document is neither null nor a
      *                                  document or an array of documents
      */
-    public function flush(object|array $document = null): void;
+    public function flush(object|array|null $document = null): void;
 
     /**
      * Closes the DocumentManager. All entities that are currently managed

lib/Doctrine/ODM/PHPCR/DocumentRepository.php

@@ -81,7 +81,7 @@ public function findAll(): Collection
      *
      * @return Collection the objects matching the criteria
      */
-    public function findBy(array $criteria, array $orderBy = null, int $limit = null, int $offset = null): Collection
+    public function findBy(array $criteria, ?array $orderBy = null, ?int $limit = null, ?int $offset = null): Collection
     {
         $qb = $this->createQueryBuilder('a');
 
@@ -199,7 +199,7 @@ public function getClassMetadata(): ClassMetadata
      *
      * @see \PHPCR\PropertyType
      */
-    public function quote(string $val, int $type = null): string
+    public function quote(string $val, ?int $type = null): string
     {
         return $this->dm->quote($val, $type);
     }

lib/Doctrine/ODM/PHPCR/Id/AssignedIdGenerator.php

@@ -15,7 +15,7 @@ class AssignedIdGenerator extends IdGenerator
      *
      * {@inheritdoc}
      */
-    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, object $parent = null): string
+    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, ?object $parent = null): string
     {
         if (!$class->identifier || !$id = $class->getFieldValue($document, $class->identifier)) {
             throw new IdException('ID could not be read from the document instance using the AssignedIdGenerator.');

lib/Doctrine/ODM/PHPCR/Id/AutoIdGenerator.php

@@ -17,7 +17,7 @@ class AutoIdGenerator extends ParentIdGenerator
      *
      * {@inheritdoc}
      */
-    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, object $parent = null): string
+    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, ?object $parent = null): string
     {
         if (null === $parent) {
             $parent = $class->parentMapping ? $class->getFieldValue($document, $class->parentMapping) : null;

lib/Doctrine/ODM/PHPCR/Id/IdException.php

@@ -55,7 +55,7 @@ public static function parentIdCouldNotBeDetermined(object $document, string $pa
         return new self($message);
     }
 
-    public static function illegalName(object $document, string $fieldName, string $nodeName, \Throwable $previous = null): self
+    public static function illegalName(object $document, string $fieldName, string $nodeName, ?\Throwable $previous = null): self
     {
         $message = sprintf(
             'Nodename property "%s" of document "%s" contains the illegal PHPCR value "%s".',

lib/Doctrine/ODM/PHPCR/Id/IdGenerator.php

@@ -44,5 +44,5 @@ public static function create(int $generatorType): IdGenerator
     /**
      * Generate the actual id, to be overwritten by extending classes.
      */
-    abstract public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, object $parent = null): string;
+    abstract public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, ?object $parent = null): string;
 }

lib/Doctrine/ODM/PHPCR/Id/ParentIdGenerator.php

@@ -16,7 +16,7 @@ class ParentIdGenerator extends IdGenerator
      *
      * {@inheritdoc}
      */
-    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, object $parent = null): string
+    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, ?object $parent = null): string
     {
         if (null === $parent) {
             $parent = $class->parentMapping ? $class->getFieldValue($document, $class->parentMapping) : null;

lib/Doctrine/ODM/PHPCR/Id/RepositoryIdGenerator.php

@@ -13,7 +13,7 @@ class RepositoryIdGenerator extends IdGenerator
      *
      * {@inheritdoc}
      */
-    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, object $parent = null): string
+    public function generate(object $document, ClassMetadata $class, DocumentManagerInterface $dm, ?object $parent = null): string
     {
         if (null === $parent) {
             $parent = $class->parentMapping ? $class->getFieldValue($document, $class->parentMapping) : null;

lib/Doctrine/ODM/PHPCR/Id/RepositoryIdInterface.php

@@ -7,5 +7,5 @@
  */
 interface RepositoryIdInterface
 {
-    public function generateId(object $document, object $parent = null): string;
+    public function generateId(object $document, ?object $parent = null): string;
 }

lib/Doctrine/ODM/PHPCR/Mapping/Attributes/Child.php

@@ -7,14 +7,14 @@
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class Child implements MappingAttribute
 {
-    public array|null $cascade;
+    public ?array $cascade;
 
     /**
      * @param string[]|string $cascade
      */
     public function __construct(
-        public null|string $nodeName = null,
-        array|string $cascade = null,
+        public ?string $nodeName = null,
+        array|string|null $cascade = null,
     ) {
         $this->cascade = null === $cascade ? null : (array) $cascade;
     }

lib/Doctrine/ODM/PHPCR/Mapping/Attributes/Children.php

@@ -7,18 +7,18 @@
 #[\Attribute(\Attribute::TARGET_PROPERTY)]
 final class Children implements MappingAttribute
 {
-    public array|null $filter;
-    public array|null $cascade;
+    public ?array $filter;
+    public ?array $cascade;
 
     /**
      * @param string[]|string $filter
      * @param string[]|string $cascade
      */
     public function __construct(
-        array|string $filter = null,
+        array|string|null $filter = null,
         public int $fetchDepth = -1,
         public bool $ignoreUntranslated = true,
-        array|string $cascade = null,
+        array|string|null $cascade = null,
     ) {
         $this->filter = null === $filter ? null : (array) $filter;
         $this->cascade = null === $cascade ? null : (array) $cascade;