Documentation

SimplifiedYamlDriver extends YamlDriver
in package

YamlDriver that additionally looks for mapping information in a global file.

Tags
deprecated

This class is being removed from the ORM and won't have any replacement

Table of Contents

Constants

DEFAULT_FILE_EXTENSION  = '.orm.yml'

Properties

$classCache  : array<string|int, ClassMetadata>|null
$globalBasename  : string
$locator  : FileLocator

Methods

__construct()  : mixed
Initializes a new FileDriver that looks in the given path(s) for mapping documents and operates in the specified operating mode.
getAllClassNames()  : array<int, string>
Gets the names of all mapped classes known to this driver.
getElement()  : ClassMetadata
Gets the element of schema meta data for the class from the mapping file.
getGlobalBasename()  : string|null
Retrieves the global basename.
getLocator()  : FileLocator
Retrieves the locator used to discover mapping files by className.
isTransient()  : bool
Returns whether the class with the specified name should have its metadata loaded.
loadMetadataForClass()  : mixed
{@inheritDoc}
setGlobalBasename()  : void
Sets the global basename.
setLocator()  : void
Sets the locator used to discover mapping files by className.
initialize()  : void
Initializes the class cache from all the global files.
loadMappingFile()  : array<string|int, ClassMetadata>
Loads a mapping file with the given name and returns a map from class/entity names to their corresponding file driver elements.
cacheToArray()  : array<string|int, mixed>
Parse / Normalize the cache configuration
columnToArray()  : array<string|int, mixed>
Parses the given column as array.
joinColumnToArray()  : array<string|int, mixed>
Constructs a joinColumn mapping array based on the information found in the given join column element.

Constants

Properties

$classCache

protected array<string|int, ClassMetadata>|null $classCache
Tags
psalm-var

array<class-string, ClassMetadata>|null

$globalBasename

protected string $globalBasename = ''

Methods

__construct()

Initializes a new FileDriver that looks in the given path(s) for mapping documents and operates in the specified operating mode.

public __construct(mixed $prefixes[, mixed $fileExtension = self::DEFAULT_FILE_EXTENSION ]) : mixed
Parameters
$prefixes : mixed
$fileExtension : mixed = self::DEFAULT_FILE_EXTENSION

getAllClassNames()

Gets the names of all mapped classes known to this driver.

public getAllClassNames() : array<int, string>
Return values
array<int, string> —

The names of all mapped classes known to this driver.

getElement()

Gets the element of schema meta data for the class from the mapping file.

public getElement(string $className) : ClassMetadata

This will lazily load the mapping file if it is not loaded yet.

Parameters
$className : string
Tags
psalm-param

class-string $className

psalm-return

ClassMetadata

throws
MappingException
Return values
ClassMetadata —

The element of schema meta data.

getGlobalBasename()

Retrieves the global basename.

public getGlobalBasename() : string|null
Return values
string|null

isTransient()

Returns whether the class with the specified name should have its metadata loaded.

public isTransient(string $className) : bool
Parameters
$className : string
Return values
bool

loadMetadataForClass()

{@inheritDoc}

public loadMetadataForClass(mixed $className, ClassMetadata $metadata) : mixed
Parameters
$className : mixed
$metadata : ClassMetadata
Tags
psalm-param

class-string<T> $className

psalm-param

ClassMetadata<T> $metadata

template

T of object

setGlobalBasename()

Sets the global basename.

public setGlobalBasename(string $file) : void
Parameters
$file : string

initialize()

Initializes the class cache from all the global files.

protected initialize() : void

Using this feature adds a substantial performance hit to file drivers as more metadata has to be loaded into memory than might actually be necessary. This may not be relevant to scenarios where caching of metadata is in place, however hits very hard in scenarios where no caching is used.

loadMappingFile()

Loads a mapping file with the given name and returns a map from class/entity names to their corresponding file driver elements.

protected abstract loadMappingFile(string $file) : array<string|int, ClassMetadata>
Parameters
$file : string

The mapping file to load.

Tags
psalm-return

array<class-string, ClassMetadata>

Return values
array<string|int, ClassMetadata>

cacheToArray()

Parse / Normalize the cache configuration

private cacheToArray(array<string|int, mixed> $cacheMapping) : array<string|int, mixed>
Parameters
$cacheMapping : array<string|int, mixed>
Tags
psalm-param

array{usage: string|null, region?: mixed} $cacheMapping

psalm-return

array{usage: int|null, region: string|null}

Return values
array<string|int, mixed>

columnToArray()

Parses the given column as array.

private columnToArray(string $fieldName, array<string|int, mixed>|null $column) : array<string|int, mixed>
Parameters
$fieldName : string
$column : array<string|int, mixed>|null
Tags
psalm-param

array{ type?: string, column?: string, precision?: mixed, scale?: mixed, unique?: mixed, options?: mixed, nullable?: mixed, insertable?: mixed, updatable?: mixed, generated?: mixed, enumType?: class-string, version?: mixed, columnDefinition?: mixed }|null $column

psalm-return

array{ fieldName: string, type?: string, columnName?: string, length?: int, precision?: mixed, scale?: mixed, unique?: bool, options?: mixed, nullable?: mixed, notInsertable?: mixed, notUpdatable?: mixed, generated?: mixed, enumType?: class-string, version?: mixed, columnDefinition?: mixed }

Return values
array<string|int, mixed>

joinColumnToArray()

Constructs a joinColumn mapping array based on the information found in the given join column element.

private joinColumnToArray(array<string|int, mixed> $joinColumnElement) : array<string|int, mixed>
Parameters
$joinColumnElement : array<string|int, mixed>
Tags
psalm-param

array{ referencedColumnName?: mixed, name?: mixed, fieldName?: mixed, unique?: mixed, nullable?: mixed, onDelete?: mixed, columnDefinition?: mixed } $joinColumnElement The array join column element.

psalm-return

array{ referencedColumnName?: string, name?: string, fieldName?: string, unique?: bool, nullable?: bool, onDelete?: mixed, columnDefinition?: mixed }

Return values
array<string|int, mixed> —

The mapping array.


        

        
    




    

    
                                
                

                                
    

        On this page

        
    


                

                            
            

    

        

            
Search results