弃用：不建议使用 Doctrine\ORM\Mapping\UnderscoreNamingStrategy 而不使其知道数字

Question

我正在使用 Symfony 4.3.8，但找不到任何关于这些弃用的信息：

不推荐使用用户：不推荐使用创建 Doctrine\ORM\Mapping\UnderscoreNamingStrategy 而不使其知道数字的做法，并将在 Doctrine ORM 3.0 中删除。

不建议使用创建 Doctrine\ORM\Mapping\UnderscoreNamingStrategy 而不使其知道数字，并将在 Doctrine ORM 3.0 中删除。

我在stacktrace中搜索并找到了这个：

class UnderscoreNamingStrategy implements NamingStrategy
{
private const DEFAULT_PATTERN      = '/(?<=[a-z])([A-Z])/';
private const NUMBER_AWARE_PATTERN = '/(?<=[a-z0-9])([A-Z])/';

/**
 * Underscore naming strategy construct.
 *
 * @param int $case CASE_LOWER | CASE_UPPER
 */
public function __construct($case = CASE_LOWER, bool $numberAware = false)
{
    if (! $numberAware) {
        @trigger_error(
            'Creating ' . self::class . ' without making it number aware is deprecated and will be removed in Doctrine ORM 3.0.',
            E_USER_DEPRECATED
        );
    }

    $this->case    = $case;
    $this->pattern = $numberAware ? self::NUMBER_AWARE_PATTERN : self::DEFAULT_PATTERN;
}

在这个类中，构造函数总是在没有参数的情况下被调用，所以 $numberAware 总是 false。

这个类在 Symfony 依赖注入自动生成的文件中被调用，所以我不能“编辑”它...

我想可能是在教义.yaml 中：

doctrine:
orm:
    auto_generate_proxy_classes: true
    naming_strategy: doctrine.orm.naming_strategy.underscore
    auto_mapping: true
    mappings:
        App:
            is_bundle: false
            type: annotation
            dir: '%kernel.project_dir%/src/Entity'
            prefix: 'App\Entity'
            alias: App

但我还没有找到任何允许数字感知的选项:(

Answer 1

在大多数情况下，我只会用评论来回答这类问题，但我怀疑其他开发人员可能会遇到这个问题。我查了一下，找不到任何关于这个问题的明确文档。也许是因为 DoctrineBundle 是在 Doctrine 人员而不是 Symfony 开发人员的控制之下。或者我只是一个糟糕的搜索者。

无论如何，在 4.3 和 4.4 之间，下划线命名策略的服务名称发生了变化。

# doctrine.yaml
orm:
  # 4.3
  naming_strategy: doctrine.orm.naming_strategy.underscore
  # 4.4
  naming_strategy: doctrine.orm.naming_strategy.underscore_number_aware

并添加了一条已弃用的消息，以警告开发人员更改名称。如果消息更明确一点，那就太好了，但哦，好吧。 因此，如果您要将现有应用升级到 4.4 及更高版本，则您可能需要手动编辑您的学说.yaml 文件以消除折旧消息。

更多信息（感谢@janh）为什么做出改变： https://github.com/doctrine/orm/blob/2.8.x/UPGRADE.md#deprecated-number-unaware-doctrineormmappingunderscorenamingstrategy https://github.com/doctrine/orm/issues/7855

仍然不清楚为什么“他们”选择以这种方式做事，但哦，好吧。 您可能想运行“bin/console dictionary:schema:update --dump-sql”来查看这是否会影响您的数据库列名并进行相应调整。更改已经发布了几个星期，似乎没有多少人对更改感到愤怒，所以我猜大多数列名都没有嵌入数字。至少到目前为止。

Answer 2

对于那些使用 symfony4.3 并且仍然希望此警告消失的用户，您可以在 service.yaml

中添加新的服务定义

    custom_doctrine_orm_naming_strategy_underscore:
    class: Doctrine\ORM\Mapping\UnderscoreNamingStrategy
    arguments:
        - 0
        - true

并像这样更改 doctrine.yaml 的配置：

orm:
    naming_strategy: custom_doctrine_orm_naming_strategy_underscore

在直接提交此更改之前，我建议您验证将 true 传递给 Doctrine\ORM\Mapping\UnderscoreNamingStrategy 不会影响代码的预期行为。

// class UnderscoreNamingStrategy
/**
 * Underscore naming strategy construct.
 *
 * @param int $case CASE_LOWER | CASE_UPPER
 */
public function __construct($case = CASE_LOWER, bool $numberAware = false)
{
    if (! $numberAware) {
        @trigger_error(
            'Creating ' . self::class . ' without making it number aware is deprecated and will be removed in Doctrine ORM 3.0.',
            E_USER_DEPRECATED
        );
    }

    $this->case    = $case;
    $this->pattern = $numberAware ? self::NUMBER_AWARE_PATTERN : self::DEFAULT_PATTERN;
}

快速提示：

将true 传递给c'tor 将使类使用NUMBER_AWARE_PATTERN 而不是DEFAULT_PATTERN

private const DEFAULT_PATTERN      = '/(?<=[a-z])([A-Z])/';
private const NUMBER_AWARE_PATTERN = '/(?<=[a-z0-9])([A-Z])/';