Eloquent संग उपयोगी भण्डार?

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

<?php
interface PostRepository
{
    public function getById($id): Post;
    public function save(Post $post);
    public function delete($id);
}

यद्यपि, वास्तविक परियोजनाहरूमा, यदि भण्डारहरू प्रयोग गर्ने निर्णय गरिएको थियो भने, रेकर्डहरू पुन: प्राप्त गर्ने विधिहरू प्रायः तिनीहरूमा थपिन्छन्:

<?php
interface PostRepository
{
    public function getById($id): Post;
    public function save(Post $post);
    public function delete($id);

    public function getLastPosts();
    public function getTopPosts();
    public function getUserPosts($userId);
}

यी विधिहरू Eloquent स्कोपहरू मार्फत लागू गर्न सकिन्छ, तर आफूलाई ल्याउने जिम्मेवारीमा ओभरलोडिङ इकाई वर्गहरू उत्तम विचार होइन, र यो जिम्मेवारी भण्डार कक्षाहरूमा सार्नु तार्किक देखिन्छ। यस्तै हो र ? मैले विशेष रूपमा यो इन्टरफेसलाई दुई भागमा विभाजन गरेको छु। विधिहरूको पहिलो भाग लेखन कार्यहरूमा प्रयोग गरिनेछ।

मानक लेखन कार्य हो:

• नयाँ वस्तु र चुनौती को निर्माण PostRepository ::बचत गर्नुहोस्
• PostRepository::getById, संस्था हेरफेर र आह्वान PostRepository ::बचत गर्नुहोस्
• एउटा चुनौती PostRepository::delete

लेखन कार्यहरूले ल्याउने विधिहरू प्रयोग गर्दैन। पढ्ने कार्यहरूमा, केवल get* विधिहरू प्रयोग गरिन्छ। बारे पढ्नुभयो भने इन्टरफेस विभाजन सिद्धान्त (चिठी I в SOLID), त्यसपछि यो स्पष्ट हुनेछ कि हाम्रो इन्टरफेस धेरै ठूलो छ र कम्तिमा दुई फरक जिम्मेवारीहरू प्रदर्शन गर्दछ। यसलाई दुई भागमा विभाजन गर्ने समय हो। विधि getById दुबैमा आवश्यक छ, तर अनुप्रयोग थप जटिल हुँदै जाँदा, यसको कार्यान्वयन फरक हुनेछ। हामी यो केहि पछि हेर्नेछौं। मैले अघिल्लो लेखमा लेख्ने भागको बेकारको बारेमा लेखेको थिएँ, त्यसैले यस लेखमा म यसलाई बिर्सन्छु।

पढिएको भाग मलाई त्यति बेकार छैन जस्तो लाग्छ, किनकि Eloquent को लागि पनि यहाँ धेरै कार्यान्वयन हुन सक्छ। कक्षालाई के नाम दिने ? सक्छ ReadPostRepository, तर टेम्प्लेटमा भण्डार उहाँसँग पहिले नै कम प्रासंगिकता छ। तपाईं मात्र सक्नुहुन्छ पोस्टक्वेरीहरू:

<?php
interface PostQueries
{
    public function getById($id): Post;
    public function getLastPosts();
    public function getTopPosts();
    public function getUserPosts($userId);
}

Eloquent को साथ लागू गर्नु एकदम सरल छ:

<?php
final class EloquentPostQueries implements PostQueries
{
    public function getById($id): Post
    {
        return Post::findOrFail($id);
    }

    /**
    * @return Post[] | Collection
    */
    public function getLastPosts()
    {
        return Post::orderBy('created_at', 'desc')
            ->limit(/*some limit*/)
            ->get();
    }
    /**
    * @return Post[] | Collection
    */
    public function getTopPosts()
    {
        return Post::orderBy('rating', 'desc')
            ->limit(/*some limit*/)
            ->get();
    }

    /**
    * @param int $userId
    * @return Post[] | Collection
    */
    public function getUserPosts($userId)
    {
        return Post::whereUserId($userId)
            ->orderBy('created_at', 'desc')
            ->get();
    }
}

इन्टरफेस कार्यान्वयन संग सम्बन्धित हुनुपर्छ, उदाहरण को लागी मा AppServiceProvider:

<?php
final class AppServiceProvider extends ServiceProvider 
{
    public function register()
    {
        $this->app->bind(PostQueries::class, 
            EloquentPostQueries::class);
    }
}

यो कक्षा पहिले नै उपयोगी छ। उसले नियन्त्रक वा संस्था वर्गलाई राहत दिएर आफ्नो जिम्मेवारी महसुस गर्छ। नियन्त्रकमा यसलाई यसरी प्रयोग गर्न सकिन्छ:

<?php
final class PostsController extends Controller
{
    public function lastPosts(PostQueries $postQueries)
    {
        return view('posts.last', [
            'posts' => $postQueries->getLastPosts(),
        ]);
    }
} 

विधि पोष्टकन्ट्रोलर::अन्तिम पोष्टहरू केही कार्यान्वयनको माग मात्रै हो पोष्ट प्रश्नहरू र यसको साथ काम गर्दछ। प्रदायकमा हामीले लिङ्क गरेका छौं पोस्टक्वेरीहरू कक्षा संग EloquentPostQuerys र यो वर्ग नियन्त्रक मा प्रतिस्थापन गरिनेछ।

हाम्रो आवेदन धेरै लोकप्रिय भएको छ कि कल्पना गरौं। प्रति मिनेट हजारौं प्रयोगकर्ताहरूले नवीनतम प्रकाशनहरूको साथ पृष्ठ खोल्छन्। सबैभन्दा लोकप्रिय प्रकाशनहरू पनि धेरै पटक पढिन्छ। डाटाबेसहरूले त्यस्ता भारहरू राम्रोसँग ह्यान्डल गर्दैनन्, त्यसैले तिनीहरूले मानक समाधान प्रयोग गर्छन् - क्यास। डाटाबेस को अतिरिक्त, एक निश्चित डाटा स्न्यापसट केहि अपरेशनहरु को लागी अनुकूलित भण्डारण मा भण्डारण गरिएको छ - memcached वा रेडिस.

क्यासिङ तर्क सामान्यतया त्यति जटिल हुँदैन, तर EloquentPostQueries मा यसलाई लागू गर्नु धेरै सही छैन (यदि मात्र किनभने एकल जिम्मेदारी सिद्धान्त)। टेम्प्लेट प्रयोग गर्नु धेरै स्वाभाविक हो डेकोरेटर र मुख्य कार्यको लागि सजावटको रूपमा क्यासिङ लागू गर्नुहोस्:

<?php
use IlluminateContractsCacheRepository;

final class CachedPostQueries implements PostQueries
{
    const LASTS_DURATION = 10;

    /** @var PostQueries */
    private $base;

    /** @var Repository */
    private $cache;

    public function __construct(
        PostQueries $base, Repository $cache) 
    {
        $this->base = $base;
        $this->cache = $cache;
    }

    /**
    * @return Post[] | Collection
    */
    public function getLastPosts()
    {
        return $this->cache->remember('last_posts', 
            self::LASTS_DURATION, 
            function(){
                return $this->base->getLastPosts();
            });
    }

    // другие методы практически такие же
}

इन्टरफेस बेवास्ता गर्नुहोस् भण्डार कन्स्ट्रक्टर मा। केही अज्ञात कारणको लागि, तिनीहरूले यस तरिकाले Laravel मा क्यासिङको लागि इन्टरफेस नाम गर्ने निर्णय गरे।

Класс CachedPostQuerys क्यासिङ मात्र लागू गर्दछ। $this->cache-> सम्झनुहोस् यो प्रविष्टि क्यासमा छ कि छैन भनेर जाँच गर्दछ र यदि होइन भने, त्यसपछि कलब्याकलाई कल गर्छ र क्यासमा फर्काइएको मान लेख्छ। बाँकी सबै यो वर्गलाई अनुप्रयोगमा लागू गर्न हो। हामीलाई इन्टरफेसको कार्यान्वयन अनुरोध गर्न अनुप्रयोगमा सबै कक्षाहरू चाहिन्छ पोस्टक्वेरीहरू कक्षाको उदाहरण प्राप्त गर्न थाले CachedPostQuerys। तर, उनी स्व CachedPostQuerys कन्स्ट्रक्टरले प्यारामिटरको रूपमा क्लास प्राप्त गर्नुपर्छ EloquentPostQuerysकिनकि यो "वास्तविक" कार्यान्वयन बिना काम गर्न सक्दैन। हामी परिवर्तन गर्छौं AppServiceProvider:

<?php
final class AppServiceProvider extends ServiceProvider 
{
    public function register()
    {
        $this->app->bind(PostQueries::class, 
            CachedPostQueries::class);

        $this->app->when(CachedPostQueries::class)
            ->needs(PostQueries::class)
            ->give(EloquentPostQueries::class);
    }
}

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

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

तल्लो रेखा: हामीले एक होइन, तर दुई टेम्प्लेटहरू प्रयोग गर्यौं। नमूना कमाण्ड क्वेरी उत्तरदायित्व विभाजन (CQRS) इन्टरफेस स्तरमा पढ्न र लेख्ने कार्यहरू पूर्ण रूपमा अलग गर्न प्रस्ताव गर्दछ। म मार्फत उहाँकहाँ आएँ इन्टरफेस विभाजन सिद्धान्त, जसले सुझाव दिन्छ कि म कुशलतापूर्वक ढाँचा र सिद्धान्तहरू हेरफेर गर्छु र एउटा प्रमेयको रूपमा अर्कोबाट व्युत्पन्न गर्छु :) निस्सन्देह, प्रत्येक परियोजनालाई संस्थाहरू छनोट गर्नको लागि यस्तो अमूर्तता आवश्यक पर्दैन, तर म तपाइँसँग चाल साझा गर्नेछु। आवेदनको प्रारम्भिक चरणमा विकास, तपाईं केवल एक कक्षा सिर्जना गर्न सक्नुहुन्छ पोस्टक्वेरीहरू Eloquent मार्फत सामान्य कार्यान्वयनको साथ:

<?php
final class PostQueries
{
    public function getById($id): Post
    {
        return Post::findOrFail($id);
    }

    // другие методы
}

जब क्यासिङको आवश्यकता उत्पन्न हुन्छ, एक साधारण चालको साथ तपाईले यो कक्षाको सट्टामा इन्टरफेस (वा अमूर्त वर्ग) सिर्जना गर्न सक्नुहुन्छ। पोस्टक्वेरीहरू, कक्षामा यसको कार्यान्वयन प्रतिलिपि गर्नुहोस् EloquentPostQuerys र मैले पहिले वर्णन गरेको योजनामा ​​जानुहोस्। बाँकी अनुप्रयोग कोड परिवर्तन गर्न आवश्यक छैन।

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

स्रोत: www.habr.com