Yii2 के लिए व्यवहार बनाएँ

अक्सर, और वास्तव में लगभग हमेशा, एक साइट बनाते समय, यह आवश्यक है कि साइट के पृष्ठ डेटाबेस में इकाई की आईडी से नहीं, बल्कि पाठ पहचानकर्ता द्वारा खोले जाएं, इसे स्लग कहते हैं।

post/view/1 => post/view/testovaya-novost 

(यह यूआरएल से दृश्य को हटाने के लायक होगा, लेकिन सबक उस बारे में नहीं है)

सबसे प्रमुख तरीका पोस्ट टेबल में एक स्लग फ़ील्ड बनाना है, पोस्ट मॉडल में एक नई विशेषता दिखाई देती है, दृश्य में एक नया इनपुट जोड़ें, जिसमें हम पेन के साथ स्लग ड्राइव करते हैं।

 <?php use yii\helpers\Html; use yii\widgets\ActiveForm; /** * @var yii\web\View $this * @var common\models\Post $model * @var yii\widgets\ActiveForm $form */ ?> <div class="post-form"> <?php $form = ActiveForm::begin(); ?> <?= $form->field( $model, 'name' )->textInput( [ 'maxlength' => 255 ] ) ?> <?= $form->field( $model, 'slug' )->textInput( [ 'maxlength' => 255 ] ) ?> <?= $form->field( $model, 'content' )->textarea( [ 'rows' => 6 ] ) ?> <div class="form-group"> <?= Html::submitButton( $model->isNewRecord ? Yii::t( 'app', 'Create' ) : Yii::t( 'app', 'Update' ), [ 'class' => $model->isNewRecord ? 'btn btn-success' : 'btn btn-primary' ] ) ?> </div> <?php ActiveForm::end(); ?> </div> 

लेकिन इसे हमेशा पेन के साथ करना दिलचस्प नहीं है (यह बिल्कुल भी दिलचस्प नहीं है कि मैं किसे बेवकूफ बना रहा हूं), इसलिए हम मॉडल में ऐसे तरीके जोड़ते हैं कि जब मॉडल बच जाता है, तो नाम से स्वचालित रूप से स्लग उत्पन्न होता है, तालिका में इसकी विशिष्टता की जांच करें (क्योंकि हम स्लग से पोस्ट निकालेंगे) कुर्सियां, और, इसलिए, स्लग अद्वितीय नहीं हो सकता), अच्छी तरह से, और शायद इसे अनूदित करें (परीक्षण-समाचार => testovaya-novost) - यह भी उपयोगी हो सकता है।
खैर, हम लिखते हैं, हम घटना से जुड़ते हैं, हम परीक्षण करते हैं - सब कुछ काम करता है। और यहां, एक साइट विकसित करते समय, हमें इस तथ्य से सामना करना पड़ता है कि पेज मॉडल में स्लग की अभी भी आवश्यकता है। और माल के लिए कैटलॉग में भी - इसे आइटम मॉडल होने दें। आप कम से कम प्रतिरोध के मार्ग का अनुसरण कर सकते हैं - कॉपी-पेस्ट। लेकिन ...

Yii में, व्यवहार जैसी एक चीज है - एक कार्यात्मक जो आपको विभिन्न मॉडलों में समान कार्यों का उपयोग करने की अनुमति देता है। तो, चलो slug'ification के लिए व्यवहार लिखें।

हमारे पोस्ट मॉडल (उर्फ \ commoin \ मॉडल \ पोस्ट, बस मामले में), हम उस व्यवहार को जोड़ते हैं जो अभी तक नहीं बनाया गया है:

 public function behaviors() { return [ 'slug' => [ 'class' => 'common\behaviors\Slug', 'in_attribute' => 'name', 'out_attribute' => 'slug', 'translit' => true ] ]; } 

हमने कनेक्ट करने के लिए आवश्यक व्यवहार फ़ंक्शन बनाया, उस कक्षा को पंजीकृत किया जिसमें हम स्थित होंगे, और इस वर्ग के लिए तीन विशेषताएँ पारित की गईं:
1. in_attribute - उस मॉडल की विशेषता जिससे स्लग उत्पन्न होगा (विभिन्न मॉडलों में यह भिन्न हो सकता है, उदाहरण के लिए नाम या शीर्षक)
2. out_attribute स्लग की एक विशेषता है, क्रमशः (स्लग या उपनाम)
3. अनुवाद - यहाँ सब कुछ स्पष्ट है

व्यवहार बनाते समय, एक और चौथी विशेषता थी - अद्वितीय, लेकिन फिर मैंने इस कार्यक्षमता को बाहर कर दिया, क्योंकि यह बहुत दुर्लभ है कि स्लग अद्वितीय नहीं है।

मैं आपको याद दिलाता हूं कि मैं yii2-app-advanced एप्लिकेशन की संरचना का उपयोग करता हूं, अर्थात्, मेरे पास बैकएंड और फ्रंटएंड फ़ोल्डर हैं जिसमें नियंत्रक और दृश्य स्थित हैं, और सामान्य फ़ोल्डर, जिसमें सामान्य मॉडल और व्यवहार हैं।

सामान्य / व्यवहार / Slug.php बनाएँ:

 <?php namespace common\behaviors; use yii; use yii\base\Behavior; use yii\db\ActiveRecord; class Slug extends Behavior { public $in_attribute = 'name'; public $out_attribute = 'slug'; public $translit = true; public function events() { return [ ActiveRecord::EVENT_BEFORE_VALIDATE => 'getSlug' ]; } } 

हम yii \ base \ Behavior से क्लास इनहेरिट करते हैं, प्रारंभिक सेटिंग्स के साथ तीन विशेषताएँ निर्धारित करते हैं, ईवेंट विधि बनाते हैं, जो मॉडल को सहेजते समय व्यवहार को कुछ ईवेंट से जोड़ देगा। चूंकि स्लग आमतौर पर आवश्यक है और नियमों में आवश्यक रूप से लिखा जा सकता है, तो हम सत्यापन से पहले स्लग पीढ़ी को बांध देंगे।

 ActiveRecord::EVENT_BEFORE_VALIDATE => 'getSlug' 

अब getSlug विधि बनाएं:

 public function getSlug( $event ) { if ( empty( $this->owner->{$this->out_attribute} ) ) { $this->owner->{$this->out_attribute} = $this->generateSlug( $this->owner->{$this->in_attribute} ); } else { $this->owner->{$this->out_attribute} = $this->generateSlug( $this->owner->{$this->out_attribute} ); } } 

मॉडल ऑब्जेक्ट को व्यवहार में इस $ के रूप में पारित किया जाता है-> मालिक। इस प्रकार, स्लग हमें इस कॉल के माध्यम से $ $ करने के लिए उपलब्ध होगा-> स्वामी-> स्लग या हमारे मामले में $ यह-> स्वामी -> {$ यह-> out_attribute}, क्योंकि स्लग विशेषता का नाम परिवर्तनशील $ इस पर दिया गया है-> out_attribute।
हम यह देखने के लिए जांच करते हैं कि बचत करते समय स्लग खाली है या नहीं, यदि खाली है, तो हम इसे नाम (रिकॉर्ड का शीर्षक) से उत्पन्न करते हैं। यदि यह खाली नहीं है, तो हम प्राप्त स्लग को संसाधित करते हैं।

 private function generateSlug( $slug ) { $slug = $this->slugify( $slug ); if ( $this->checkUniqueSlug( $slug ) ) { return $slug; } else { for ( $suffix = 2; !$this->checkUniqueSlug( $new_slug = $slug . '-' . $suffix ); $suffix++ ) {} return $new_slug; } } 

विधि की पहली पंक्ति में, हम अवांछित पात्रों को स्लगिफ़ फ़ंक्शन के साथ हटाते हैं और यदि आवश्यक हो, तो लिप्यंतरण में अनुवाद करते हैं। आइए तुरंत इसे देखें:

 private function slugify( $slug ) { if ( $this->translit ) { return Inflector::slug( TransliteratorHelper::process( $slug ), '-', true ); } else { return $this->slug( $slug, '-', true ); } } 

लिप्यंतरण क्या है? यह मानक लैटिन वर्णमाला में उनके एनालॉग्स द्वारा राष्ट्रीय प्रतीकों का स्थानांतरण है। विदेशी इंटरनेट पर पाए जाने वाले अधिकांश स्निपेट केवल umlauts, कैप और अन्य वर्णों ('À' => 'A', '=' => 'A', '=' => 'A', 'Ã' ') से स्पष्ट पाठ करते हैं। > 'ए'), अर्थात्, "गंदे" लैटिन से "साफ" बनाते हैं। मानक सहायक yii2 yii \ हेल्पर्स \ Inflector :: स्लग भी ऐसा करता है (वैसे, इस पद्धति को व्यवहार के निर्माण के दौरान असंगत रूप से बदल दिया गया था - yii2 पर विकास अभी भी जारी है)। RuNet में, वे क्रमशः लैटिन वर्णमाला के साथ सिरिलिक वर्णमाला की जगह लेते हैं। लेकिन मैं सबसे लचीला लिप्यंतरण बनाना चाहूंगा। Yii \ helpers \ Inflector :: slug का नवीनतम संस्करण php एक्सटेंशन intl का उपयोग करता है, जिसमें चीनी अक्षरों का भी अनुवाद शामिल है, लेकिन, जैसा कि मैं समझता हूं, यह डिफ़ॉल्ट रूप से सक्षम नहीं है (php 5.5.6)। लेकिन yii में रुचि रखने वाले सभी के लिए एक अद्भुत 2amigos डेवलपर, अनुवादक-सहायक-ऐड-ऑन पाया (यह, बदले में, ड्रुपल से विचारों का उपयोग करता है, जहां तक ​​मुझे याद है)। यह php फ़ाइलों की एक निश्चित संख्या का प्रतिनिधित्व करता है, जो अधिकांश वर्णों और लैटिन में उनके प्रतिस्थापन का वर्णन करता है।
निर्भरता जोड़ें "2amigos/transliterator-helper": "2.0.*" कंपोज़र.जसन के लिए, इसे अपडेट करें और अब dosamigos \ helpers \ Transliterator हेल्पर हमारे लिए उपलब्ध है:

 return Inflector::slug( TransliteratorHelper::process( $slug ), '-', true ); 

हम अनुवाद करते हैं, गैर-वर्णनात्मक वर्णों से स्पष्ट, रिक्त स्थान को डैश के साथ प्रतिस्थापित करते हैं "-"।

यदि हमें लिप्यंतरण की आवश्यकता नहीं है, तो:

 return $this->slug( $slug, '-', true ); 

स्लग विधि (yii \ हेल्पर्स \ Inflector का छोटा संस्करण :: ट्रांसलिटरेशन के बिना स्लग):

 private function slug( $string, $replacement = '-', $lowercase = true ) { $string = preg_replace( '/[^\p{L}\p{Nd}]+/u', $replacement, $string ); $string = trim( $string, $replacement ); return $lowercase ? strtolower( $string ) : $string; } 

वापस उत्पन्न करने के लिए:

 private function generateSlug( $slug ) { $slug = $this->slugify( $slug ); if ( $this->checkUniqueSlug( $slug ) ) { return $slug; } else { for ( $suffix = 2; !$this->checkUniqueSlug( $new_slug = $slug . '-' . $suffix ); $suffix++ ) {} return $new_slug; } } 

दूसरी पंक्ति, हम डेटाबेस में विशिष्टता के लिए स्लग की जांच करते हैं। मैं आपको याद दिलाता हूं कि हमें एक गैर-अद्वितीय स्लग की आवश्यकता नहीं है, क्योंकि हम इसका उपयोग तालिका से डेटा निकालने के लिए करेंगे।

 private function checkUniqueSlug( $slug ) { $pk = $this->owner->primaryKey(); $pk = $pk[0]; $condition = $this->out_attribute . ' = :out_attribute'; $params = [ ':out_attribute' => $slug ]; if ( !$this->owner->isNewRecord ) { $condition .= ' and ' . $pk . ' != :pk'; $params[':pk'] = $this->owner->{$pk}; } return !$this->owner->find() ->where( $condition, $params ) ->one(); } 

सिद्धांत रूप में, प्राथमिक कुंजी आईडी नहीं हो सकती है, इसलिए हम इसे प्राथमिकके () फ़ंक्शन के साथ ढूंढते हैं। अगला, हम इस तरह के एक स्लग के अस्तित्व के लिए तालिका के लिए अनुरोध करते हैं। यदि रिकॉर्ड नया नहीं है, और हम अपडेट करते हैं (! $ This-> owner-> isNewRecord), तो स्लग पहले से मौजूद हो सकता है और इस आईडी के लिए अपवाद बना सकता है:

 $condition .= ' and ' . $pk . ' != :pk'; 

यदि स्लग अद्वितीय है, और गलत है तो फ़ंक्शन सही है। अगले:

 if ( $this->checkUniqueSlug( $slug ) ) { return $slug; } else { for ( $suffix = 2; !$this->checkUniqueSlug( $new_slug = $slug . '-' . $suffix ); $suffix++ ) {} return $new_slug; } 

यदि स्लग अद्वितीय है, तो हम इसे वापस करते हैं, इसे मॉडल विशेषता को असाइन करते हैं और मॉडल को डेटाबेस में सहेजते हैं। यदि यह अद्वितीय नहीं है, तो डिजिटल प्रत्यय testovaya-novost-2 जोड़ें

 for ( $suffix = 2; !$this->checkUniqueSlug( $new_slug = $slug . '-' . $suffix ); $suffix++ ) {} 

जानवर बल विधि का उपयोग करते हुए, हम पहले मुक्त प्रत्यय पाते हैं और इसे स्लग में जोड़ते हैं। इसका समाधान वर्डप्रेस में दिया गया है, लेकिन मैं इसे प्रत्येक प्रत्यय के लिए पसंद नहीं करता, जो हम इसे मांग पर करते हैं, क्रमशः जब टेस्टोवेया-नोवोस्ट, टेस्टोवैय्या-नोवोस्ट -2, टेस्टोवैया-नोवोस्ट -3, टेस्टोवैय्या-नोवोस्ट -4, टेस्टोवैय्या-नोवोस्ट -5 हमारे लिए। विशिष्टता को सत्यापित करने के लिए आपको 6 प्रश्न करने होंगे। अगर कोई बेहतर समाधान दे सकता है, तो मैं आभारी रहूंगा।

तो, स्लग उत्पन्न होता है, मॉडल में स्थानांतरित किया जाता है, डेटाबेस में सहेजा जाता है, और हम अन्य मॉडलों में परिणामी व्यवहार का उपयोग करते हैं।



व्यवहार कोड ऊपर दिया गया है। लिप्यंतरण का एक उदाहरण:

    test 我爱 中文 Ψ ᾉ Ǽ ß  => test-test-y-test-wo-ai-zhong-wen-ps-a-ae-ss-c 

संदर्भ:

• वाईआई फ्रेमवर्क की आधिकारिक साइट
• रूसी भाषी समुदाय
• Github yii2 पर भंडार
• वर्जन 2 डॉक्यूमेंटेशन वर्तमान में लिखा है