Доработки

Author: ProklUng

Services/Agnostic/RoutesLoader.php renamed to Services/Agnostic/RoutesConfigurator.php

@@ -19,18 +19,18 @@
 use Symfony\Component\Routing\RouterInterface;
 
 /**
- * Class RoutesLoader
+ * Class RoutesConfigurator
  * Независимый от контейнера загрузчик роутов.
  * @package Prokl\WpSymfonyRouterBundle\Services\Agnostic
  *
  * @since 24.07.2021
  */
-class RoutesLoader
+class RoutesConfigurator
 {
     /**
      * @var RouterInterface $router Роутер.
      */
-    private $router;
+    protected static $router;
 
     /**
      * @var ResourceCheckerConfigCacheFactory $cacheFactory
@@ -82,7 +82,7 @@ public function __construct(
         $this->checker = new SelfCheckingResourceChecker();
         $this->cacheFactory = new ResourceCheckerConfigCacheFactory([$this->checker]);
 
-        $this->router = new Router(
+        static::$router = new Router(
             $delegatingLoader,
             $configFile,
             [
@@ -129,7 +129,7 @@ public function getRoutes() : RouteCollection
             }
         }
 
-        return $this->router->getRouteCollection();
+        return static::$router->getRouteCollection();
     }
 
     /**
@@ -153,11 +153,24 @@ public function purgeCache() : void
     }
 
     /**
+     * Экземпляр роутера.
+     *
+     * @return RouterInterface|null
+     */
+    public static function getInstance(): ?RouterInterface
+    {
+        return static::$router;
+    }
+
+    /**
+     *
+     * Экземпляр роутера.
+     *
      * @return RouterInterface
      */
     public function getRouter(): RouterInterface
     {
-        return $this->router;
+        return static::$router;
     }
 
     /**
@@ -172,7 +185,7 @@ private function warmUpCache() : void
         }
 
         /** @psalm-suppress UndefinedInterfaceMethod */
-        $this->router->setConfigCacheFactory($this->cacheFactory);
+        static::$router->setConfigCacheFactory($this->cacheFactory);
 
         if ($this->cacheFreshChecker !== null && !$this->cacheFreshChecker->isFresh()) {
             if (!@file_exists($this->cacheDir)) {
@@ -185,6 +198,6 @@ private function warmUpCache() : void
             );
         }
 
-        $this->router->getGenerator(); // Трюк по созданию кэша.
+        static::$router->getGenerator(); // Трюк по созданию кэша.
     }
 }

Tests/Cases/AgnosticRoutesLoaderTest.php

@@ -2,21 +2,21 @@
 
 namespace Prokl\WpSymfonyRouterBundle\Tests\Cases;
 
-use Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesLoader;
+use Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesConfigurator;
 use Prokl\TestingTools\Base\BaseTestCase;
 use Symfony\Component\Filesystem\Filesystem;
 
 /**
  * Class AgnosticRoutesLoaderTest
  * @package Prokl\BitrixSymfonyRouterBundle\Tests
- * @coversDefaultClass RoutesLoader
+ * @coversDefaultClass RoutesConfigurator
  *
  * @since 24.07.2021
  */
 class AgnosticRoutesLoaderTest extends BaseTestCase
 {
     /**
-     * @var RoutesLoader $obTestObject Тестируемый объект.
+     * @var RoutesConfigurator $obTestObject Тестируемый объект.
      */
     protected $obTestObject;
 
@@ -44,7 +44,7 @@ protected function setUp(): void
 
         $this->filesystem = new Filesystem();
 
-        $this->obTestObject = new RoutesLoader(
+        $this->obTestObject = new RoutesConfigurator(
             $this->routesConfig,
             null,
             true
@@ -85,7 +85,7 @@ public function testGetRoutes() : void
      */
     public function testCaching() : void
     {
-        $this->obTestObject = new RoutesLoader(
+        $this->obTestObject = new RoutesConfigurator(
             $this->routesConfig,
             $this->cacheDir,
             true
@@ -103,7 +103,7 @@ public function testCaching() : void
      */
     public function testpurgeCache(): void
     {
-        $this->obTestObject = new RoutesLoader(
+        $this->obTestObject = new RoutesConfigurator(
             $this->routesConfig,
             $this->cacheDir,
             true

readme.MD

@@ -73,11 +73,11 @@ class SampleAjaxController extends AbstractWPAjaxController
 `functions.php`:
 
 ```php
-use Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesLoader;
+use Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesConfigurator;
 use Prokl\WpSymfonyRouterBundle\Services\Agnostic\Router;
 use Prokl\WpSymfonyRouterBundle\Services\Agnostic\WpInitializerRouter;
 
-$agnosticRouter = new RoutesLoader(
+$agnosticRouter = new RoutesConfigurator(
     $_SERVER['DOCUMENT_ROOT'] . '/local/configs/standalone_routes.yaml',
     $_SERVER['DOCUMENT_ROOT'] . '/wp-content/cache/routes', // Кэш; если null - без кэширования.
     $_ENV['APP_DEBUG'] // Режим отладки или нет
@@ -91,4 +91,12 @@ $agnosticRouterInstance = new Router(
 
 Все. Подтянутся роуты из `/local/configs/standalone_routes.yaml`. Автоматически подцепятся события.
 
-Допускается наличие нескольких таких "агностических" роутеров в один момент.
+Допускается наличие нескольких таких "агностических" роутеров в один момент.
+
+## Прочее
+
+1) Экземпляр `Symfony\Component\Routing\Router` можно получить снаружи так:
+
+```php
+$router = \Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesConfigurator::getInstance();
+```