Contoh Penggunaan Contract di Laravel 12: Implementasi dan Binding
Kalau Anda sudah membaca artikel tentang apa itu Contract di Laravel 12, artikel ini melanjutkannya dengan contoh penggunaan nyata: bagaimana membuat implementasi Contract sendiri dan kapan ini berguna dalam proyek.
Menggunakan Contract Bawaan Laravel
Contract bawaan Laravel ada di namespace IlluminateContracts*. Contoh yang paling sering dipakai adalah type-hinting di constructor untuk decoupling:
<?php
namespace AppServices;
use IlluminateContractsCacheRepository as CacheContract;
use IlluminateContractsMailMailer as MailerContract;
class NotificationService
{
public function __construct(
private CacheContract $cache,
private MailerContract $mailer,
) {}
public function sendIfNotSent(string $userId, string $template): void
{
$cacheKey = "notification:{$userId}:{$template}";
if ($this->cache->has($cacheKey)) {
return; // Sudah dikirim
}
$this->mailer->send($template, [], fn ($m) => $m->to($userId));
$this->cache->put($cacheKey, true, now()->addDay());
}
}
Service ini bisa ditest dengan mudah — tinggal inject mock CacheContract dan MailerContract.
Membuat Contract Sendiri
Studi kasus: aplikasi yang butuh fitur kirim notifikasi ke berbagai channel (email, SMS, WhatsApp). Dengan Contract, kita bisa ganti implementasi tanpa mengubah kode yang memakainya.
Buat Contract interface di app/Contracts/NotificationChannel.php:
<?php
namespace AppContracts;
interface NotificationChannel
{
public function send(string $recipient, string $message): bool;
public function isAvailable(): bool;
}
Buat beberapa implementasi:
<?php
namespace AppServicesNotifications;
use AppContractsNotificationChannel;
use IlluminateSupportFacadesMail;
class EmailChannel implements NotificationChannel
{
public function send(string $recipient, string $message): bool
{
try {
Mail::raw($message, fn ($m) => $m->to($recipient));
return true;
} catch (Exception $e) {
return false;
}
}
public function isAvailable(): bool
{
return config('mail.default') !== null;
}
}
<?php
namespace AppServicesNotifications;
use AppContractsNotificationChannel;
class WhatsAppChannel implements NotificationChannel
{
public function __construct(
private WhatsAppApiClient $client
) {}
public function send(string $recipient, string $message): bool
{
return $this->client->sendMessage($recipient, $message);
}
public function isAvailable(): bool
{
return !empty(config('services.whatsapp.token'));
}
}
Bind Contract ke Implementasi di Service Provider
<?php
namespace AppProviders;
use AppContractsNotificationChannel;
use AppServicesNotificationsWhatsAppChannel;
use IlluminateSupportServiceProvider;
class AppServiceProvider extends ServiceProvider
{
public function register(): void
{
// Bind default implementation
$this->app->bind(NotificationChannel::class, WhatsAppChannel::class);
}
}
Sekarang di mana saja Anda type-hint NotificationChannel, Laravel otomatis inject WhatsAppChannel:
<?php
namespace AppHttpControllers;
use AppContractsNotificationChannel;
class AlertController extends Controller
{
public function __construct(
private NotificationChannel $channel
) {}
public function send(Request $request): Response
{
$sent = $this->channel->send(
$request->recipient,
$request->message
);
return response()->json(['success' => $sent]);
}
}
Manfaat: Mudah Ganti Implementasi
Kalau besok ingin switch dari WhatsApp ke SMS, cukup ganti binding di service provider:
$this->app->bind(NotificationChannel::class, SmsChannel::class);
Controller dan semua kode yang pakai NotificationChannel tidak perlu diubah sama sekali.
Contoh: Kontekstual Binding
Kalau perlu inject implementasi berbeda di class berbeda:
$this->app->when(AlertController::class)
->needs(NotificationChannel::class)
->give(WhatsAppChannel::class);
$this->app->when(ReportController::class)
->needs(NotificationChannel::class)
->give(EmailChannel::class);
Baca Juga
- Apa Itu Contract di Laravel 12 dan Bagaimana Cara Kerjanya
- Apa Itu Observer di Laravel 12 dan Kapan Menggunakannya
Mau tim yang bantu bangun arsitektur aplikasi Laravel yang scalable? Lihat layanan pengembangan aplikasi kami.
Baca Juga
Artikel Lainnya di Kategori Laravel
10 November 2025
Contoh Penggunaan Concurrency di Laravel 12: Dashboard, API Paralel, dan Defer
Artikel sebelumnya membahas konsep Concurrency di Laravel 12. Artikel ini fokus pada implementasi: studi kasus nyata bagaimana Concurrency bisa mempercepat aplikasi secara signifikan. Studi Kasus 1: Dashboard dengan Banyak Data Source Dashboard admin yang butuh data dari beberapa tabel berbeda. Ini biasanya jadi bottleneck karena diquery satu per satu. Sebelum (sequential — sekitar 800ms): public […]
Baca Artikel10 November 2025
Observer Adalah? Pengertian dan Cara Pakai Observer di Laravel 12
Kalau Event dan Listener cocok untuk “sesuatu terjadi di aplikasi, beri tahu komponen lain”, Observer punya fokus berbeda: “ketika Eloquent model berubah, jalankan kode ini.” Artikel ini menjelaskan apa itu Observer di Laravel 12, perbedaannya dengan Event Listener, dan kapan sebaiknya dipakai. Observer Adalah: Pengertian Singkat Secara bahasa, observer adalah pengamat, yaitu pihak yang memperhatikan […]
Baca Artikel9 November 2025
Migration Laravel: Cara Membuat, Menjalankan, dan Rollback di Laravel 12
Cara membuat migration Laravel dari nol: make:migration, migrate database, rollback, dan tips praktiknya.
Baca ArtikelIngin Membaca Artikel Lainnya?
Temukan lebih banyak insight dan tips tentang teknologi dan bisnis digital.
Lihat Semua Artikel