mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-08-27 04:56:02 +02:00
I believe that ValidationResult's error method is called, addError - and not error as stated in this file.
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
title: Model Validation and Constraints
|
|
summary: Validate your data at the model level
|
|
|
|
# Validation and Constraints
|
|
|
|
Traditionally, validation in SilverStripe has been mostly handled on the controller through [form validation](../forms).
|
|
|
|
While this is a useful approach, it can lead to data inconsistencies if the record is modified outside of the
|
|
controller and form context.
|
|
|
|
Most validation constraints are actually data constraints which belong on the model. SilverStripe provides the
|
|
[DataObject::validate()](api:SilverStripe\ORM\DataObject::validate()) method for this purpose.
|
|
|
|
By default, there is no validation - objects are always valid! However, you can overload this method in your DataObject
|
|
sub-classes to specify custom validation, or use the `validate` hook through a [DataExtension](api:SilverStripe\ORM\DataExtension).
|
|
|
|
Invalid objects won't be able to be written - a [ValidationException](api:SilverStripe\ORM\ValidationException) will be thrown and no write will occur.
|
|
|
|
It is expected that you call `validate()` in your own application to test that an object is valid before attempting a
|
|
write, and respond appropriately if it isn't.
|
|
|
|
The return value of `validate()` is a [ValidationResult](api:SilverStripe\ORM\ValidationResult) object.
|
|
|
|
```php
|
|
use SilverStripe\ORM\DataObject;
|
|
|
|
class MyObject extends DataObject
|
|
{
|
|
|
|
private static $db = [
|
|
'Country' => 'Varchar',
|
|
'Postcode' => 'Varchar'
|
|
];
|
|
|
|
public function validate()
|
|
{
|
|
$result = parent::validate();
|
|
|
|
if($this->Country == 'DE' && $this->Postcode && strlen($this->Postcode) != 5) {
|
|
$result->addError('Need five digits for German postcodes');
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
}
|
|
```
|
|
|
|
## API Documentation
|
|
|
|
* [DataObject](api:SilverStripe\ORM\DataObject)
|
|
* [ValidationResult](api:SilverStripe\ORM\ValidationResult);
|