Moving a class to a local package and registering it as a new service

composer.json

@@ -4,7 +4,8 @@
     "require": {
         "php": "^8.0",
         "symfony/dependency-injection": "^5.2",
-        "symfony/config": "^5.2"
+        "symfony/config": "^5.2",
+        "acme/image": "^0.1"
     },
     "autoload": {
         "psr-4": {
@@ -14,7 +15,12 @@
             "src/BaseModel.php"
         ]
     },
-    "license": "MIT",
+    "repositories": [
+        {
+            "type": "path",
+            "url": "./packages/acme-image"
+        }
+    ],    "license": "MIT",
     "authors": [
         {
             "name": "Grigori Kochanov",

packages/acme-image/composer.json

@@ -0,0 +1,19 @@
+{
+  "name": "acme/image",
+  "description": "a demo module for splitting a monolith application",
+  "license": "proprietary",
+  "version": "0.1",
+  "authors": [
+    {
+      "name": "Grigori",
+      "email": "public@grik.net"
+    }
+  ],
+  "require": {
+  },
+  "autoload": {
+    "psr-4": {
+      "Acme\\Image\\": "src/"
+    }
+  }
+}

packages/acme-image/src/Contracts/ImageInterface.php

@@ -0,0 +1,13 @@
+<?php
+
+
+namespace Acme\Image\Contracts;
+
+/**
+ * Interface ImageInterface
+ * @package Acme\Image
+ */
+interface ImageInterface
+{
+    public function load(string $tmp_name): mixed;
+}

packages/acme-image/src/ImageService.php

@@ -0,0 +1,37 @@
+<?php
+declare(strict_types=1);
+
+namespace Acme\Image;
+
+use Acme\Image\Contracts\ImageInterface;
+use Acme\Image\lib\Image;
+
+/**
+ * Class ImageService provides an API for the application.
+ * It is a bridge registered as a service assisting decoupling the module
+ * to change it independently from the service API.
+ *
+ * @package Acme\Image
+ * @api
+ */
+class ImageService  implements ImageInterface
+{
+
+    /**
+     * @var Image
+     */
+    private Image $imageLib;
+
+    public function __construct()
+    {
+        $this->imageLib = new Image();
+    }
+
+    /**
+     * @param string $tmp_name
+     */
+    public function load(string $tmp_name): mixed
+    {
+        return $this->imageLib->load($tmp_name);
+    }
+}

packages/acme-image/src/lib/Image.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Acme\Image\lib;
+
+/**
+ * This class can now be changed without breaking the application
+ * because API is fixed in the ImageService class
+ *
+ * @internal
+ * @package Acme\Image
+ */
+class Image extends \BaseModel
+{
+    public function load($tmp_name)
+    {
+        // calls to inherited methods
+        $this->foo();
+        parent::bar();
+    }
+}

services.php

@@ -2,6 +2,8 @@
 
 namespace Symfony\Component\DependencyInjection\Loader\Configurator;
 
+use Acme\Image\{Contracts\ImageInterface,ImageService};
+
 return function(ContainerConfigurator $configurator) {
     /**
      * @see https://symfony.com/doc/current/service_container/autowiring.html
@@ -11,4 +13,5 @@
     $services->load('Acme\\', './src/*')
         ->exclude('./src/BaseModel.php');
 
+    $services->set(ImageInterface::class, ImageService::class);
 };

src/ImageResizeController.php

@@ -4,10 +4,12 @@
 namespace Acme;
 
 
+use Acme\Image\Contracts\ImageInterface;
+
 class ImageResizeController
 {
     public function __construct(
-        public Image $image
+        public ImageInterface $image
     ){
     }