RelationValidationService
class RelationValidationService implements Resettable (View source)
Basic validation of relationship setup, this tool makes sure your relationships are set up correctly in both directions The validation is configurable and inspection can be narrowed down by namespace, class and relation name
This tool is opt-in and runs via flush and outputs notices For strict validation it is recommended to hook this up to your unit test suite
Traits
Provides extensions to this object to integrate it with standard config API methods.
A class that can be instantiated or replaced via DI
Methods
Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .....).
Gets the uninherited value for the given config option
An implementation of the factory method, allows you to create an instance of a class
Creates a class instance by the "singleton" design pattern.
No description
Reset the local cache of this object
Hook this into your unit tests and assert for empty array like this
No description
Inspect specified classes - this ignores any configuration Useful for checking specific classes when trying to fix relation configuration
Check if class is ignored during inspection or not Useful checking if your configuration works as expected Check goes through rules in this order (from generic to more specific): 1 - Allow rules 2 - Deny rules 3 - Deny relations
Details
static Config_ForClass
config()
Get a configuration accessor for this class. Short hand for Config::inst()->get($this->class, .....).
mixed
stat(string $name)
deprecated
deprecated
Get inherited config value
mixed
uninherited(string $name)
Gets the uninherited value for the given config option
$this
set_stat(string $name, mixed $value)
deprecated
deprecated
Update the config value for a given property
static Injectable
create(mixed ...$args)
An implementation of the factory method, allows you to create an instance of a class
This method will defer class substitution to the Injector API, which can be customised via the Config API to declare substitution classes.
This can be called in one of two ways - either calling via the class directly, or calling on Object and passing the class name as the first parameter. The following are equivalent: $list = DataList::create(SiteTree::class); $list = SiteTree::get();
static Injectable
singleton(string $class = null)
Creates a class instance by the "singleton" design pattern.
It will always return the same instance for this class, which can be used for performance reasons and as a simple way to access instance methods which don't rely on instance data (e.g. the custom SilverStripe static handling).
void
clearErrors()
static
reset()
Reset the local cache of this object
array
validateRelations()
Hook this into your unit tests and assert for empty array like this
$messages = RelationValidationService::singleton()->validateRelations(); $this->assertEmpty($messages, print_r($messages, true));
void
executeValidation()
array
inspectClasses(array $classes)
Inspect specified classes - this ignores any configuration Useful for checking specific classes when trying to fix relation configuration
bool
isIgnored(string $class, string|null $relation = null)
Check if class is ignored during inspection or not Useful checking if your configuration works as expected Check goes through rules in this order (from generic to more specific): 1 - Allow rules 2 - Deny rules 3 - Deny relations