Skip to content

XML config points to invalid URLs for schema, messing up PHPStorm #18275

Open
@dkarlovi

Description

@dkarlovi

https://symfony.com/doc/current/serializer.html

Points to https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd which currently doesn't work (404).

<?xml version="1.0" encoding="UTF-8" ?>
<serializer xmlns="http://symfony.com/schema/dic/serializer-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/serializer-mapping
        https://symfony.com/schema/dic/serializer-mapping/serializer-mapping-1.0.xsd"
>
    <class name="App\Model\Person">
        <attribute name="createdAt">
            <context>
                <entry name="datetime_format">Y-m-d</entry>
            </context>
        </attribute>
    </class>
</serializer>

The URLs are not versioned so using them like this is probably suboptimal, @stof also pointed out in Slack this URL is not used at all (by Symfony) so it could also be pointed to the local filesystem.

options:

1.version the URLs, upload missing files, update the docs to use the new URLs
2. fix the docs to point to local file system instead

Optionally, XML config examples in docs should be validated against the schema so we know they're correct, here's an example from the same URL which seems invalid:

<!-- config/packages/framework.xml -->
<framework:config>
    <!-- ... -->
    <framework:serializer>
        <!-- needs framework: prefix? -->
        <default-context enable-max-depth="true" yaml-indentation="2"/>
    </framework:serializer>
</framework:config>

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions