summaryrefslogtreecommitdiff
path: root/vendor/doctrine/orm/src/Mapping/NamingStrategy.php
blob: afedebe68db8433129bd50da330965fb5cf8788d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
<?php

declare(strict_types=1);

namespace Doctrine\ORM\Mapping;

/**
 * A set of rules for determining the physical column and table names
 *
 * @link    www.doctrine-project.org
 */
interface NamingStrategy
{
    /**
     * Returns a table name for an entity class.
     *
     * @param class-string $className
     */
    public function classToTableName(string $className): string;

    /**
     * Returns a column name for a property.
     *
     * @param class-string $className
     */
    public function propertyToColumnName(string $propertyName, string $className): string;

    /**
     * Returns a column name for an embedded property.
     *
     * @param class-string $className
     * @param class-string $embeddedClassName
     */
    public function embeddedFieldToColumnName(
        string $propertyName,
        string $embeddedColumnName,
        string $className,
        string $embeddedClassName,
    ): string;

    /**
     * Returns the default reference column name.
     */
    public function referenceColumnName(): string;

    /**
     * Returns a join column name for a property.
     *
     * @param class-string $className
     */
    public function joinColumnName(string $propertyName, string $className): string;

    /**
     * Returns a join table name.
     *
     * @param class-string $sourceEntity
     * @param class-string $targetEntity
     */
    public function joinTableName(string $sourceEntity, string $targetEntity, string $propertyName): string;

    /**
     * Returns the foreign key column name for the given parameters.
     *
     * @param class-string $entityName           An entity.
     * @param string|null  $referencedColumnName A property name or null in
     *                                           case of a self-referencing
     *                                           entity with join columns
     *                                           defined in the mapping
     */
    public function joinKeyColumnName(string $entityName, string|null $referencedColumnName): string;
}