[DependencyInjection] Deprecate ExtensionInterface::getXsdValidationBasePath() and getNamespace()

Author: nicolas-grekas

CHANGELOG.md

@@ -14,6 +14,7 @@ CHANGELOG
  * Handle declaring services using PHP arrays that follow the same shape as corresponding yaml files
  * Deprecate using `$this` or its internal scope from PHP config files; use the `$loader` variable instead
  * Deprecate XML configuration format, use YAML or PHP instead
+ * Deprecate `ExtensionInterface::getXsdValidationBasePath()` and `getNamespace()`
 
 7.3
 ---

Extension/Extension.php

@@ -30,6 +30,8 @@ abstract class Extension implements ExtensionInterface, ConfigurationExtensionIn
 
     /**
      * @return string|false
+     *
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
      */
     public function getXsdValidationBasePath()
     {
@@ -38,6 +40,8 @@ public function getXsdValidationBasePath()
 
     /**
      * @return string
+     *
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
      */
     public function getNamespace()
     {

Extension/ExtensionInterface.php

@@ -35,13 +35,17 @@ public function load(array $configs, ContainerBuilder $container);
      * Returns the namespace to be used for this extension (XML namespace).
      *
      * @return string
+     *
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
      */
     public function getNamespace();
 
     /**
      * Returns the base path for the XSD files.
      *
      * @return string|false
+     *
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
      */
     public function getXsdValidationBasePath();
 

Tests/Fixtures/includes/AcmeExtension.php

@@ -10,11 +10,17 @@ public function load(array $configs, ContainerBuilder $configuration): void
         $configuration->setParameter('acme.configs', $configs);
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getXsdValidationBasePath(): string|false
     {
         return false;
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getNamespace(): string
     {
         return 'http://www.example.com/schema/acme';

Tests/Fixtures/includes/ProjectExtension.php

@@ -23,11 +23,17 @@ public function load(array $configs, ContainerBuilder $configuration): void
         $configuration->setParameter('project.parameter.foo', $config['foo'] ?? 'foobar');
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getXsdValidationBasePath(): string|false
     {
         return false;
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getNamespace(): string
     {
         return 'http://www.example.com/schema/project';

Tests/Fixtures/includes/ProjectWithXsdExtension.php

@@ -2,11 +2,17 @@
 
 class ProjectWithXsdExtension extends ProjectExtension
 {
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getXsdValidationBasePath(): string
     {
         return __DIR__.'/schema';
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getNamespace(): string
     {
         return 'http://www.example.com/schema/projectwithxsd';

Tests/Fixtures/includes/ProjectWithXsdExtensionInPhar.phar

@@ -11,11 +11,17 @@
 
 class ProjectWithXsdExtensionInPhar extends ProjectExtension
 {
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getXsdValidationBasePath(): string
     {
         return __DIR__.'/schema';
     }
 
+    /**
+     * @deprecated since Symfony 7.4, to be removed in Symfony 8.0 together with XML support.
+     */
     public function getNamespace(): string
     {
         return 'http://www.example.com/schema/projectwithxsdinphar';