
ریپازیتوری یک استراتژی برای دسترسی به داده فراهم میکنه تا بتونیم عملیات مربوط به دیتابیس رو انجام بدیم. به زبان سادهتر؛ این الگو یک wrapper روی Model ایجاد میکنه و باعث میشه اصل Solid تا حد زیادی رعایت بشه.
در قسمتهای مختلف یک پروژه عملیاتهایی پرتکرار برای کار با دیتابیس وجود داره. این دیزاینپترن که در دستهٔ الگوهای ساختاری قرار میگیره، به ما کمک میکنه تا این کدها رو از لایهٔ سرویس جدا کنیم و به لایهٔ Data Access Layer انتقال بدیم. خیلی مزیت در این فرآیند هست که در ادامه بهش اشاره میکنیم.

مرحله اول ایجاد یک ساختار مشخص برای کدهای عمومی استفاده از دیتابیسه.
| -- app | -- Console | -- Exceptions | -- Http | -- Models | -- Providers | -- Repositories | -- Base | -- BaseRepository.php | -- BaseRepositoryInterface.php
در مسیر App لاراول یک دایرکتوری به نام Repositories می کنیم. همهٔ فایلهای مربوط به ریپازیتوری در این قسمت قرار میگیره. یک دایرکتوری دیگر بهنام Base داخل آن میسازیم. در نهایت دو فایل به نام BaseRepository.php و BaseRepositoryInterface.php ایجاد میکنیم.
در مرحله دوم کدهای زیر رو در این دو فایل مینویسیم.
BaseRepositoryInterface.php
<?php namespace App\Repositories\Base; interface BaseRepositoryInterface{ public function all(); public function get(array $condition); public function delete(int $id); public function save(array $data,int $id = null); public function saveMany(array $data); public function truncate(); }
متدهایی که نوشتیم میتونه بیشتر از این باشه که توضیح هر کدوم باعث میشه از بحث اصلی دور بشیم. این نکته قابل ذکر هست که متدهای این کلاس بر اساس نیازهای ما ایجاد میشه و ممکنه در پروژههای مختلف کم یا زیاد بشن. یا پیادهسازی این متدها کمی تغییر کنه. بههرحال این اینترفیس رو باید در فایل BaseRepository استفاده کنیم و اونها رو به شکل زیر پیاده کنیم.
BaseRepository.php
<?php namespace App\Repositories\Base; use Illuminate\Database\Eloquent\Model; class BaseRepository implements BaseRepositoryInterface{ public function __construct(Model $model) { $this->model = $model; } public function all() { return $this->model->all(); } public function get(array $condition) { return $this->model->where($condition[0],$condition[1],$condition[2])->get(); } public function delete(int $id) { return $this->model->findOrFail($id)->delete(); } public function save(array $data, int $id = null) { if($id){ return $this->model->find($id)->update($data); } return $this->model->create($data); } public function saveMany(array $data) { return $this->model->insert($data); } public function truncate() { return $this->model->truncate(); } }
با در نظرگرفتن اینکه متدهای نوشتهشده کدهای پرتکرار ما هستن، کار ما با این دو تا فایل تمومه.
مرحله سوم اینه که به ازای هر Entity در پروژه، ما یک دایرکتوری در مسیر app/Repositories ایجاد کنیم و یک فایل به نام Entity مورد نظرمون بسازیم. برای مثال ما قصد داریم Entity محصولات رو با ریپازیتوری پیاده کنیم. کافیه یک دایرکتوری در مسیر app/Repositories به نام Product ایجاد کنیم و فایلهای ProductRepository.php و ProductRepositoryInterface.php رو بسازیم و کدهای زیر رو داخلش بنویسیم. این کار رو برای تمام موجودیت هامون باید انجام بدیم.
ProductRepositoryInterface.php
<?php namespace App\Repositories\Product; use App\Repositories\Base\BaseRepositoryInterface; interface ProductRepositoryInterface extends BaseRepositoryInterface { }
ProductRepository.php
<?php namespace App\Repositories\Product; use App\Models\ProductModel; use App\Repositories\Base\BaseRepository; use Illuminate\Database\Eloquent\Model; class ProductRepository extends BaseRepository implements ProductRepositoryInterface{ public Model $model; public function __construct(ProductModel $model) { $this->model = $model; } }
اینجا یکم دقت بیشتری میطلبه. در فایل ProductRepositoryInterface ما فقط از اینترفیس Base ارث بری کردیم تا این ریپازیتوری رو مجبور کنیم که متدهای عمومی رو پیادهسازی کنه. سپس در فایل ProductRepository از اینترفیس جدیدی که ساختیم implement کردیم تا به متدهای عمومی که قبلا ایجاد کردهبودیم دسترسی داشته باشیم. اما ما کدهای عمومی رو قبلا ایجاد کردیم. پس نباید دوباره اون ها تعریف بشن (مگر در صورت نیاز). فقط کافیه از BaseRepository ارث بری کنیم تا به همهٔ متدهای نوشته شده دسترسی داشته باشیم.
حالا در دو صورت می تونیم متدهای دیگه ای به این ریپازیتوری اضافه کنیم. حالت اول اینه که ما یک کوئری دیگهای داریم که مختص این موجودیته. پس اون رو توی اینترفیس مینویسیم و در ریپازیتوری پیادهسازیش میکنیم. حالت دوم اینه که بخواهیم متدی رو تغییر بدیم. مثلا متد all که همهٔ رکوردها رو برمیگردوند، اینجا قراره به صورت صعودی براساس id برگردونه. می تونیم این متد رو اصطلاحا override کنیم (اصل open - closed).
مرحله چهارم و مرحله آخر اینه که از این ریپازیتوری ها در لایهٔ سرویس استفاده کنیم. فقط کافیه که در متد construct سرویس، یه آبجکت از ریپازیتوری مورد نظرمون بسازیم. مانند کد زیر:
ProductService.php
public ProductRepositoryInterface $productRepository; public function __construct() { $this->productRepository = App::make(ProductRepositoryInterface::class); }
کلیت کاری که انجام دادیم مشخصه. اما شاید براتون این سوال در مورد نحوه آبجکتساختن پیش بیاد. خب ما میتونستیم از این کد استفاده کنیم:
$this->productRepository = new ProductRepositoryInterface();
دلیل این کار Dependency Injection بود. ما هیچ پارامتری پاس ندادیم. البته تو این مثال فرقی نمیکنه، چون ریپازیتوری هیچوقت قرار نیست از ما ورودی بگیره. اینترفیسهای ما داخل construct خودشون فقط از یک Model یک شئ خالی میسازن. اما خواستم به این نکته اشاره کنم که سعی کنید آبجکتهاتون همیشه به این شکل ساخته بشن. این روش آبجکتسازی، هر پارامتری که لازم باشه رو به صورت بازگشتی میسازه و تزریق وابستگی رو خودش مدیریت میکنه.
حالا ما می تونیم توی متد مورد نظرمون از این ریپازیتوری استفاده کنیم.
... public function get(array $condition) { return $this->productRepository->get($condition); } ...
مقدار آرایه condition بهتره که از کنترلر بیاد. اما همینجا هم می تونیم یه condition مشخصی ایجاد کنیم و به ریپازیتوری پاس بدیم.
ProductController
<?php namespace App\Http\Controllers; use App\Services\Product\ProductService; class ProductController extends Controller { public function __construct() { $this->productService = App::make(ProductService::class); } public function get(Request $request) { $categoryId = $request->input("category-id"); return $this->productService->get(["category_id","=",$categoryId]); } ... }
دلیل استفاده از سرویس این بود که قسمت business پروژه نباید داخل کنترلر پیادهسازی بشه و کنترلر صرفا از طریق لایهٔ سرویس دادههای مورد نظرش رو میسازه و به فرانت پروژه ارسال میکنه.
خب کارهای لازم رو انجام دادیم، ولی اگه این متد رو از طریق یه route اجرا کنیم ارور زیر رو میگیریم:

متن ارور که مشخصه و برای رفع این ارور باید فایل های ریپازیتوری که ایجاد می کنیم رو اصطلاحا bind کنیم. برای این کار با دستور زیر یک Provider جدید می نویسیم که کارهای مربوط به bind کردن رو انجام بده.
php artisan make:provider RepositoryServiceProvider
بعد از این کار برای اینکه از این provider جدید استفاده کنیم باید فایل app.php که در دایرکتوری config قرار داره رو ویرایش کنیم و این provider رو معرفی کنیم:
'providers' => [ ... /* * Custom Service Providers... */ App\Providers\RepositoryServiceProvider::class, ...
در مرحله بعد فقط کافیه در متد register این provider که ساختیم کد زیر رو مینویسیم
$this->app->bind( ProductRepositoryInterface::class, ProductRepository::class, );
کارمون تموم شد. حالا ریپازیتوری های ما instantiable هستن و دیگه بدون مشکل کد ما کار خواهد کرد.
سعی کردم با زبان ساده این دیزاینپترن رو توضیح بدم. در کنارش کمی هم از اصول Solid و clean code صحبت کردم که هر کدوم نیاز به توضیح مفصل دارن. اگه این مطلب بهتون کمک کرد حتما کامنت بزارید و یا سوال خودتون رو بپرسید.
این قسمت از پست رو باز میزارم تا بعدا در مورد اتصال ریپازیتوری به سیستم caching و توضیحات بیشتر در مورد clean code و آموزش های مرتبط دیگه لینک بزارم.