phpsoftbox/database-lookup

Shared keyed lookup specification for PhpSoftBox database integrations

dev-master 2026-06-16 17:53 UTC

Requires

• php: ^8.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• phpsoftbox/cli-app: dev-master
• phpsoftbox/cs-fixer: ^1.1.0
• phpunit/phpunit: ^11.2

MIT

• Anton K.

README

Общий объект описания keyed lookup для компонентов, которым нужно согласованно читать строки по явным идентификаторам.

use PhpSoftBox\DatabaseLookup\LookupSpec;

$lookup = LookupSpec::forTable('shipment_products')
    ->lookupColumn('product_id')
    ->values([10, 20, 30])
    ->where('shipment_id', 123);

Если warmup key не задан явно, он строится из fixed where-колонок и lookup колонки: shipment_id + product_id. Явный ключ можно задать через keyColumns('shipment_id', 'product_id').

Переиспользуемые lookup-спецификации

LookupSpec — immutable value object. Он не рассчитан на наследование: fluent-методы возвращают новый объект спецификации, а сам объект должен оставаться простым переносимым контрактом между Database, Validator, ORM и другими слоями.

Если спецификацию нужно описать заранее и переиспользовать в нескольких местах, лучше оформить это отдельной фабрикой или именованными методами в доменном коде:

use PhpSoftBox\DatabaseLookup\LookupSpec;

final class ShipmentProductLookups
{
    public static function productsForShipment(int $shipmentId): LookupSpec
    {
        return LookupSpec::forTable('shipment_products')
            ->lookupColumn('product_id')
            ->where('shipment_id', $shipmentId);
    }
}

Такой подход оставляет LookupSpec закрытым и предсказуемым value object, но позволяет централизовать таблицы, колонки и scoped-условия.

Лицензия

MIT