mheads / yii2-table

1.1.1 2026-09-19 11:38 UTC

Requires

• php: 8.3 - 8.5
• mheads/yii-table: ^1.1
• mheads/yii2-psr7-bridge: ^1.0
• yiisoft/yii2: ^2.0.53

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.94
• mheads/yii2-data-db: ^1.0
• phpunit/phpunit: ^12.5
• vimeo/psalm: ^6.16

Suggests

• mheads/yii2-data-db: Allows using Yii2 DB queries as table data sources and export sources.

BSD-3-Clause

• MachineHeads
• Sergey Alekseenko

• adapter
• table
• yii2

Published on Packagist.org on 2026-09-19 11:39 UTC

README

Связующий слой для использования mheads/yii-table в Yii2-приложениях.

Пакет добавляет:

• действия Yii2 для HTTP-таблиц: TableAction, TableConfigAction, TableRowsAction, TableExportAction;
• опциональную поддержку запросов Yii DB как источника данных таблицы через mheads/yii2-data-db;
• адаптер пакетного чтения QueryDataReaderBatchReadStrategy для экспорта из источников mheads/yii2-data-db;
• единое преобразование Yii-запросов и ответов через mheads/yii2-psr7-bridge;
• точку расширения для обработки ошибок экспорта в TableAction и TableExportAction.

Установка

composer require mheads/yii2-table

Также нужна реализация PSR-7 и PSR-17, например:

composer require nyholm/psr7

Если таблица читает данные из Yii DB или использует QueryDataReaderBatchReadStrategy, установите дополнительный пакет:

composer require mheads/yii2-data-db

Настройка DI

В конфигурации Yii2-приложения зарегистрируйте зависимости mheads/yii-table, mheads/yii2-psr7-bridge и фабрики PSR-17.

return [
    'container' => [
        'definitions' => [
            // PSR-17
            \Psr\Http\Message\ResponseFactoryInterface::class      => \Nyholm\Psr7\Factory\Psr17Factory::class,
            \Psr\Http\Message\ServerRequestFactoryInterface::class => \Nyholm\Psr7\Factory\Psr17Factory::class,
            \Psr\Http\Message\StreamFactoryInterface::class        => \Nyholm\Psr7\Factory\Psr17Factory::class,

            // mheads/yii-table
            \Mheads\Yii\Table\Http\Request\TableRequestApplierInterface::class            => \Mheads\Yii\Table\Http\Request\TableRequestApplier::class,
            \Mheads\Yii\Table\Http\Response\TableHttpResponderInterface::class            => \Mheads\Yii\Table\Http\Response\TableHttpResponder::class,
            \Mheads\Yii\Table\Http\Response\Payload\TablePayloadResponderInterface::class => \Mheads\Yii\Table\Http\Response\Payload\JsonTablePayloadResponder::class,
            \Mheads\Yii\Table\Serialization\TableSerializerInterface::class               => \Mheads\Yii\Table\Serialization\TableArraySerializer::class,
            \Mheads\Yii\Table\Serialization\TableConfigSerializerInterface::class         => \Mheads\Yii\Table\Serialization\TableArraySerializer::class,
            \Mheads\Yii\Table\Serialization\TableRowsSerializerInterface::class           => \Mheads\Yii\Table\Serialization\TableArraySerializer::class,
            \Mheads\Yii\Table\I18n\TableTranslatorInterface::class                        => \Mheads\Yii2\Table\I18n\Yii2TableTranslator::class,

            // mheads/yii2-psr7-bridge
            \Mheads\Yii2Psr7Bridge\HttpMessageBridgeInterface::class                    => \Mheads\Yii2Psr7Bridge\HttpMessageBridge::class,
            \Mheads\Yii2Psr7Bridge\Request\Yii2ToPsr7RequestConverterInterface::class   => \Mheads\Yii2Psr7Bridge\Request\Yii2ToPsr7RequestConverter::class,
            \Mheads\Yii2Psr7Bridge\Response\Psr7ToYii2ResponseConverterInterface::class => \Mheads\Yii2Psr7Bridge\Response\Psr7ToYii2ResponseConverter::class,
        ],
    ],
];

Переводы фильтров

Фильтры mheads/yii-table используют Mheads\Yii\Table\I18n\TableTranslatorInterface для локализации системных подписей. Yii2TableTranslator адаптирует этот интерфейс к Yii::t().

Зарегистрируйте категорию переводов Yii2:

return [
    'components' => [
        'i18n' => [
            'translations' => [
                'mheads-yii-table' => [
                    'class' => \yii\i18n\PhpMessageSource::class,
                    'basePath' => '@vendor/mheads/yii-table/resources/messages',
                ],
            ],
        ],
    ],
];

Пакет mheads/yii-table уже содержит стандартные переводы. Если приложению нужно переопределить тексты, укажите собственный basePath, например @common/i18n/messages.

Быстрый пример

Создайте действие, унаследованное от TableAction, и верните таблицу из createTable().

<?php

declare(strict_types=1);

namespace app\actions;

use app\tables\ProductsTableFactory;
use Mheads\Yii\Table\Http\Orchestrator\TableHttpOrchestrator;
use Mheads\Yii\Table\Provider\TableConfiguratorInterface;
use Mheads\Yii\Table\Provider\TableProviderInterface;
use Mheads\Yii2\Table\Http\TableAction;
use Mheads\Yii2Psr7Bridge\HttpMessageBridgeInterface;
use yii\web\Controller;

final class ProductsTableAction extends TableAction
{
    public function __construct(
        string $id,
        Controller $controller,
        TableHttpOrchestrator $orchestrator,
        HttpMessageBridgeInterface $bridge,
        private readonly ProductsTableFactory $tableFactory,
        array $config = [],
    ) {
        parent::__construct($id, $controller, $orchestrator, $bridge, $config);
    }

    protected function createTable(): TableProviderInterface&TableConfiguratorInterface
    {
        return $this->tableFactory->create();
    }
}

Подключите действие в контроллере:

public function actions(): array
{
    return [
        'table' => [
            'class' => \app\actions\ProductsTableAction::class,
        ],
    ];
}

Подробное руководство: docs/guide-ru/README.md.