👨🏼‍🎨 🎳 👨🏻‍🎨 Yii को फाइलें अपलोड करें 🛀🏼 🌁 ⛹️

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

कार्य निम्नानुसार है। हमें फाइल और चित्रों को सर्वर पर अपलोड करने के लिए (आवश्यक जांच सहित) के लिए एक सुविधाजनक तंत्र की आवश्यकता है, चित्रों के लिए थंबनेल बनाने और फ़ाइल को डाउनलोड करने के लिए स्वचालित टैग और लिंक। एक्सटेंशन में कुछ नहीं मिला। अर्थ में निकटतम अपलोड एक्सटेंशन है, लेकिन यह कई आवश्यक कार्य प्रदान नहीं करता है। इसलिए मैंने खुद लिखने का फैसला किया। लेख के प्रकाशन से ठीक पहले, मैंने गलती से एक नुस्खा देखा जो एक समान विचार को देखता था।

कोड उदाहरण केवल संदर्भ के लिए हैं, मैंने उन्हें एक कार्यशील परियोजना से सम्मिलित किया, लेकिन मैं कुछ भ्रमित कर सकता था। यदि आपको काम करने वाले कोड की आवश्यकता है, तो लेख के अंत में परियोजना के लिए एक लिंक है। तो आगे बढ़ो!

पहला पुनरावृति हम मानक कार्यक्षमता के पूरक हैं।

Yii क्या प्रदान करता है? सबसे पहले, CUploadedFile वर्ग, जो डाउनलोड की गई फ़ाइल के बारे में जानकारी प्रदान करता है और आपको इसे सर्वर पर सहेजने की अनुमति देता है। दूसरे, CFileValidator सत्यापनकर्ता, जो डाउनलोड की गई फ़ाइल की जांच करता है। यहां बताया गया है कि आधिकारिक दस्तावेज फाइलों को डाउनलोड करने की सिफारिश कैसे करते हैं:

 //  class MyModel extends CActiveRecord { public $image; public function rules(){ return array( array('image', 'file', 'types'=>'jpg, gif, png'), ); } } //  class MyModelController extends CController { public function actionCreate(){ $modMyModel=new MyModel; if(isset($_POST['MyModel'])){ $modMyModel->attributes=$_POST['MyModel']; $modMyModel->id_image=CUploadedFile::getInstance($modMyModel,'image'); if($modMyModel->save()){ $modMyModel->id_image->saveAs('path/to/localFile'); //   ,     //   } } $this->render('create', array('model'=>$modMyModel)); } } //  <?php echo CHtml::form('','post',array('enctype'=>'multipart/form-data')); ?> ... <?php echo CHtml::activeFileField($modMyModel, 'image'); ?> ... <?php echo CHtml::endForm(); ?>

इस दृष्टिकोण के कई नुकसान हैं:

फ़ाइलों को डाउनलोड करने के लिए फ्रेमवर्क में एक समर्पित फ़ोल्डर नहीं है
फाइल अपलोड को हर बार कंट्रोलर में बताना होगा
इंगित दृष्टिकोण को actionUpdate() स्थानांतरित नहीं किया जा सकता है, क्योंकि यह अपेक्षा करता है कि हर कॉल के साथ एक फ़ाइल लोड की जाए। और साधारण गुणों के साथ फाइलों के साथ काम करना सुविधाजनक होगा - मॉडल बनाते समय लोड करें और यदि आवश्यक हो, तो इसे बदलते समय पुनरारंभ करें।
फ़ाइल के बाद के उपयोग के बारे में कोई सिफारिश नहीं है। हालांकि, मॉडल प्रॉपर्टी में path/to/localFile को स्टोर किया जा सकता है।

बेशक, मैं केवल अपनी परियोजनाओं के संदर्भ में इन कमियों के बारे में बात कर रहा हूं। और यहाँ मैं पेश करना चाहता हूँ।

सबसे पहले, फाइलों को सहेजने के लिए एक जगह तय करते हैं। मेरी राय में, निर्देशिका .../protected/data/files भंडारण .../protected/data/files लिए सबसे उपयुक्त है। सामान्यतया, काम के दौरान बनाई गई फ़ाइलों के लिए, एक फ़ोल्डर है .../protected/runtime , लेकिन अर्थ के संदर्भ में data निर्देशिका इन उद्देश्यों के लिए अधिक उपयुक्त है। फ़ाइल नाम बेतरतीब ढंग से उत्पन्न किया जाएगा ( uniqid() ) और मॉडल में संग्रहीत $modMyModel->id_image , अगले पैराग्राफ में मैं आपको बताऊंगा कि कैसे। सच है, इस दृष्टिकोण में एक नुकसान है - data निर्देशिका ब्राउज़र से पहुंच के लिए बंद है। इससे कैसे निपटें - थोड़ी देर बाद। आगे देखते हुए, मेरा सुझाव है कि आप फ़ाइलों को readfile() माध्यम से गतिशील रूप से डाउनलोड करें, और assets फ़ोल्डर में चित्र (अधिक सटीक, चित्रों के थंबनेल) प्रकाशित करें।

हमने फ़ोल्डर और फ़ाइल का नामकरण हल किया। अब हम सत्यापन और लोडिंग से निपटेंगे। शुरुआत करते हैं फॉर्म से। ऐसा करते हैं:

 <?php echo $modMyModel->id_image ?> <?php echo CHtml::activeFileField($modMyModel, 'id_image_file'); ?>

इसलिए हम देखेंगे कि फाइल अपलोड है या नहीं। और फ़ाइल को id_image_file नाम से लोड किया जाएगा। echo $modMyModel->id_image बजाय echo $modMyModel->id_image आप एक फ़ाइल या थंबनेल छवि डाउनलोड करने के लिए एक लिंक सम्मिलित कर सकते हैं।

अब मान्यता है। विचार यह है: सत्यापनकर्ता को जांच करनी चाहिए कि क्या $_FILES डाउनलोड की गई फ़ाइल है जिसे id_image_file कहा जाता है। यदि हां, तो एक CUploadedFile ऑब्जेक्ट बनाएं और इसे $modMyModel->id_image । फिर मानक तरीके से $modMyModel->id_image मान्य करें। ऐसा करने के लिए, DFileValidator से विरासत में मिला अपना स्वयं का DFileValidator सत्यापनकर्ता CFileValidator । और तुरंत एक और - DImageValidator , DImageValidator से विरासत में मिला, जिसमें हम चित्रों के लिए डिफ़ॉल्ट फ़ाइल प्रकारों का संकेत देते हैं।

और अंत में, फ़ाइल को लोड करना और मॉडल को सहेजना। सत्यापन के बाद, डाउनलोड की गई फ़ाइल $modMyModel->id_image , और $modMyModel->id_image के रूप में CUploadedFile । लोडिंग को किसी विशेष प्रॉपर्टी से बंधे होने से बचाने के लिए, आपको यह जांचने की आवश्यकता है कि क्या मॉडल को सहेजने से पहले इसकी कोई भी गुण CUploadedFile क्लास की ऑब्जेक्ट्स हैं, और यदि वे हैं, तो उन्हें लोड करें और एड्रेस सेव करें। अब मॉडल इस तरह दिखेगा:

 class MyModel extends DActiveRecord { public $id_image; public function rules(){ return array( array('id_image', 'DImageValidator'), ); } public function beforeSave() { foreach ($this->attributes as $key => $attribute) if ($attribute instanceof CUploadedFile) { $strSource = uniqid(); if ($attribute->saveAs(Yii::getPathOfAlias('application.data.files') . '/' . $strSource)) $this->$key = $strSource; } return parent::beforeSave(); } }

छवि संपत्ति को आइडेंटि_ प्रॉपर्टी द्वारा सचेत रूप से बदल दिया गया है। आगे यह स्पष्ट होगा कि क्यों।

उप-योग का सारांश प्रस्तुत करना

सभी फाइलें फ़ोल्डर में सहेजी जाती हैं .../protected/data/files रैंडम नामों के साथ .../protected/data/files ।
डेटाबेस में सहेजे जाने से पहले फ़ाइल अपलोडिंग मॉडल में की जाती है।
एक फ़ाइल के रूप में एक संपत्ति को चिह्नित करने के लिए, आपको चाहिए:
1. rules() मॉडल में, इस संपत्ति के DFileValidator सत्यापनकर्ता को असाइन करें।
2. प्रपत्र में, '_file' को '_file' इस संपत्ति के लिए इनपुट का नाम बदलें।
actionCreate() और actionUpdate() तरीकों को अपरिवर्तित छोड़ा जा सकता है।

दूसरा पुनरावृति। हम डेटाबेस कनेक्ट करते हैं।

हमने पता लगाया कि फ़ाइल कैसे अपलोड करें। लेकिन जबकि यह स्पष्ट नहीं है कि उससे कैसे संपर्क किया जाए। img टैग के src पैरामीटर में क्या लिखना है? डाउनलोड के लिए फाइल कैसे दें? मेरी राय में, फ़ाइलों के साथ काम करने के लिए वाईआईआई मॉडल की कार्यक्षमता का उपयोग करना सुविधाजनक होगा। वास्तव में, यदि कोई मॉडल प्रत्येक डाउनलोड की गई फ़ाइल से मेल खाती है, तो डाउनलोड करने सहित सभी निम्न-स्तरीय संचालन को सौंपा जा सकता है। और संपत्ति में $modMyModel->id_image इस मॉडल की प्राथमिक कुंजी संग्रहीत करने के लिए (अब इस संपत्ति के नाम का सार स्पष्ट है)। तब $modMyModel लिए उपयुक्त रिश्तों को निर्धारित करना और लिखना संभव होगा, उदाहरण के लिए, इस तरह:

 //  MyModel: public function relations() { return array( 'image' => array(self::BELONGS_TO, 'DImage', 'id_image'), ); } //  : $modMyModel = new MyModel; echo $modMyModel->id_image->image($htmlOptions); //        img echo $modMyModel->file->downloadLink(); //

इसके अलावा, मॉडल का उपयोग करते समय, मूल फ़ाइल नाम (जो बचत करते समय खो जाता है) को संग्रहीत करने का मुद्दा स्वयं हल हो जाता है।

चलो चलते हैं।

फ़ील्ड id, source, name साथ एक tbl_files तालिका बनाएं। इस तालिका से जुड़े DFile मॉडल को परिभाषित करें। हम इसमें स्थैतिक upload विधि को परिभाषित करते हैं:

 class DFile extends DActiveRecord { public $uploadPath; //     public function init() { $this->uploadPath = Yii::getPathOfAlias('application.data.files'); } public static function upload($objFile) { $modFile = new DFile; $modFile->name = $objFile->name; $modFile->source = uniqid(); if ($objFile->saveAs($modFile->uploadPath . '/' . $modFile->source)) if ($modFile->save()) return $modFile; return null; } }

और तुरंत एक खाली DImage extends DFile बनाएँ DImage extends DFile । हमें बाद में इसकी आवश्यकता होगी।
अब अपने मॉडल को थोड़ा बदलें। चित्र के साथ वादा किए गए कनेक्शन को परिभाषित करें और पहले वाले को beforeSave() विधि को beforeSave() :

 class MyModel extends DActiveRecord { public $id_image; public function rules(){ return array( array('id_image', 'DImageValidator', 'allowEmpty' => true), ); } public function relations() { return array( 'image' => array(self::BELONGS_TO, 'DImage', 'id_image'), ); } public function beforeSave() { foreach ($this->attributes as $key => $attribute) if ($attribute instanceof CUploadedFile) { $modFile = DFile::upload($attribute); //   DFile $this->$key = $modFile->id; } return parent::beforeSave(); } }

मॉडल के $modMyModel ऑब्जेक्ट में, आप $modMyModel->image माध्यम से फ़ाइल तक पहुँच सकते हैं। इसका लाभ कैसे उपयोग करें - इस पर पढ़ें।

तीसरा पुनरावृति। अपलोड की गई फ़ाइलों तक पहुंच।

इस क्षण तक, हमने लगभग फ़ाइलों और चित्रों को साझा नहीं किया। वास्तव में, उन्हें डाउनलोड करना समान है। एकमात्र अंतर प्री-बूट चेक है। लेकिन DFileValidator और DImageValidator सत्यापनकर्ता DFileValidator साथ ठीक कर सकते हैं, जहाँ आप सभी आवश्यक नियमों को निर्दिष्ट कर सकते हैं।

डाउनलोड करने के विपरीत, डाउनलोड की गई फ़ाइलों और चित्रों तक पहुंच अलग-अलग तरीके से की जाती है। फ़ाइलें लोड की जाती हैं ताकि उन्हें बाद में डाउनलोड किया जा सके, और चित्र - उन्हें देखने के लिए। फाइलों के साथ शुरू करते हैं।

फाइलों के साथ काम करें

मैं दोहराता हूं, उन्हें डाउनलोड करने के लिए फाइलें डाउनलोड की जाती हैं। इसके लिए अक्सर एक्सेस अधिकारों के सत्यापन की आवश्यकता होती है। कुल मिलाकर, दो कार्यों को हल करने की आवश्यकता है, अर्थात्, एक डाउनलोड लिंक प्रदान करना और वास्तव में, डाउनलोड करने के लिए एक फ़ाइल जारी करना।

लिंक पीढ़ी DFile में करने के लिए सुविधाजनक है। कुछ इस तरह:

 class DFile extends DActiveRecord { public function downloadLink($htmlOptions = array()) { return CHtml::link($this->name, array('/files/file/download', 'id' => $this->id), $htmlOptions); } }

लिंक FileController नियंत्रक को इंगित करता है। इसे परिभाषित करें:

 class FileController extends DcController { public function actionDownload($id) { $modFile = $this->loadModel($id); header("Content-Type: application/force-download"); header("Content-Type: application/octet-stream"); header("Content-Type: application/download"); header("Content-Disposition: attachment; filename=" . $modFile->name); header("Content-Transfer-Encoding: binary "); readfile($modFile->uploadPath . '/' . $modFile->source); } public function loadModel($id) { $modFile = DFile::model()->findByPk($id); if($modFile === null) throw new CHttpException(404,'The requested page does not exist.'); return $modFile; } }

मुझे लगता है कि यहां सब कुछ स्पष्ट है। actionDownload() विधि कोई अतिरिक्त जांच नहीं करती है, लेकिन यदि आवश्यक हो तो उन्हें शामिल किया जा सकता है। मॉडल में अब, इसी संबंध को निर्धारित करते हुए, आप $modMyModel->file->downloadLink() लिख सकते हैं। बेशक, यह दृष्टिकोण फाइलों के सीधे लिंक जारी करने की तुलना में कम उत्पादक होगा। यदि प्रदर्शन महत्वपूर्ण है, तो आप फ़ाइलों को सुरक्षित data निर्देशिका में नहीं, बल्कि किसी अन्य (खुली) निर्देशिका में, और सीधे लिंक जारी कर सकते हैं।

चित्रों के साथ काम करें

चित्रों के साथ, स्थिति थोड़ी अधिक जटिल है। चित्रों के लिए थंबनेल की आवश्यकता होती है। इसके अलावा, चित्रों के साथ, हम निश्चित रूप से गतिशील लिंक का उत्पादन करने का जोखिम नहीं उठा सकते हैं। सौभाग्य से, Yii एक सुविधाजनक संसाधन प्रकाशन तंत्र प्रदान करता है जिसका उपयोग हमारे उद्देश्यों के लिए किया जा सकता है। विचार यह है: हम चित्र के लिंक बनाते समय संसाधनों के रूप में थंबनेल बनाएंगे और प्रकाशित करेंगे। हालाँकि, कुछ परेशानियाँ हैं। सबसे पहले, यदि आपको स्रोत छवि तक पहुंच की आवश्यकता है, तो आपको इसे assets फ़ोल्डर में भी कॉपी करना होगा। दूसरे, मानक Yii टूल का उपयोग करके प्रकाशन को लागू नहीं किया जा सकता है। तथ्य यह है कि प्रत्येक प्रकाशित फ़ाइल के लिए, Yii अपना स्वयं का फ़ोल्डर बनाएगा, जो कि क्रूर बल होगा। हाँ, और मानक उपकरण के साथ assets फ़ोल्डर में अभी थंबनेल बनाना नहीं किया जा सकता है।

पहली समस्या प्रासंगिक नहीं हो सकती है यदि बहुत सारे चित्र डाउनलोड नहीं किए गए हैं और मूल चित्र तक पहुंच की आवश्यकता नहीं है। मूल चित्रों को उच्च रिज़ॉल्यूशन में संग्रहीत किया जाता है, उन्हें ऊपर वर्णित तंत्र का उपयोग करके डाउनलोड किया जा सकता है, और स्क्रीन पर प्रदर्शित करने के लिए केवल थंबनेल का उपयोग किया जाता है। यदि ऐसी समस्या होती है, तो, विकल्प के रूप में, आप स्रोत छवि को assets फ़ोल्डर में कॉपी नहीं कर सकते हैं, लेकिन एक लिंक बनाएं (Yii में मानक प्रकाशन तंत्र लिंक निर्माण के साथ प्रकाशन प्रदान करता है)।

दूसरी समस्या के लिए, आपको स्वयं ही प्रकाशन लिखना होगा। हालांकि, लिखने के लिए इतना नहीं ...

तो चलिए चलते हैं। हमारे पास पहले से ही DFile से विरासत में मिली DImage क्लास है। हम थंबनेल और प्रकाशन के निर्माण का वर्णन करते हैं:

 class DImage extends DFile { public $assetsPath; //      public $assetsUrl; // URL    public $thumbs = array( 'min' => array('width' => 150, 'height' => 150), 'mid' => array('width' => 250), 'big' => array('width' => 600), ); //   public function init() { $this->assetsUrl = Yii::app()->assetManager->baseUrl . '/files'; $this->assetsPath = Yii::app()->assetManager->basePath . '/files'; if (!is_dir($this->assetsPath)) mkdir($this->assetsPath); } //      $this->assetsPath public function getIsPublished() { foreach ($this->thumbs as $kThumb => $vThumb) if (!is_file($this->assetsPath . '/' . $this->source . '_' . $kThumb)) return false; return true; } //   public function publish() { if (!$this->isPublished) foreach ($this->thumbs as $kThumb => $vThumb) $this->createThumb($this->uploadPath . '/' . $this->source, $this->assetsPath . '/' . $this->source . '_' . $kThumb, $kThumb); return $this->assetsUrl . '/' . $this->source; } //   function createThumb($strSrcFile, $strDstFile, $strThumb) { //    $strSrcFile,   $strDstFile } }

थंबनेल प्रकाशित करने के लिए, मैं assets फ़ोल्डर में एक files सबफ़ोल्डर बनाने का सुझाव देता हूं। यह देखते हुए कि assets फ़ोल्डर को समय-समय पर साफ करने की सिफारिश की जाती है, हर बार assets/files फ़ोल्डर के अस्तित्व की जांच होनी चाहिए। और यदि आवश्यक हो तो बनाएं। थंबनेल नाम छवि पहचानकर्ता के समान है, थंबनेल पहचानकर्ता द्वारा पूरक है। एक छवि को प्रकाशित माना जाता है यदि सभी थंबनेल जगह में हैं। स्रोत और प्रकाशित फ़ाइलों की तारीख की जांच करने का कोई मतलब नहीं है, क्योंकि डाउनलोड की गई फ़ाइल को संशोधित नहीं किया जा सकता है। publish() फ़ंक्शन प्रकाशित छवि का URL देता है (हालांकि एक थंबनेल निर्दिष्ट किए बिना), जो वाईआईआई में प्रकाशन संसाधनों के विचार का खंडन नहीं करता है।

और अंत में, अपलोड की गई छवि तक पहुंचने पर विचार करें। हम image() साथ DImage वर्ग को DImage image() विधि:

 public function image($strThumb = 'min', $htmlOptions = array()) { return CHtml::image($this->publish() . '_' . $strThumb, $this->name, $htmlOptions); }

अब, फ़ाइलों के साथ सादृश्य द्वारा, आप मॉडल में $modMyModel->image->image() लिख सकते हैं। वैसे, अगर थंबनेल के आकार को अचानक बदलने की जरूरत है या एक नया जोड़ा गया है (मेरे लिए एक बार कुछ हुआ), और सभी फाइलें पहले ही डाउनलोड हो चुकी हैं, तो यह सेटिंग्स में आकार बदलने और संपत्ति फ़ोल्डर को साफ करने के लिए पर्याप्त होगा।

छू मंतर

सब कुछ काम करता है। चित्र अपलोड किए गए हैं, प्रदर्शित किए गए हैं। फ़ाइलें अपलोड और डाउनलोड की जाती हैं। यह कोड को थोड़ा कंघी करने के लिए रहता है। उदाहरण के लिए, MySodel वर्ग से DActiveRecord वर्ग के लिए पहले से सेव () विधि को हटाया जा सकता है, जिसमें से, जैसा कि आप देख सकते हैं, सभी मॉडल विरासत में मिले हैं। इसके अलावा, फ़ाइलों और चित्रों के लिए इनपुट का प्रदर्शन DActiveForm extends CActiveForm स्थानांतरित किया जा सकता है जो DActiveForm extends CActiveForm । सेटिंग्स का भंडारण files मॉड्यूल को सौंपा जा सकता है।

खैर, और एक अच्छी परंपरा के अनुसार, एक काम करने वाली परियोजना को डाउनलोड करने के लिए एक लिंक। बड़ी संख्या में निर्भरता के कारण अलग-अलग फ़ाइलों को अपलोड करने के लिए यह समस्याग्रस्त हो गया, इसलिए मैं पूरी परियोजना को पोस्ट करता हूं। डेटाबेस डंप संरक्षित / डेटा / डंप। एससीएल में निहित है। सेटिंग्स से - वाई को पथ निर्दिष्ट करें, डेटाबेस तक पहुंच दर्ज करें। बेस कक्षाएं और सत्यापनकर्ता संरक्षित / घटक फ़ोल्डर में हैं, फाइलों के बारे में सब कुछ फाइलों के मॉड्यूल में है।

निष्कर्ष

तो यहाँ हम उत्पादन है:

केंद्रीकृत फ़ाइल अपलोड और भंडारण प्रबंधन
मॉडल में फ़ाइल गुण बनाने के लिए उपयोगकर्ता के अनुकूल इंटरफेस
फ़ाइलें और IMG टैग डाउनलोड करने के लिए उच्च-स्तरीय लिंक पीढ़ी

विचार विकसित किया जा सकता है। उदाहरण के लिए, लगभग सभी WYCIWYG संपादक फ़ाइलों और छवियों को डाउनलोड करने के लिए एक इंटरफ़ेस प्रदान करते हैं। ऐसा करने के लिए, आपको केवल डाउनलोड पता निर्दिष्ट करना होगा। एक डाउनलोड हैंडलर FileController में शामिल किया जा सकता है। लेकिन फिर थंबनेल कैसे प्रकाशित करें?

या फिर, आप लेखों में वर्णित सुझावों का उपयोग करके सर्वर पर सुरक्षित रूप से चित्र अपलोड कर सकते हैं । भाग एक और सुरक्षित अपलोडिंग छवियाँ सर्वर पर। भाग दो आप ऊपर उल्लिखित अपलोड एक्सटेंशन को पूरक कर सकते हैं। आप कार्यक्षमता को व्यवहार में स्थानांतरित कर सकते हैं।

एक शब्द में, प्रस्तावित समाधान पर विचार करना जल्दबाजी होगी। लेकिन यदि वर्णित विचार उपयोगी हो जाता है, तो मैं काम पूरा करने और संबंधित एक्सटेंशन प्रकाशित करने के लिए तैयार हूं। जो भी पढ़े उसका धन्यवाद!

Yii को फाइलें अपलोड करें