split deprecation for different symfony versions

Author: dbu

src/DependencyInjection/HttplugExtension.php

@@ -32,6 +32,7 @@
 use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
 use Symfony\Component\DependencyInjection\Reference;
 use Symfony\Component\HttpKernel\DependencyInjection\Extension;
+use Symfony\Component\HttpKernel\Kernel;
 use Twig\Environment as TwigEnvironment;
 
 /**
@@ -60,6 +61,12 @@ public function load(array $configs, ContainerBuilder $container)
         $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
 
         $loader->load('services.xml');
+        // TODO: Move this back into services.xml when we drop support for Symfony 4, or completely remove the service in the next major version.
+        if (Kernel::MAJOR_VERSION >= 5) {
+            $loader->load('services_legacy.xml');
+        } else {
+            $loader->load('services_legacy_sf4.xml');
+        }
         $loader->load('plugins.xml');
         if (\class_exists(MockClient::class)) {
             $loader->load('mock-client.xml');

src/Resources/config/services.xml

@@ -47,9 +47,6 @@
         <service id="httplug.client.default" class="Http\Client\HttpClient">
             <factory class="Http\Discovery\HttpClientDiscovery" method="find" />
         </service>
-        <service id="Http\Client\HttpClient" alias="httplug.client" public="false">
-            <deprecated package="php-http/httplug-bundle" version="1.28" />
-        </service>
         <service id="Psr\Http\Client\ClientInterface" alias="httplug.client" public="false" />
 
         <!-- Discovery for PSR-18 -->

src/Resources/config/services_legacy.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<container xmlns="http://symfony.com/schema/dic/services"
+           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+           xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+    <services>
+        <service id="Http\Client\HttpClient" alias="httplug.client" public="false">
+            <deprecated package="php-http/httplug-bundle" version="1.28">The "%service_id%" service is deprecated in favor of using PSR-7 Psr\Http\Client\ClientInterface</deprecated>
+        </service>
+    </services>
+</container>

src/Resources/config/services_legacy_sf4.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<container xmlns="http://symfony.com/schema/dic/services"
+           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+           xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+    <services>
+        <service id="Http\Client\HttpClient" alias="httplug.client" public="false">
+            <deprecated>The "%service_id%" service is deprecated in favor of using PSR-7 Psr\Http\Client\ClientInterface</deprecated>
+        </service>
+    </services>
+</container>