🛀 🤲🏾 🎌 Yii फ्रेमवर्क और डॉक्ट्रिन 2 ORM को कैसे लिंक करें? 🤷🏾 🦋 🦂

मुझे वास्तव में Yii फ्रेमवर्क पसंद है। यह तेज, सुविधाजनक, लचीला है। मुझे पसंद है कि इसमें ActiveRecord पैटर्न कैसे लागू किया जाता है। लेकिन ऐसे समय होते हैं जब व्यापार तर्क, और, सटीक होने के लिए, डोमेन तर्क, बहुत जटिल है और लगातार बढ़ रहा है और संशोधित कर रहा है। ऐसे मामलों में, DataMapper पैटर्न का उपयोग करना अधिक सुविधाजनक है।

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

इस प्रकार, एक दिन यह मेरे लिए इन दिलचस्प उपकरणों में से 2 को जोड़ने के लिए हुआ। यह कैसे किया गया नीचे वर्णित किया गया है।

आवश्यक लाइब्रेरी स्थापित करें

Doctrine और Yii को जोड़ने के लिए DoctrineComponent घटक बनाकर निर्णय लिया गया था, जो Doctrine कार्यों तक पहुंच प्रदान करेगा।

सबसे पहले, विक्रेता फ़ोल्डर को संरक्षित फ्रेमवर्क फ़ोल्डर में बनाया गया था, जहां डॉक्ट्रिन 2 ओआरएम कोड अपलोड किया गया था। GitHub Doctrine प्रोजेक्ट से स्रोत कोड को डाउनलोड / क्लोन करके आप संगीतकार का उपयोग कर सकते हैं ।
इसके अलावा, ओआरएम के सही संचालन के लिए, आपको डॉक्ट्रिन डेटाबेस एब्स्ट्रेक्शन लेयर और डॉक्ट्रिन कॉमन की आवश्यकता होगी (जब कम्पोजर का उपयोग करके डॉक्ट्रिन 2 ओआरएम को स्थापित किया जाता है, तो ये निर्भरताएं स्वचालित रूप से खींच ली जाती हैं)।

इसके अलावा, मैं अनुशंसा करता हूं कि कंसोल के माध्यम से डॉक्ट्रिन 2 ओआरएम के साथ काम करने में सक्षम होने के लिए, एक ही फ़ोल्डर में सिम्फनी घटक के विक्रेता 2 फ़ोल्डर स्थापित करें - ये कंसोल ( कंसोल के माध्यम से डॉक्ट्रिन के साथ काम करने के लिए) और यमल (यदि आप यमल पर संस्थाओं का वर्णन करना चाहते हैं)

इस प्रकार, इस स्तर पर, निम्नलिखित परियोजना संरचना प्राप्त की जानी चाहिए:

DoctrineComponent घटक बनाना

अब आप DoctrineComponent घटक बनाने के लिए सीधे जा सकते हैं। नीचे मैं संपूर्ण घटक कोड दूंगा, क्योंकि यह छोटा है। यह कोड DoctrineComponent.php फ़ाइल में सुरक्षित / घटक फ़ोल्डर में स्थित होना चाहिए।

DoctrineComponent.php फ़ाइल कोड

use Doctrine\ORM\EntityManager; use Doctrine\ORM\Configuration; use Doctrine\ORM\Mapping\Driver\AnnotationDriver; use Doctrine\Common\Annotations\AnnotationReader; use Doctrine\Common\Annotations\AnnotationRegistry; class DoctrineComponent extends CComponent { private $em = null; private $basePath; private $proxyPath; private $entityPath; private $driver; private $user; private $password; private $host; private $dbname; public function init() { $this->initDoctrine(); } public function initDoctrine() { Yii::setPathOfAlias('Doctrine', $this->getBasePath() . '/vendor/Doctrine'); $cache = new Doctrine\Common\Cache\FilesystemCache($this->getBasePath() . '/cache'); $config = new Configuration(); $config->setMetadataCacheImpl($cache); $driverImpl = new AnnotationDriver(new AnnotationReader(), $this->getEntityPath()); AnnotationRegistry::registerAutoloadNamespace('Doctrine\ORM\Mapping', $this->getBasePath() . '/vendor'); $config->setMetadataDriverImpl($driverImpl); $config->setQueryCacheImpl($cache); $config->setProxyDir($this->getProxyPath()); $config->setProxyNamespace('Proxies'); $config->setAutoGenerateProxyClasses(true); $connectionOptions = array( 'driver' => $this->getDriver(), 'user' => $this->getUser(), 'password' => $this->getPassword(), 'host' => $this->getHost(), 'dbname' => $this->getDbname() ); $this->em = EntityManager::create($connectionOptions, $config); } public function setBasePath($basePath) { $this->basePath = $basePath; } public function getBasePath() { return $this->basePath; } public function setEntityPath($entityPath) { $this->entityPath = $entityPath; } public function getEntityPath() { return $this->entityPath; } public function setProxyPath($proxyPath) { $this->proxyPath = $proxyPath; } public function getProxyPath() { return $this->proxyPath; } public function setDbname($dbname) { $this->dbname = $dbname; } public function getDbname() { return $this->dbname; } public function setDriver($driver) { $this->driver = $driver; } public function getDriver() { return $this->driver; } public function setHost($host) { $this->host = $host; } public function getHost() { return $this->host; } public function setPassword($password) { $this->password = $password; } public function getPassword() { return $this->password; } public function setUser($user) { $this->user = $user; } public function getUser() { return $this->user; } /** * @return EntityManager */ public function getEntityManager() { return $this->em; } }

घटक का मुख्य भाग initDoctrine विधि में संलग्न है। आइए कोड का अधिक विस्तार से विश्लेषण करें।

 $cache = new Doctrine\Common\Cache\FilesystemCache($this->getBasePath() . '/cache'); $config = new Configuration(); $config->setMetadataCacheImpl($cache);

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

 $driverImpl = new AnnotationDriver(new AnnotationReader(), $this->getEntityPath()); AnnotationRegistry::registerAutoloadNamespace('Doctrine\ORM\Mapping', $this->getBasePath() . '/vendor'); $config->setMetadataDriverImpl($driverImpl);

ऊपर दिए गए कोड का उपयोग करके, एक चालक इकाई मेटाडेटा को पढ़ने के लिए स्थापित किया गया है।

  $config->setQueryCacheImpl($cache); $config->setProxyDir($this->getProxyPath()); $config->setProxyNamespace('Proxies'); $config->setAutoGenerateProxyClasses(true);

ऊपर दिए गए कोड के साथ, हम अनुरोधों (पहली पंक्ति) के लिए कैशिंग विधि सेट करते हैं, बाकी पंक्तियाँ Doctrine (पथ, नाम स्थान, प्रॉक्सी कक्षाओं की स्वचालित पीढ़ी) के लिए प्रॉक्सी सेटिंग्स हैं

 $connectionOptions = array( 'driver' => $this->getDriver(), 'user' => $this->getUser(), 'password' => $this->getPassword(), 'host' => $this->getHost(), 'dbname' => $this->getDbname() ); $this->em = EntityManager::create($connectionOptions, $config);

ऊपर कोड डेटाबेस से कनेक्ट करने के लिए विकल्पों को परिभाषित करता है। ये पैरामीटर घटक को कनेक्ट करते समय सेट किए जाते हैं (यह बाद में दिखाया जाएगा कि घटक को कैसे जोड़ा जाए)।
और अंत में, एक EntityManager पहले $connectionOptions और $config परिभाषित किया गया है, जिसके साथ आप हमारी संस्थाओं के साथ काम कर सकते हैं।

DoctrineComponent को प्रोजेक्ट से कैसे कनेक्ट करें?

आइए, DoctrineComponent को परियोजना से जोड़ने के लिए आगे बढ़ें।
ऐसा करने के लिए यह काफी सरल है - आपको बस प्रोजेक्ट कॉन्फ़िगरेशन फ़ाइल में परिवर्तन करने की आवश्यकता है (आमतौर पर यह मुख्य है। पीएचपी)

 return array( 'components' => array( 'doctrine'=>array( 'class' => 'DoctrineComponent', 'basePath' => __DIR__ . '/../', 'proxyPath' => __DIR__ . '/../proxies', 'entityPath' => array( __DIR__ . '/../entities' ), 'driver' => 'pdo_mysql', 'user' => 'dbuser', 'password' => 'dbpassword', 'host' => 'localhost', 'dbname' => 'somedb' ), // ... );

अब हमारा घटक Yii::app()->doctrine माध्यम से उपलब्ध होगा, और हम Yii::app()->doctrine->getEntityManager() माध्यम से EntityManager प्राप्त कर सकते हैं।

लेकिन घटक के इस उपयोग के साथ, EntityManager ऑब्जेक्ट के लिए विधि संकेत में एक समस्या उत्पन्न होती है। इसके लिए, निम्नलिखित समाधान का आविष्कार किया गया था:

 lass MainController extends Controller { private $entityManager = null; /** * @return Doctrine\ORM\EntityManager */ public function getEntityManager() { if(is_null($this->entityManager)){ $this->entityManager = Yii::app()->doctrine->getEntityManager(); } return $this->entityManager; } // ... }

प्रत्येक नियंत्रक अब MainController से विरासत में मिला है MainController और इसलिए, प्रत्येक नियंत्रक में, आप इकाई प्रबंधक को प्राप्त करने के लिए $this->getEntityManager() विधि को कॉल कर सकते हैं, और EntityManager लिए $this->getEntityManager() अब IDE में काम करेंगे, जो निस्संदेह एक प्लस है।

सिद्धांत कंसोल को कॉन्फ़िगर करना

सिद्धांत अपने कंसोल के माध्यम से काम करने के लिए बहुत सुविधाजनक है। लेकिन इसके लिए आपको इसे चलाने के लिए कोड लिखना होगा। यह कोड नीचे दिया गया है। मैंने कंसोल को सुरक्षित / कमांड फ़ोल्डर में लॉन्च करने के लिए फ़ाइल डाल दी। कंसोल को और भी आसान शुरू करने के लिए doctrine आदेश को लागू करना अच्छा होगा, लेकिन मैंने अभी तक ऐसा नहीं किया है।

Doctrine कंसोल के साथ काम करने के लिए एक उदाहरण doctrine.php फ़ाइल।

Doctrine.php फ़ाइल कोड

 // change the following paths if necessary $yii = __DIR__ .'path/to/yii.php'; $config = __DIR__ . 'path/to/config/console.php'; require_once($yii); Yii::createWebApplication($config); Yii::setPathOfAlias('Symfony', Yii::getPathOfAlias('application.vendor.Symfony')); $em = Yii::app()->doctrine->getEntityManager(); $helperSet = new \Symfony\Component\Console\Helper\HelperSet(array( 'db' => new \Doctrine\DBAL\Tools\Console\Helper\ConnectionHelper($em->getConnection()), 'em' => new \Doctrine\ORM\Tools\Console\Helper\EntityManagerHelper($em) )); \Doctrine\ORM\Tools\Console\ConsoleRunner::run($helperSet);

डॉक्ट्रिन कंसोल को शुरू करने के लिए, बस कमांड फोल्डर में जाएं और php doctrine.php निष्पादित करें।

GridView विजेट में मॉडल का मॉडल सत्यापन और उपयोग।

जिन लोगों ने डॉक्ट्रिन 2 ओआरएम के साथ काम किया है, वे जानते हैं कि वास्तव में उनकी आम तौर पर स्वीकृत अवधारणा में कोई मॉडल नहीं हैं (सत्यापन विधियों के साथ, डेटाबेस से डेटा प्राप्त करना, सक्षम व्यावसायिक तर्क इत्यादि), और यह कार्यक्षमता वास्तव में 2 भागों में विभाजित है - Entity और Repository । Entity आमतौर पर व्यावसायिक तर्क शामिल होते हैं, और Repository , डीबीएएल डॉक्ट्रिन (या तो एक इकाई प्रबंधक या अन्य विधियों) का उपयोग करके डेटाबेस से डेटा प्राप्त करने के तरीके।

मॉडल मान्यता

इस प्रकार, मेरी राय में, एक विशिष्ट इकाई के वर्ग में डेटा सत्यापन को शामिल करना तर्कसंगत होगा।
User इकाई के उदाहरण पर विचार करें।
पहिया को सुदृढ़ नहीं करने के लिए, यह तय किया गया था कि CModel. से विशेष रूप से CModel. वर्ग से पहले से निर्मित मॉडल सत्यापन का उपयोग करना अच्छा होगा CModel.

ऐसा करने के लिए, आप सीएमओडेल वर्ग से केवल उपयोगकर्ता इकाई का वारिस कर सकते हैं। इस तरह की एक इकाई का उदाहरण नीचे वर्णित सत्यापन नियमों के साथ है:

उपयोगकर्ता इकाई कोड

 use Doctrine\ORM\Mapping as ORM; /** * User * * @ORM\Table(name="user") * @ORM\Entity(repositoryClass="UserRepository") * @ORM\HasLifecycleCallbacks */ class User extends CModel { /** * @var integer * * @ORM\Column(name="id", type="integer", nullable=false) * @ORM\Id * @ORM\GeneratedValue(strategy="IDENTITY") */ private $id; /** * @var string * * @ORM\Column(name="name", type="string", length=255, nullable=false) */ private $name; /** * @var string * * @ORM\Column(name="password", type="string", length=255, nullable=false) */ private $password; /** * @var string * * @ORM\Column(name="email", type="string", length=255, nullable=false) */ private $email; /** * @var string * * @ORM\Column(name="role", type="string", length=255, nullable=false) */ private $role; /** * @var \DateTime * * @ORM\Column(name="created", type="datetime", nullable=false) */ private $created; /** * @var \DateTime * * @ORM\Column(name="modified", type="datetime", nullable=false) */ private $modified; public function rules(){ return array( array('name, password', 'required'), // ... ); } public function attributeNames() { return array( 'id'=>'id', 'name'=>'name', 'email'=>'email', 'created'=>'created', 'updated'=>'updated' ); } public function attributeLabels() { return array( 'description' => 'Description', 'createdString' => 'Creation Date' ); } // ... }

अब मैं इस सत्यापन के साथ काम करने का एक उदाहरण दूंगा (नीचे एक नया उपयोगकर्ता बनाने का एक उदाहरण)

  /** * Creates a new model. * If creation is successful, the browser will be redirected to the 'view' page. */ public function actionCreate() { $user = new User(); $userData = $this->getRequest()->get('User'); $course->setAttributes($userData); if(!is_null($userData) && $user->validate()) { $user->setName($userData['name']); // ...      $this->getEntityManager()->persist($user); $this->getEntityManager()->flush(); $this->redirect(array('view','id'=>$user->getId())); } $this->render('create',array( 'model'=>$user, )); }

एक ग्रिड व्यू विजेट में मॉडल का उपयोग करना

Yii के मुख्य आकर्षण में से एक है, मेरी राय में, विगेट्स, और विशेष रूप से विभिन्न ग्रिड, जो बॉक्स से बाहर Yii में जाते हैं।
लेकिन एकमात्र चेतावनी यह है कि वे ActiveRecord साथ काम करते हैं (मेरा मतलब है GridView विजेट)। और व्यक्तिगत रूप से, मैं उन्हें डॉक्ट्रिन और संस्थाओं के साथ काम करना चाहूंगा। आप इसके लिए Repository उपयोग कर सकते हैं।

GridView का उपयोग करते समय GridView 2 अड़चनें होती हैं - dataProvider और filter गुण। और यहां मैं Yii डेवलपर्स के लिए odes गाता हूं - GridView ActiveRecord से प्राप्त किए गए डेटा के अलावा कुछ अन्य प्रकार के साथ काम करने के लिए, यह पर्याप्त है कि ऑब्जेक्ट GridView को पास किया गया क्योंकि dataProvider सही तरीके से IDataProvider इंटरफ़ेस को लागू करता है (यह इंटरफ़ेस हमारे UserRepository में लागू किया जाना चाहिए) ), और filter करने के लिए पारित वस्तु CModel से विरासत में मिली होनी चाहिए (हमारी User इकाई इसके लिए पहले से ही महान है)।

मैं UserRepository का संपूर्ण कार्यान्वयन नहीं दूंगा, मैं केवल सामान्य योजना की रूपरेखा तैयार करूँगा।

BaseRepository वर्ग कोड

 use Doctrine\ORM\EntityRepository; abstract class BaseRepository extends EntityRepository implements IDataProvider { protected $_id; private $_data; private $_keys; private $_totalItemCount; private $_sort; private $_pagination; public $modelClass; public $model; public $keyAttribute; private $_criteria; private $_countCriteria; public $data; abstract protected function fetchData(); abstract protected function calculateTotalItemCount(); public function getId(){ //... } public function getPagination($className='CPagination'){ //... } public function setPagination($value){ //... } public function setSort($value){ //... } public function getData($refresh=false){ //... } public function setData($value){ //... } public function getKeys($refresh=false){ //... } public function setKeys($value){ //... } public function getItemCount($refresh=false){ //... } public function getTotalItemCount($refresh=false){ //... } public function setTotalItemCount($value){ //... } public function getCriteria(){ //... } public function setCriteria($value){ //... } public function getCountCriteria(){ //... } public function setCountCriteria($value){ //... } public function getSort($className='CSort'){ //... } protected function fetchKeys(){ //... } private function _getSort($className){ //... } }

ऊपर एक बुनियादी भंडार का एक उदाहरण कार्यान्वयन है। वास्तव में, कई तरीकों के कार्यान्वयन को Yii वर्ग CActiveDataProvider में देखा जा सकता है जो IDataProvider इंटरफ़ेस को लागू करता है। UserRepository हमें केवल 2 विधियाँ परिभाषित करनी हैं (उदाहरण कोड नीचे):

 <?php class UserRepository extends BaseRepository { protected $_id = 'UserRepository'; /** * Fetches the data from the persistent data storage. * @return array list of data items */ protected function fetchData() { //... } /** * Calculates the total number of data items. * @return integer the total number of data items. */ protected function calculateTotalItemCount() { //... } }

सारांश

ऊपर, मैंने Yii + Doctrine 2 ORM बंडल में काम करने के उनके तरीकों में से एक दिया। बहुत से लोग कह सकते हैं कि Doctrine 2 ORM Yii के कारण इसके फायदे कम हो जाएंगे, लेकिन यह मत भूलिए कि Doctrine के पास अनुकूलन और कैशिंग के लिए भारी मात्रा में उपकरण हैं, और प्लॉयर एसक्यूएल में कोई भी धीमे या गहन प्रश्नों को लिखने से मना नहीं करता है।
लेकिन ऐसे बंडल में हम वास्तु समाधान में जीतते हैं और, मेरी राय में, कोड इस से साफ हो जाता है।

मैं बहुत आभारी रहूंगा यदि टिप्पणियों में आपने Yii का उपयोग करके विषय-उन्मुख प्रोग्रामिंग के बारे में, Yii में ActiveRecord मॉडल में व्यावसायिक तर्क की वृद्धि को हल करने के आपके तरीकों के बारे में डेटामैपर पैटर्न, वाईवाईआई में कुछ अन्य ओआरएम को लागू करने के लिए अपने विकल्पों को साझा किया।

आपका ध्यान देने के लिए धन्यवाद।

Yii फ्रेमवर्क और डॉक्ट्रिन 2 ORM को कैसे लिंक करें?