Doctrine.yaml“不包含有效的YAML:不能在无引号的映射值中使用冒号

在使用 Symfony 或其他基于 Doctrine 的框架时，配置文件通常使用 YAML 格式。如果你在 doctrine.yaml 文件中遇到错误，例如 "不包含有效的YAML:不能在无引号的映射值中使用冒号"，这通常是因为 YAML 语法不正确。

YAML 文件中的冒号 : 是一个特殊字符，用于分隔键和值。如果值中包含冒号，必须使用引号将其括起来。

以下是一些常见的错误和正确的写法示例：

错误示例

doctrine:
    dbal:
        connections:
            default:
                url: mysql://user:password@localhost:3306/dbname

在上面的示例中，url 的值包含冒号，但没有用引号括起来，这会导致 YAML 解析错误。

正确示例

doctrine:
    dbal:
        connections:
            default:
                url: "mysql://user:password@localhost:3306/dbname"

在正确的示例中，url 的值用双引号括起来，避免了 YAML 解析错误。

其他常见问题

缩进错误：YAML 对缩进非常敏感，确保使用一致的缩进（通常是两个空格或四个空格）。
特殊字符：如果值中包含特殊字符（如冒号、逗号等），请使用引号将其括起来。
多行字符串：如果值是多行字符串，可以使用 | 或 > 来表示。

完整示例

以下是一个完整的 doctrine.yaml 文件示例，展示了如何正确配置 Doctrine：

doctrine:
    dbal:
        connections:
            default:
                driver: 'pdo_mysql'
                server_version: '5.7'
                charset: utf8mb4
                url: "mysql://user:password@localhost:3306/dbname"
    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