[doctrineGH-9277] Deprecate PHPDriver

docs/en/reference/php-mapping.rst

@@ -9,6 +9,11 @@ the code in PHP files or inside of a static function named
 PHP Files
 ---------
 
+.. note::
+
+   PHPDriver is deprecated and will be removed in 3.0, use StaticPHPDriver
+   instead.
+
 If you wish to write your mapping information inside PHP files that
 are named after the entity and included to populate the metadata
 for an entity you can do so by using the ``PHPDriver``:

lib/Doctrine/ORM/Mapping/Driver/PHPDriver.php

@@ -4,13 +4,27 @@
 
 namespace Doctrine\ORM\Mapping\Driver;
 
+use Doctrine\Deprecations\Deprecation;
 use Doctrine\Persistence\Mapping\Driver\PHPDriver as CommonPHPDriver;
 
 /**
  * {@inheritDoc}
  *
- * @deprecated this driver will be removed. Use Doctrine\Persistence\Mapping\Driver\PHPDriver instead
+ * @deprecated this driver will be removed, use StaticPHPDriver or other mapping drivers instead.
  */
 class PHPDriver extends CommonPHPDriver
 {
+    /**
+     * {@inheritDoc}
+     */
+    public function __construct($locator)
+    {
+        Deprecation::trigger(
+            'doctrine/orm',
+            'https://github.com/doctrine/orm/issues/9277',
+            'PHPDriver is deprecated, use StaticPHPDriver or other mapping drivers instead.'
+        );
+
+        parent::__construct($locator, '.php');
+    }
 }