Validation

Validator::validate(Graph $graph) checks every node — those at the top of the graph and the nested ones — and returns a Report.

$report = new Validator()->validate($graph);

foreach ($report->errors() as $issue) {
    echo $issue->message, "\n"; // https://example.com/e#event needs startDate.
}

Required and recommended properties

Each type has its TypeRules: the properties a node of that type needs, an error when one lacks, and those it should have, a warning. An entry may be a list of which one property is enough. A type with a parent needs what its parent needs too, and a node of several types what each of them needs. A property both required and recommended is only required.

The kinds the factories build need what their parent needs: Corporation, NGO, EducationalOrganization and PerformingGroup are organisations; Store, Restaurant, CafeOrCoffeeShop, BarOrPub and EntertainmentBusiness local businesses; BusinessEvent, EducationEvent, ExhibitionEvent, Festival, MusicEvent, SocialEvent, SportsEvent and TheaterEvent events; NewsArticle, BlogPosting and TechArticle articles; AboutPage, CollectionPage, ContactPage, ItemPage and ProfilePage pages; WebApplication, MobileApplication and VideoGame applications.

Values

Only texts are checked: a node in image or logo, a number, a LanguageString are left alone. Each wrong value is an error.

An address on localhost or under .localhost is an invalid-url too, since no search engine reaches it. A page validated in development or in tests allows them: new Validator(allowLocalhost: true), kept by withRules(). An IP address, http://127.0.0.1/, stays invalid.

References and types

A reference to a node the graph lacks is a warning, unresolved-reference: it may name a thing described elsewhere, or a node a package forgot to give. A node at the top of the graph without a type is a warning, untyped-node: no rule applies to it.

The report

An Issue holds its severity, its code — missing-property, missing-recommended, invalid-date, invalid-url, invalid-currency, invalid-language, unresolved-reference, untyped-node —, the node it is about — its @id, or its type and place, such as Event @graph[2], then › and the property for a nested node —, the property, and an English message.