Бердир дал правильный ответ, что ограничение - это правильный путь добавления валидации к полю в Drupal 8. Вот пример.
В приведенном ниже примере я буду работать с узлом типа podcast
, который имеет поле с одним значением field_podcast_duration
. Значение для этого поля должно быть отформатировано как ЧЧ: ММ: СС (часы, минуты и секунды).
Чтобы создать ограничение, необходимо добавить два класса. Первый - это определение ограничения, а второй - это валидатор ограничения. Оба они являются плагинами в пространстве имен Drupal\[MODULENAME]\Plugin\Validation\Constraint
.
Во-первых, определение ограничения. Обратите внимание, что идентификатор плагина задан как «PodcastDuration» в аннотации (комментарии) класса. Это будет использовано ниже.
namespace Drupal\[MODULENAME]\Plugin\Validation\Constraint;
use Symfony\Component\Validator\Constraint;
/**
* Checks that the submitted duration is of the format HH:MM:SS
*
* @Constraint(
* id = "PodcastDuration",
* label = @Translation("Podcast Duration", context = "Validation"),
* )
*/
class PodcastDurationConstraint extends Constraint {
// The message that will be shown if the format is incorrect.
public $incorrectDurationFormat = 'The duration must be in the format HH:MM:SS or HHH:MM:SS. You provided %duration';
}
Далее нам нужно предоставить валидатор ограничения. Это имя этого класса будет именем класса сверху, с Validator
добавлением к нему:
namespace Drupal\[MODULENAME]\Plugin\Validation\Constraint;
use Symfony\Component\Validator\Constraint;
use Symfony\Component\Validator\ConstraintValidator;
/**
* Validates the PodcastDuration constraint.
*/
class PodcastDurationConstraintValidator extends ConstraintValidator {
/**
* {@inheritdoc}
*/
public function validate($items, Constraint $constraint) {
// This is a single-item field so we only need to
// validate the first item
$item = $items->first();
// If there is no value we don't need to validate anything
if (!isset($item)) {
return NULL;
}
// Check that the value is in the format HH:MM:SS
if (!preg_match('/^[0-9]{1,2}:[0-5]{1}[0-9]{1}:[0-5]{1}[0-9]{1}$/', $item->value)) {
// The value is an incorrect format, so we set a 'violation'
// aka error. The key we use for the constraint is the key
// we set in the constraint, in this case $incorrectDurationFormat.
$this->context->addViolation($constraint->incorrectDurationFormat, ['%duration' => $item->value]);
}
}
}
Наконец, нам нужно указать Drupal использовать наше ограничение field_podcast_duration
на podcast
тип узла. Мы делаем это в hook_entity_bundle_field_info_alter()
:
use Drupal\Core\Entity\EntityTypeInterface;
function HOOK_entity_bundle_field_info_alter(&$fields, EntityTypeInterface $entity_type, $bundle) {
if (!empty($fields['field_podcast_duration'])) {
$fields['field_podcast_duration']->addConstraint('PodcastDuration');
}
}