Merge branch '2.10.x' into 2.11.x

* 2.10.x:
  Bump PHPStan & Psalm (doctrine#9303)
  Removing list "Lifecycle Events" (doctrine#9243)
  Drop unneeded backslashes
  Fix Hidden fields triggering error when using getSingleScalarResult() (doctrine#8340)
  Findby joined lookup (doctrine#8285)

Author: derrabus

composer.json

@@ -43,12 +43,12 @@
         "doctrine/annotations": "^1.13",
         "doctrine/coding-standard": "^9.0",
         "phpbench/phpbench": "^0.16.10 || ^1.0",
-        "phpstan/phpstan": "1.2.0",
+        "phpstan/phpstan": "1.3.0",
         "phpunit/phpunit": "^7.5 || ^8.5 || ^9.4",
         "squizlabs/php_codesniffer": "3.6.2",
         "symfony/cache": "^4.4 || ^5.4 || ^6.0",
         "symfony/yaml": "^3.4 || ^4.0 || ^5.0 || ^6.0",
-        "vimeo/psalm": "4.15.0"
+        "vimeo/psalm": "4.16.1"
     },
     "conflict": {
         "doctrine/annotations": "<1.13 || >= 2.0"

docs/en/reference/dql-doctrine-query-language.rst

@@ -730,7 +730,7 @@ clauses:
 -  ``SQRT(q)`` - Return the square-root of q.
 -  ``SUBSTRING(str, start [, length])`` - Return substring of given
    string.
--  ``TRIM([LEADING \| TRAILING \| BOTH] ['trchar' FROM] str)`` - Trim
+-  ``TRIM([LEADING | TRAILING | BOTH] ['trchar' FROM] str)`` - Trim
    the string by the given trim char, defaults to whitespaces.
 -  ``UPPER(str)`` - Return the upper-case of the given string.
 -  ``DATE_ADD(date, value, unit)`` - Add the given time to a given date.

docs/en/reference/events.rst

@@ -521,6 +521,8 @@ For each cascade operation that gets activated, Doctrine also
 applies that operation to the association, be it single or
 collection valued.
 
+.. _persistence-by-reachability:
+
 Persistence by Reachability: Cascade Persist
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/en/reference/working-with-associations.rst

@@ -32,12 +32,12 @@ protected function hydrateAllData()
             throw new NonUniqueResultException('The query returned multiple rows. Change the query or use a different result function like getScalarResult().');
         }
 
-        if (count($data[key($data)]) > 1) {
+        $result = $this->gatherScalarRowData($data[key($data)]);
+
+        if (count($result) > 1) {
             throw new NonUniqueResultException('The query returned a row containing multiple columns. Change the query or use a different result function like getScalarResult().');
         }
 
-        $result = $this->gatherScalarRowData($data[key($data)]);
-
         return array_shift($result);
     }
 }

lib/Doctrine/ORM/Internal/Hydration/SingleScalarHydrator.php

@@ -1932,36 +1932,42 @@ private function getValues($value): array
             return [$newValue];
         }
 
-        if (is_object($value) && $this->em->getMetadataFactory()->hasMetadataFor(ClassUtils::getClass($value))) {
-            $class = $this->em->getClassMetadata(get_class($value));
-            if ($class->isIdentifierComposite) {
-                $newValue = [];
-
-                foreach ($class->getIdentifierValues($value) as $innerValue) {
-                    $newValue = array_merge($newValue, $this->getValues($innerValue));
-                }
-
-                return $newValue;
-            }
-        }
-
-        return [$this->getIndividualValue($value)];
+        return $this->getIndividualValue($value);
     }
 
     /**
      * Retrieves an individual parameter value.
      *
      * @param mixed $value
      *
-     * @return mixed
+     * @return       array<mixed>
+     * @psalm-return list<mixed>
      */
     private function getIndividualValue($value)
     {
-        if (! is_object($value) || ! $this->em->getMetadataFactory()->hasMetadataFor(ClassUtils::getClass($value))) {
-            return $value;
+        if (! is_object($value)) {
+            return [$value];
+        }
+
+        $valueClass = ClassUtils::getClass($value);
+
+        if ($this->em->getMetadataFactory()->isTransient($valueClass)) {
+            return [$value];
+        }
+
+        $class = $this->em->getClassMetadata($valueClass);
+
+        if ($class->isIdentifierComposite) {
+            $newValue = [];
+
+            foreach ($class->getIdentifierValues($value) as $innerValue) {
+                $newValue = array_merge($newValue, $this->getValues($innerValue));
+            }
+
+            return $newValue;
         }
 
-        return $this->em->getUnitOfWork()->getSingleIdentifierValue($value);
+        return [$this->em->getUnitOfWork()->getSingleIdentifierValue($value)];
     }
 
     /**

lib/Doctrine/ORM/Persisters/Entity/BasicEntityPersister.php

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<files psalm-version="v4.15.0@a1b5e489e6fcebe40cb804793d964e99fc347820">
+<files psalm-version="4.16.1@aa7e400908833b10c0333861f86cd48c510b60eb">
   <file src="lib/Doctrine/ORM/AbstractQuery.php">
     <DeprecatedClass occurrences="1">
       <code>IterableResult</code>
@@ -3467,17 +3467,12 @@
     <DeprecatedMethod occurrences="1">
       <code>canEmulateSchemas</code>
     </DeprecatedMethod>
-    <DocblockTypeContradiction occurrences="2">
-      <code>! $definingClass</code>
-      <code>$definingClass</code>
-    </DocblockTypeContradiction>
     <MissingClosureParamType occurrences="1">
       <code>$asset</code>
     </MissingClosureParamType>
-    <PossiblyNullArrayAccess occurrences="2">
-      <code>$definingClass</code>
+    <PossiblyNullArgument occurrences="1">
       <code>$referencedFieldName</code>
-    </PossiblyNullArrayAccess>
+    </PossiblyNullArgument>
     <PossiblyNullReference occurrences="1">
       <code>getColumns</code>
     </PossiblyNullReference>

psalm-baseline.xml

@@ -0,0 +1,97 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\Tests\ORM\Functional\Ticket;
+
+use Doctrine\Common\Collections\Collection;
+use Doctrine\ORM\Mapping\Column;
+use Doctrine\ORM\Mapping\DiscriminatorMap;
+use Doctrine\ORM\Mapping\Entity;
+use Doctrine\ORM\Mapping\GeneratedValue;
+use Doctrine\ORM\Mapping\Id;
+use Doctrine\ORM\Mapping\InheritanceType;
+use Doctrine\ORM\Mapping\ManyToOne;
+use Doctrine\ORM\Mapping\OneToMany;
+use Doctrine\Tests\OrmFunctionalTestCase;
+
+class GH7512Test extends OrmFunctionalTestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $this->setUpEntitySchema([
+            GH7512EntityA::class,
+            GH7512EntityB::class,
+            GH7512EntityC::class,
+        ]);
+
+        $this->_em->persist(new GH7512EntityA());
+        $this->_em->persist(new GH7512EntityC());
+        $this->_em->flush();
+        $this->_em->clear();
+    }
+
+    public function testFindEntityByAssociationPropertyJoinedChildWithClearMetadata(): void
+    {
+        // unset metadata for entity B as though it hasn't been touched yet in application lifecycle.
+        $this->_em->getMetadataFactory()->setMetadataFor(GH7512EntityB::class, null);
+        $result = $this->_em->getRepository(GH7512EntityC::class)->findBy([
+            'entityA' => new GH7512EntityB(),
+        ]);
+        $this->assertEmpty($result);
+    }
+}
+
+/**
+ * @Entity()
+ * @InheritanceType("JOINED")
+ * @DiscriminatorMap({
+ *     "entitya"=Doctrine\Tests\ORM\Functional\Ticket\GH7512EntityA::class,
+ *     "entityB"=Doctrine\Tests\ORM\Functional\Ticket\GH7512EntityB::class
+ * })
+ */
+class GH7512EntityA
+{
+    /**
+     * @Column(type="integer")
+     * @Id()
+     * @GeneratedValue(strategy="AUTO")
+     * @var int
+     */
+    public $id;
+
+    /**
+     * @OneToMany(targetEntity="Doctrine\Tests\ORM\Functional\Ticket\GH7512EntityC", mappedBy="entityA")
+     * @var Collection<int, GH7512EntityC>
+     */
+    public $entityCs;
+}
+
+/**
+ * @Entity()
+ */
+class GH7512EntityB extends GH7512EntityA
+{
+}
+
+/**
+ * @Entity()
+ */
+class GH7512EntityC
+{
+    /**
+     * @Column(type="integer")
+     * @Id()
+     * @GeneratedValue(strategy="AUTO")
+     * @var int
+     */
+    public $id;
+
+    /**
+     * @ManyToOne(targetEntity="Doctrine\Tests\ORM\Functional\Ticket\GH7512EntityA", inversedBy="entityCs")
+     * @var GH7512EntityA
+     */
+    public $entityA;
+}