webservco / data

v2.3.0.74 2026-10-11 16:42 UTC

Requires

• php: ^7.4

MIT

• Radu Maier

• component
• webservco

Published on Packagist.org on 2026-10-11 16:42 UTC

README

A PHP component/library. Please see webservco/sandbox for an example project using these types of components.

Data transfer objects, and services that pull typed values out of mixed data such as request bodies, sessions and database rows.

• Related: webservco/dependency-container (getDataExtractionContainer()), webservco/database, webservco/form, webservco/session (all use it)

Installation

composer require webservco/data

Usage

use WebServCo\Data\Container\Extraction\DataExtractionContainer;

// true: array keys can be paths like "user/address/city".
// \WebServCo\Data\Contract\Extraction\DataExtractionContainerInterface
$dataExtractionContainer = new DataExtractionContainer(true);

$data = ['user' => ['id' => '42', 'name' => 'Ana']];

// Loose: casts the string "42" to int.
$userId = $dataExtractionContainer->getLooseArrayDataExtractionService()->getInt($data, 'user/id');

// Strict and non-empty: must already be a string, and not ''.
$name = $dataExtractionContainer->getStrictArrayNonEmptyDataExtractionService()
    ->getNonEmptyString($data, 'user/name');

// Missing key: null.
$age = $dataExtractionContainer->getStrictArrayDataExtractionService()->getNullableInt($data, 'user/age');

There is also a scalar version of each service for a single value, for example getLooseDataExtractionService()->getInt($value).

public/index.php is a small demo page.

Contracts

Interface	Implementation	Purpose
Contract\Extraction\DataExtractionContainerInterface	Container\Extraction\DataExtractionContainer	Gives access to all eight extraction services.
Contract\Extraction\DataExtractionContainerFactoryInterface	Factory\Extraction\DataExtractionContainerFactory	Creates the container.
Contract\Extraction\Strict\Strict*Interface	Service\Extraction\Strict\Strict*Service	The value must already have the requested type.
Contract\Extraction\Loose\Loose*Interface	Service\Extraction\Loose\Loose*Service	The value is cast to the requested type.
Contract\Extraction\ArrayStorageServiceInterface	Service\Extraction\ArrayStorageService	Reads nested values by a / separated path.
Contract\Transfer\DataTransferInterface	DataTransferObject\KeyValue\StringString, StringFloat	Marker interface for DTOs, plus two key/value DTOs.

Each extraction family has scalar, non-empty scalar, array and non-empty array variants. Namespaces are relative to WebServCo\Data\.

Notes

Use loose extraction for data that arrives as strings even when it means something else, like database results or route parts. Use strict extraction when a wrong type is a bug.

Array getters accept a default value as the third argument. Without a default, a missing key throws an OutOfBoundsException. Nullable getters return null for a missing key, and the int, float and bool ones also treat '' as null. A value of the wrong type throws an UnexpectedValueException, and so does an empty value in a non-empty service.

Development

# Start project.
ddev start
# Install dependencies.
ddev c u
# Run all validations.
ddev c c
# Run unit tests.
ddev c test:dox

License

MIT