This component aims at describing data structures in order to help other packages to auto-configure and handle data transformation and data manipulation.
To use this package in your application, require it via composer:
composer require php-etl/metadata
There are PHPSpec tests declared in this package to ensure everything is running fine.
phpspec run
In order to read the metadata of existing PHP code, you may use the automatic type guesser. It can be initialised with the following code:
<?php
use Kiboko\Component\Metadata\TypeGuesser;
use Phpactor\Docblock\DocblockFactory;
use PhpParser\ParserFactory;
$typeGuesser = new TypeGuesser\CompositeTypeGuesser(
new TypeGuesser\Native\NativeTypeGuesser(),
new TypeGuesser\Docblock\DocblockTypeGuesser(
(new ParserFactory())->create(ParserFactory::ONLY_PHP7),
new DocblockFactory()
)
);
Then, use the instance as a functor to automatically discover the types metadata.
Example of a DTO class metadata fetcher:
<?php
use Kiboko\Component\Metadata;
use Kiboko\Component\Metadata\TypeGuesser\TypeGuesserInterface;
/** @var TypeGuesserInterface $guesser */
class Person
{
public string $firstName;
public string $lastName;
public ?string $job;
}
$classOrObject = new \ReflectionClass(\Person::class);
/** @var Metadata\ClassTypeMetadata $metadata */
$metadata = (new Metadata\ClassTypeMetadata($classOrObject->getShortName(), $classOrObject->getNamespaceName()))
->addProperties(...array_map(
function(\ReflectionProperty $property) use($classOrObject, $guesser) {
return new Metadata\PropertyMetadata(
$property->getName(),
...$guesser($classOrObject, $property)
);
},
$classOrObject->getProperties(\ReflectionProperty::IS_PUBLIC)
)
);
In order to simplify the class metadata building, there is a metadata guesser you can use to ease the building of metadata.
<?php
use Kiboko\Component\Metadata;
/** @var Metadata\ClassMetadataBuilder $metadataBuilder */
$metadataBuilder = new Metadata\ClassMetadataBuilder(
new Metadata\PropertyGuesser\ReflectionPropertyGuesser($typeGuesser),
new Metadata\MethodGuesser\ReflectionMethodGuesser($typeGuesser),
new Metadata\FieldGuesser\FieldGuesserChain(
new Metadata\FieldGuesser\PublicPropertyFieldGuesser(),
new Metadata\FieldGuesser\VirtualFieldGuesser()
),
new Metadata\RelationGuesser\RelationGuesserChain(
new Metadata\RelationGuesser\PublicPropertyUnaryRelationGuesser(),
new Metadata\RelationGuesser\PublicPropertyMultipleRelationGuesser(),
new Metadata\RelationGuesser\VirtualRelationGuesser()
)
);
$metadata = $metadataBuilder->buildFromFQCN('FooBarBundle\\Entity\\Foo');
This package works from php 7.2+.
In case you are running it with a version prior to 7.4, the property type hinting is not active and a dummy metadata reader can replace the standard one.
Additionally, it you don't want the PHPDocs to be considered, you may use another dummy metadata reader for this specific part.
To go further and see the DTO structure, check the object reference.