应用程序和框架集成¶

composer require cuyz/valinor-bundle

composer require mezzio/mezzio-valinor

$mapperBuilder = new \CuyZ\Valinor\MapperBuilder();
$normalizerBuilder = new \CuyZ\Valinor\NormalizerBuilder();

// …customization of the mapper builder and normalization builder…

$mapper = $mapperBuilder->mapper();
$jsonNormalizer = $normalizerBuilder->normalizer(\CuyZ\Valinor\Normalizer\Format::json());

$container->addSharedService('mapper', $mapper);
$container->addSharedService('normalizer_json', $jsonNormalizer);

use CuyZ\Valinor\Mapper\Http\HttpRequest;

// In a controller argument resolver / middleware:
$argumentsMapper = $mapperBuilder->argumentsMapper();

// Build an `HttpRequest` from the framework's request and router output.
// If the framework uses PSR-7, the factory method can be used directly:
$request = HttpRequest::fromPsr($psrRequest, $routeParameters);

// Resolve the controller's parameters
$arguments = $argumentsMapper->mapArguments($controller, $request);

// Call the controller
$response = $controller(...$arguments);

$cache = new \CuyZ\Valinor\Cache\FileSystemCache('path/to/cache-directory');

// If the application can detect when it is in development environment, it is
// advised to wrap the cache with a `FileWatchingCache` instance, to avoid
// having to manually clear the cache when a file changes during development.
if ($isApplicationInDevelopmentEnvironment) {
    $cache = new \CuyZ\Valinor\Cache\FileWatchingCache($cache);
}

$mapperBuilder = $mapperBuilder->withCache($cache);
$normalizerBuilder = $normalizerBuilder->withCache($cache);