उदाहरणों के साथ सिम्फनी 4/5 में कस्टम सत्यापन मूल बातें

सिम्फनी में, मेरी राय में, इकाई सत्यापन के लिए एक बहुत ही सुविधाजनक कार्यक्षमता। विशेष रूप से, सत्यापन नियमों को कॉन्फ़िगर करने के लिए एनोटेशन प्रारूप का उपयोग वास्तव में मुझे रिश्वत देता है। अधिकांश कार्यों में, टर्नकी समाधान मानक मामलों को कवर करते हैं। लेकिन, जैसा कि आप जानते हैं, सत्यापन एक नाजुक मामला है, और आप कभी नहीं जानते कि इस बार आपको किन प्रतिबंधों को लागू करना होगा। दूसरी ओर, अधिक लचीली और सुविचारित मान्यता हमेशा उपयोगकर्ता की त्रुटियों से बचने में मदद करेगी।

कटौती के तहत, मैं आपको यह देखने के लिए आमंत्रित करता हूं कि आपके प्रतिबंधों को लिखना कितना आसान है और दो क्षेत्रों की तुलना का विस्तार करना जो बुनियादी सत्यापन और सत्यापन के उदाहरण का उपयोग करके उपलब्ध हैं। यह लेख उन लोगों के लिए रुचि का हो सकता है जो अभी भी सिम्फनी में मान्यता से बहुत कम परिचित हैं या जिन्होंने अपने स्वयं के सत्यापनकर्ताओं को लिखने की संभावना को दरकिनार कर दिया है।

इस लेख में हम सत्यापन के क्लासिक संदर्भ को ध्यान में रखेंगे। एक निश्चित इकाई है, जिस पर डेटा उपयुक्त रूप से भरा जाता है, जबकि सत्यापन दर्ज किए गए डेटा के किसी भी पहलू पर प्रतिबंध लगाता है। यह ध्यान देने योग्य है कि सत्यापनकर्ताओं का उपयोग आंतरिक तर्क, एपीआई सत्यापन, आदि को नियंत्रित करने के लिए प्रतिबंधों के बिना किया जा सकता है।

हम तुरंत यह निर्धारित करते हैं कि प्रस्तावित उदाहरण एकमात्र संभव समाधान नहीं हैं और अधिकतम इष्टतमता या व्यापक उपयोग का दावा नहीं करते हैं, लेकिन प्रदर्शन उद्देश्यों के लिए पेश किए जाते हैं। दूसरी ओर, उदाहरणों के कुछ हिस्सों को मुकाबला परियोजनाओं से लिया गया है और सरल बनाया गया है, और मुझे आशा है कि वे वास्तविकता से रुकावट के बिना कस्टम मान्यताओं को लिखने की सरलता को दर्शाने में उपयोगी हो सकते हैं।

मूल मान्यता

एक पूरी तरह से कार्यात्मक सत्यापन करने के लिए, आपको केवल दो वर्गों को बनाने की आवश्यकता है - बाधा और कांस्ट्रेविलेवेटर के वारिस। बाधा, जैसा कि नाम का तात्पर्य है, बाधाओं को परिभाषित करना और उनका वर्णन करना, जबकि कांस्टेंटविलेडिएटर उन्हें मान्य करता है। एक उदाहरण के रूप में, हम पाठ प्रारूप में संग्रहीत "hh: mm" प्रारूप में समय के लिए एक सत्यापनकर्ता लिखेंगे। में आधिकारिक दस्तावेज है, यह है प्रस्ताव किया कि बाधा बाधा के सार्वजनिक संपत्तियों का वर्णन। तो ये करते है।

namespace App\Custom\Constraints;

use Symfony\Component\Validator\Constraint;

/**
 * @Annotation
 * @Target({"PROPERTY"})
 */
class TextTime extends Constraint
{
    public $message = '  ';
}

यहां, लक्ष्य एनोटेशन यह निर्धारित करता है कि सत्यापन का उपयोग किया जाएगा: एक संपत्ति के लिए या एक वर्ग के लिए। आप इस पैरामीटर को फ़ंक्शन को ओवरराइड करके भी सेट कर सकते हैं।

public function getTargets()
{
    //   self::CLASS_CONSTRAINT
    return self::PROPERTY_CONSTRAINT;
}

संदेश संपत्ति, जैसा कि आप अनुमान लगा सकते हैं, का उपयोग सत्यापन त्रुटि के बारे में जानकारी प्रदर्शित करने के लिए किया जाता है।

, .

public function validatedBy()
{
    return \get_class($this).'Validator';
}

, , ConstraintValidator. ConstraintValidator validate.

namespace App\Custom\Constraints;

use Symfony\Component\Validator\ConstraintValidator;

class TextTimeValidator extends ConstraintValidator
{
    /**
     *    
     *
     * @param mixed $value  
     * @param Constraint $constraint   
     */
    public function validate($value, Constraint $constraint)
    {
        $time = explode(':', $value);

        $hours = (int) $time[0];
        $minutes = (int) $time[1];

        if ($hours >= 24 || $hours < 0)
            $this->fail($constraint);
        else if ((int) $time[1] > 60 || $minutes < 0)
            $this->fail($constraint);
    }

    private function fail(Constraint $constraint) 
    {
        $this->context->buildViolation($constraint->message)
            ->addViolation();
    }
}

, , , .

...
    /**
     * @Assert\NotBlank()
     * @Assert\Regex(
     *     pattern="/\d{2}:\d{2}/",
     *     message=" "
     * )
     * @CustomAssert\TextTime()
     * @ORM\Column(type="string", length=5)
     */
    private $timeFrom;
...

, , . , , , message .

. , Symfony Time. : . , "hh:mm:ss". , .

, , - . , , : "hh:mm", "hh:mm"-"hh:mm". , , .

, AbstractComparsion. AbstractComparsion Constraint — .

namespace App\Custom\Constraints;

use Symfony\Component\Validator\Constraints\AbstractComparison;

/**
 * @Annotation
 * @Target({"PROPERTY"})
 */
class TextTimeInterval extends AbstractComparison
{   
    public $message = '       {{ compared_value }}.';
}

namespace App\Custom\Constraints;

use Symfony\Component\Validator\Constraints\AbstractComparisonValidator;

class TextTimeIntervalValidator extends AbstractComparisonValidator
{
    /**
     *       
     *
     * @param mixed $timeFrom   
     * @param mixed $timeTo   
     *
     * @return  true   , false 
     */
    protected function compareValues($timeFrom, $timeTo)
    {
        $compareResult = true;

        $from = explode(':', $timeFrom);
        $to = explode(':', $timeTo);

        try {
            if ((int) $from[0] > (int) $to[0])
                $compareResult = false;
            else if (((int) $from[0] == (int) $to[0]) && ((int) $from[1] > (int) $to[1])) {
                $compareResult = false;
            }
        } catch (\Exception $exception) {
            $compareResult = false;
        }

        return $compareResult;
    }
}

केवल इस मामले में (संभावित कार्यान्वयन में से एक) हम तुलनात्मक फ़ंक्शन को ओवरराइड करते हैं, जो सत्यापन सफलता पर सही / गलत रिटर्न देता है और सत्यापन () फ़ंक्शन द्वारा AbstractComparisonValidator में संसाधित होता है।

यह अनिवार्य रूप से निम्नानुसार वर्णित है

...
 /**
     * @Assert\NotBlank()
     * @Assert\Regex(
     *     pattern="/\d{2}:\d{2}/",
     *     message=" "
     * )
     * @CustomAssert\TextTime()
     * @CustomAssert\TextTimeInterval(
     *     propertyPath="timeTo",
     *     message="       "
     * )
     * @ORM\Column(type="string", length=5)
     */
    private $timeFrom;

    /**
     * @Assert\NotBlank()
     * @Assert\Regex(
     *     pattern="/\d{2}:\d{2}/",
     *     message=" "
     * )
     * @CustomAssert\TextTime()
     * @ORM\Column(type="string", length=5)
     */
    private $timeTo;
...

उम्मीद है कि इस छोटे से विश्लेषण और उदाहरणों से पता चला है कि कस्टम सत्यापनकर्ताओं का उपयोग करना कितना आसान है। चूंकि शुरुआत के लिए हमने सबसे सरल सत्यापनकर्ताओं पर विचार किया, निश्चित रूप से, विषय विवरणों के साथ प्रस्तुति को अधिभार नहीं देने के लिए, हम असाधारण उदाहरण देने में विफल रहे। भविष्य के लेखों में मैं और अधिक जटिल सत्यापनकर्ताओं और विशिष्ट मामलों पर विचार करने की योजना बना रहा हूं।