PHPackages                             proklung/wp-symfony-router-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. proklung/wp-symfony-router-bundle

ActiveSymfony-bundle

proklung/wp-symfony-router-bundle
=================================

Symfony Router for custom implementation Wordpress-Symfony

1.4.5(4y ago)141MITPHPPHP >=7.3 || ^8.0

Since Apr 22Pushed 4y ago1 watchersCompare

[ Source](https://github.com/ProklUng/wp.symfony.router.bundle)[ Packagist](https://packagist.org/packages/proklung/wp-symfony-router-bundle)[ Docs](https://github.com/ProklUng/wp.symfony.router.bundle)[ RSS](/packages/proklung-wp-symfony-router-bundle/feed)WikiDiscussions master Synced today

READMEChangelog (10)Dependencies (12)Versions (41)Used By (0)

Бандл для подключения Symfony Router к кастомным вариантам Wordpress-Symfony
============================================================================

[](#бандл-для-подключения-symfony-router-к-кастомным-вариантам-wordpress-symfony)

Зачем?
------

[](#зачем)

**INTERNAL**. Нужен для максимального разнесения функционала по пакетам. Плюс борьба с копипастой инструментов на проектах.

Установка
---------

[](#установка)

1. `composer require proklung/wp.symfony.router.bundle`
2. Подключение бандла в `standalone_bundles.php`

Параметры
---------

[](#параметры)

Файл `symfony_router.yaml` в конфигурации бандлов:

- `enabled` - Использовать бандл. По умолчанию `true`.
- `controller_annotations_path` - массив с путями к контроллерам, использующим аннотации.
- `router_cache_path` - путь к кэшу аннотаций (вида `%kernel.cache.dir%/routes`). По умолчанию `null`. Если задан, то роуты будут кэшироваться.
- `router_config_file` - путь к файлу с конфигурацией роутов. По умолчанию `app/routes.yaml`. Файл может быть в любом поддерживаемом Symfony формате - Yaml, PHP, XML и т.д.
- `router_check_exists_controller` - проверять на существование классы-контроллеры. По умолчанию `false`.
- `resource` - путь к конфигурационному файлу роутов. По умолчанию: `%kernel.project_dir%/app/routes.yaml`.
- `native_resource` - путь к конфигурации "нативных" обработчиков роутов. По умолчанию: `%kernel.project_dir%/app/wp_routes.yaml`.

"Нативные" Wordpress обработчики AJAX (через wp-admin.php)
----------------------------------------------------------

[](#нативные-wordpress-обработчики-ajax-через-wp-adminphp)

Yaml файл типа (обычный файл с описаниями роутов):

```
examples_wp: # Action роута
  path: ''   # Игнор. Нужно, чтобы генератор коллекций роутов не падал.
  methods: [GET, POST]
  controller: 'Local\Services\Wordpress\SampleAjaxController::action'
  defaults:
    _public: true # Публичный роут или только для админки?
```

Для реализации контроллера на нативный обработчик Ajax предлагается использовать класс `Prokl\WpSymfonyRouterBundle\Services\NativeAjax\AbstractWPAjaxController`. Он представляет собой наследника от `AbstractController` с добавлением конструктора, принимающего одну зависимость - объект класса `Request`. Приходится так действовать, потому что в ajax обработчик Wordpress никак нелльзя передать параметры снаружи (за исключением супер-глобалов типа `$_POST` и `$_GET`).

Дополнительно в Request контроллера пробрасываются всякие параметры из свойств роута. Например `methods`.

Это делает возможным, например, отсекать неправильные типа запроса в `action` обработчика.

```
class SampleAjaxController extends AbstractWPAjaxController
{
    public function action()
    {
        $this->checkTypeRequest('Invalid type request');

        $response = new Response(
            'OK',
            Response::HTTP_OK
        );

        $response->headers->set('Content-Type', 'application/html; charset=utf-8');
        $response->send();

        wp_die();
    }
}
```

Или писать каку-нибудь логику для операций с `defaults`, `requirements` или `options` из параметров роута.

Использование роутера без контейнера и вне фреймворка
-----------------------------------------------------

[](#использование-роутера-без-контейнера-и-вне-фреймворка)

`functions.php`:

```
use Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesConfigurator;
use Prokl\WpSymfonyRouterBundle\Services\Agnostic\Router;
use Prokl\WpSymfonyRouterBundle\Services\Agnostic\WpInitializerRouter;

$agnosticRouter = new RoutesConfigurator(
    $_SERVER['DOCUMENT_ROOT'] . '/local/configs/standalone_routes.yaml',
    $_SERVER['DOCUMENT_ROOT'] . '/wp-content/cache/routes', // Кэш; если null - без кэширования.
    $_ENV['APP_DEBUG'] // Режим отладки или нет
);

$agnosticRouterInstance = new Router(
    $agnosticRouter->getRouter(),
    new WpInitializerRouter()
);
```

Все. Подтянутся роуты из `/local/configs/standalone_routes.yaml`. Автоматически подцепятся события.

Допускается наличие нескольких таких "агностических" роутеров в один момент.

Прочее
------

[](#прочее)

1. Экземпляр `Symfony\Component\Routing\Router` можно получить снаружи так:

```
$router = \Prokl\WpSymfonyRouterBundle\Services\Agnostic\RoutesConfigurator::getInstance();
```

2. Как загрузить роуты бандлы:

В файле `Extension` бандла:

```
    public function load(array $configs, ContainerBuilder $container) : void
    {
        // ....
         $this->loadRoutes(__DIR__ . '/../Resources/config', 'routes.yaml');
    }

    /**
     * Загрузить роуты в бандле.
     *
     * @param string $path   Путь к конфигу.
     * @param string $config Конфигурационный файл.
     *
     * @return void
     *
     * @throws InvalidArgumentException Нет класса-конфигуратора роутов.
     */
    private function loadRoutes(string $path, string $config = 'routes.yaml') : void
    {
        $routeLoader = new \Symfony\Component\Routing\Loader\YamlFileLoader(
            new FileLocator($path)
        );

        $routes = $routeLoader->load($config);

        if (class_exists(InitRouter::class)) {
            InitRouter::addRoutesBundle($routes);
            return;
        }

        throw new InvalidArgumentException('Class InitRouter not exist.');
    }
```

Или воспользоваться трэйтом `Prokl\WpSymfonyRouterBundle\Services\Utils\LoaderBundleRoutesTrait`, куда вынесен этот метод.

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

40

Last Release

1727d ago

PHP version history (2 changes)1.0.0PHP >=7.3

1.3.8PHP >=7.3 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/9210c86ee6734e537eaf22c0f2fe7a965451e340e39e1aae2b74013f24c2660d?d=identicon)[gedovan](/maintainers/gedovan)

---

Top Contributors

[![ProklUng](https://avatars.githubusercontent.com/u/19857467?v=4)](https://github.com/ProklUng "ProklUng (45 commits)")

---

Tags

php7symfony-bundlewordpresswordpress-symfony

### Embed Badge

![Health badge](/badges/proklung-wp-symfony-router-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/proklung-wp-symfony-router-bundle/health.svg)](https://phpackages.com/packages/proklung-wp-symfony-router-bundle)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k16.7M310](/packages/easycorp-easyadmin-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)