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);
}

এই পদ্ধতিগুলি ইলোকুয়েন্ট স্কোপের মাধ্যমে প্রয়োগ করা যেতে পারে, তবে নিজেদেরকে আনার দায়িত্ব নিয়ে সত্তা ক্লাসগুলিকে ওভারলোড করা সর্বোত্তম ধারণা নয় এবং এই দায়িত্বটিকে সংগ্রহস্থল ক্লাসে স্থানান্তরিত করা যৌক্তিক বলে মনে হয়। তাই নাকি? আমি বিশেষভাবে এই ইন্টারফেসটিকে দুটি অংশে বিভক্ত করেছি। পদ্ধতির প্রথম অংশ লেখার কাজে ব্যবহার করা হবে।

স্ট্যান্ডার্ড লেখার অপারেশন হল:

• একটি নতুন বস্তু এবং চ্যালেঞ্জ নির্মাণ পোস্ট রিপোজিটরি:: সংরক্ষণ করুন
• PostRepository::getById, সত্তা ম্যানিপুলেশন এবং তলব পোস্ট রিপোজিটরি:: সংরক্ষণ করুন
• চ্যালেঞ্জ PostRepository::delete

লেখার ক্রিয়াকলাপগুলি আনার পদ্ধতি ব্যবহার করে না। রিড অপারেশনে, শুধুমাত্র get* পদ্ধতি ব্যবহার করা হয়। সম্পর্কে পড়লে ইন্টারফেস বিভাজন নীতি (চিঠি I в কঠিন), তাহলে এটা পরিষ্কার হয়ে যাবে যে আমাদের ইন্টারফেস অনেক বড় এবং অন্তত দুটি ভিন্ন দায়িত্ব পালন করে। এটা দুই দ্বারা ভাগ করার সময়. পদ্ধতি getById উভয় ক্ষেত্রেই প্রয়োজনীয়, তবে অ্যাপ্লিকেশনটি আরও জটিল হওয়ার সাথে সাথে এর বাস্তবায়ন ভিন্ন হবে। আমরা একটু পরে এটি দেখতে হবে. আমি পূর্ববর্তী নিবন্ধে লেখার অংশটির অকেজোতা সম্পর্কে লিখেছিলাম, তাই এইটিতে আমি এটি সম্পর্কে ভুলে যাব।

পঠিত অংশটি আমার কাছে এতটা অকেজো বলে মনে হচ্ছে না, যেহেতু ইলোকুয়েন্টের জন্যও এখানে বেশ কয়েকটি বাস্তবায়ন থাকতে পারে। ক্লাসের নাম কি রাখব? করতে পারা 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();
    }
}

ইন্টারফেসটি অবশ্যই বাস্তবায়নের সাথে যুক্ত হতে হবে, উদাহরণস্বরূপ ইন অ্যাপসার্ভিস প্রোভাইডার:

<?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(),
        ]);
    }
} 

পদ্ধতি পোস্ট কন্ট্রোলার::লাস্টপোস্ট শুধু কিছু বাস্তবায়নের জন্য জিজ্ঞাসা পোস্ট কোয়েরি এবং এটির সাথে কাজ করে। প্রদানকারী আমরা লিঙ্ক পোস্ট কোয়েরি ক্লাস সহ বাগ্মী পোষ্ট প্রশ্নাবলী এবং এই শ্রেণীটি কন্ট্রোলারে প্রতিস্থাপিত হবে।

আসুন কল্পনা করি যে আমাদের অ্যাপ্লিকেশনটি খুব জনপ্রিয় হয়ে উঠেছে। প্রতি মিনিটে হাজার হাজার ব্যবহারকারী সর্বশেষ প্রকাশনা সহ পৃষ্ঠাটি খুলছেন। সর্বাধিক জনপ্রিয় প্রকাশনাগুলিও প্রায়শই পড়া হয়। ডাটাবেসগুলি এই ধরনের লোডগুলি খুব ভালভাবে পরিচালনা করে না, তাই তারা একটি আদর্শ সমাধান ব্যবহার করে - একটি ক্যাশে। ডাটাবেস ছাড়াও, নির্দিষ্ট ক্রিয়াকলাপের জন্য অপ্টিমাইজ করা স্টোরেজে একটি নির্দিষ্ট ডেটা স্ন্যাপশট সংরক্ষণ করা হয় - 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();
            });
    }

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

ইন্টারফেস উপেক্ষা করুন সংগ্রহস্থলের প্রয়োগ কনস্ট্রাক্টরের মধ্যে কিছু অজানা কারণে, তারা লারাভেলে ক্যাশে করার জন্য ইন্টারফেসের নামকরণ করার সিদ্ধান্ত নিয়েছে।

Класс ক্যাশেডপোস্ট কোয়েরি শুধুমাত্র ক্যাশিং প্রয়োগ করে। $this->cache->মনে রাখবেন এই এন্ট্রিটি ক্যাশে আছে কিনা তা পরীক্ষা করে এবং যদি না থাকে, তাহলে কলব্যাক কল করে এবং ক্যাশে ফেরত দেওয়া মানটি লিখে। যা অবশিষ্ট থাকে তা হল এই শ্রেণীটিকে অ্যাপ্লিকেশনটিতে বাস্তবায়ন করা। ইন্টারফেস বাস্তবায়নের অনুরোধ করার জন্য অ্যাপ্লিকেশনটিতে আমাদের সমস্ত ক্লাস দরকার পোস্ট কোয়েরি ক্লাসের একটি উদাহরণ পেতে শুরু করে ক্যাশেডপোস্ট কোয়েরি. তবে তিনি নিজেই ক্যাশেডপোস্ট কোয়েরি কনস্ট্রাক্টরকে অবশ্যই একটি প্যারামিটার হিসাবে একটি ক্লাস গ্রহণ করতে হবে বাগ্মী পোষ্ট প্রশ্নাবলীযেহেতু এটি একটি "বাস্তব" বাস্তবায়ন ছাড়া কাজ করতে পারে না। আমরা পরিবর্তিত হই অ্যাপসার্ভিস প্রোভাইডার:

<?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);
    }

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

যখন ক্যাশিংয়ের প্রয়োজন দেখা দেয়, তখন একটি সাধারণ পদক্ষেপের মাধ্যমে আপনি এই ক্লাসের জায়গায় একটি ইন্টারফেস (বা বিমূর্ত শ্রেণী) তৈরি করতে পারেন পোস্ট কোয়েরি, ক্লাসে এর বাস্তবায়ন কপি করুন বাগ্মী পোষ্ট প্রশ্নাবলী এবং আমি আগে বর্ণিত স্কিমে যান। বাকি অ্যাপ্লিকেশন কোড পরিবর্তন করার প্রয়োজন নেই.

ক্লাস, ইন্টারফেস সহ এই সমস্ত কৌশলগুলি, ইনজেকশন নির্ভরতা и সিকিউআরএস এ বিস্তারিত বর্ণনা করা হয়েছে আমার বই "জটিল ওয়েব অ্যাপ্লিকেশনের আর্কিটেকচার". এই প্রবন্ধের উদাহরণগুলিতে আমার সমস্ত ক্লাস কেন চূড়ান্ত হিসাবে চিহ্নিত করা হয়েছে সেই ধাঁধার সমাধানও রয়েছে৷

উত্স: www.habr.com