doc changes

Signed-off-by: Howriq <horea@rospace.com>

Author: Howriq

.github/workflows/static-analysis.yml

@@ -22,7 +22,7 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Install PHP
         uses: shivammathur/setup-php@v2

docs/book/index.md

@@ -2,9 +2,17 @@
 
 ## Composer Requirements
 
-The first step is to add alongside your current packages the required entries for our Doctrine installation. We would add the following to our `composer.json` file located in our root folder:
+The first step is to add alongside your current packages the required entries for our Doctrine installation.
+We would add the following to our `composer.json` file located in our root folder:
 
-![composer](../images/composer.png)
+![composer](images/composer.png)
+
+```text
+"dotkernel/dot-cache": "^4.0",
+"ramsey/uuid": "^4.5.0",
+"ramsey/uuid-doctrine": "^2.1.0",
+"roave/psr-container-doctrine": "^5.2.2 || ^6.0.0",
+```
 
 `dotkernel/dot-cache`
 
@@ -39,7 +47,35 @@ After successfully installing our dependencies we now need to configure our Doct
 
 In the file `config/autoload/local.php` the structure would be updated like this:
 
-![local.php](../images/local.png)
+![local.php](images/local.png)
+
+```php
+$databases = [
+    'default' => [
+        'host'     => 'localhost',
+        'dbname'   => 'light',
+        'user'     => 'root',
+        'password' => '123',
+        'port'     => 3306,
+        'driver'   => 'pdo_mysql',
+        'charset'  => 'utf8mb4',
+        'collate'  => 'utf8mb4_general_ci',
+    ],
+    // you can add more database connections into this array
+];
+
+return [
+    'databases'   => $databases,
+    'doctrine'    => [
+        'connection' => [
+            'orm_default' => [
+                'params' => $databases['default'],
+            ],
+        ],
+    ],
+    // the rest of your configuration
+];
+```
 
 ### Declare the Doctrine Drivers and Migrations Location
 
@@ -48,29 +84,82 @@ This package takes all the provided configs from the `config/config.php` file an
 
 Our new `src/App/src/ConfigProvider.php` class would look like this now:
 
-![Config provider factories update](../images/config-provider-1.png)
-![Doctrine config function](../images/config-provider-2.png)
+![Config provider factories update](images/config-provider-1.png)
+![Doctrine config function](images/config-provider-2.png)
 
 We also require a new file `config/cli-config.php`.
 It initializes and returns a `DependencyFactory` that Doctrine Migrations uses to run migrations.
 
-![cli-config](../images/cli-config.png)
+![cli-config](images/cli-config.png)
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use Doctrine\Migrations\Configuration\EntityManager\ExistingEntityManager;
+use Doctrine\Migrations\Configuration\Migration\ConfigurationArray;
+use Doctrine\Migrations\DependencyFactory;
+use Doctrine\ORM\EntityManager;
+
+$container = require 'config/container.php';
+
+$entityManager = $container->get(EntityManager::class);
+$entityManager->getEventManager();
+
+return DependencyFactory::fromEntityManager(
+    new ConfigurationArray($container->get('config')['doctrine']['migrations']),
+    new ExistingEntityManager($entityManager)
+);
+```
 
 ## Running doctrine
 
 Now that everything has been configured we only need to do one last thing, to create an executable for the Doctrine CLI.
-In our case we will create it as `/bin/doctrine`
+In our case we will create a `doctrine` file inside the application's `bin` directory:
+
+![bin/doctrine](images/doctrine.png)
+
+```php
+#!/usr/bin/env php
+<?php
 
-![bin/doctrine](../images/doctrine.png)
+declare(strict_types=1);
 
-(Optional) To keep things tidy we recommend to make an executable for the migrations of Doctrine as well for example `/bin/doctrine-migrations`:
+use Doctrine\ORM\EntityManager;
+use Doctrine\ORM\Tools\Console\ConsoleRunner;
+use Doctrine\ORM\Tools\Console\EntityManagerProvider\SingleManagerProvider;
 
-![bin/doctrine-migrations](../images/doctrine-migrations.png)
+require_once 'vendor/autoload.php';
+
+$container = require 'config/container.php';
+
+$entityManager = $container->get(EntityManager::class);
+$entityManager->getEventManager();
+
+ConsoleRunner::run(new SingleManagerProvider($entityManager));
+```
+
+(Optional) To keep things tidy, we recommend making an executable for the migrations of Doctrine as well.
+For this, we create `doctrine-migrations` file inside the application's `bin` directory:
+
+![bin/doctrine-migrations](images/doctrine-migrations.png)
+
+```php
+#!/usr/bin/env php
+<?php
+
+declare(strict_types=1);
+
+namespace Doctrine\Migrations;
+
+require __DIR__ . '/../vendor/doctrine/migrations/bin/doctrine-migrations.php';
+```
 
 Now by running the command bellow we should see the Doctrine CLI version alongside its available commands:
 
 ```shell
-php bin/doctrine
+php ./bin/doctrine
 ```
 
 Example (truncated) output: