adamwojs / ezplatform-location-reference
eZ Platform Location Reference
Installs: 3
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Type:ezplatform-bundle
Requires
- php: ^7.3
- ezsystems/ezpublish-kernel: ^8.0@dev
Requires (Dev)
This package is not auto-updated.
Last update: 2024-10-25 10:11:49 UTC
README
Problem
The common case in the eZ Platform configuration is referencing to some location, usually using Location ID e.g.
- Content root for Site Access (https://doc.ezplatform.com/en/latest/guide/multisite/#location_id)
- Folder used to store Image Assets (https://doc.ezplatform.com/en/latest/api/field_type_reference/#configuration)
There are several issues in this approaches:
- Location IDs differ between environments
- Using Magic numbers is a code smell
This package introduces Domain Specific Language, based on Symfony Expression Language component, allowing to refer locations using meaningful and descriptive expressions.
Usage
Resolve location references
Location reference expressions could be resolved using LocationReferenceResolver
e.g.
<?php namespace App\Service; class FooService { /** * @var \AdamWojs\EzPlatformLocationReference\LocationReferenceResolverInterface */ private $locationReferenceResolver; public function __construct(LocationReferenceResolverInterface $locationReferenceResolver) { $this->locationReferenceResolver = $locationReferenceResolver; } public function foo(): void { $location = $this->locationReferenceResolver->resolve( 'remote_id("babe4a915b1dd5d369e79adb9d6c0c6a")' ); // ... } }
Retrieving location reference from SiteAccess aware configuration
Location references could be retrieved from the SiteAccess aware configuration
using LocationConfigResolver
:
<?php interface LocationConfigResolverInterface { public function getLocation(string $name, ?string $namespace = null, ?string $scope = null): Location; public function getLocationReference(string $name, ?string $namespace = null, ?string $scope = null): LocationReference; }
Arguments for both getLocation
and getLocationReference
methods are exactly the same as for
\eZ\Publish\Core\MVC\ConfigResolverInterface::getParameter
.
Example:
<?php class BarService { /** * @var \AdamWojs\EzPlatformLocationReference\ConfigResolver\LocationConfigResolverInterface */ private $locationConfigResolver; public function __construct(LocationConfigResolverInterface $locationConfigResolver) { $this->locationConfigResolver = $locationConfigResolver; } // ... public function foo(): void { // Get reference to location $reference = $this->locationConfigResolver->getLocationReference('content.tree_root.location_id'); // Resolve location reference $location = $reference->getLocation(); // Return null if location is not available (not found or unauthorized) $location = $reference->getLocationOrNull(); // Return $defaultLocation if location is not available (not found or unauthorized) $location = $reference->getLocationOrDefault($defaultLocation); // Get reference and immediately resolve $location = $this->locationConfigResolver->getLocation('fieldtypes.ezimageasset.parent_location'); } }