Download the PHP package fukibay/laravel-starter-pack without Composer
On this page you can find all versions of the php package fukibay/laravel-starter-pack. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download fukibay/laravel-starter-pack
More information about fukibay/laravel-starter-pack
Files in fukibay/laravel-starter-pack
Package laravel-starter-pack
Short Description Starter pack: minimal scaffolding helpers for new Laravel projects.
License MIT
Informations about the package laravel-starter-pack
Fukibay Laravel Starter Pack
Fukibay Laravel Starter Pack, Repository ve Service katmanlarını kullanarak temiz mimariyle proje geliştirenler için tasarlanmış, akıllı bir kod üretim (scaffolding) ve altyapı kurulum paketidir. Tekrarlayan kurulum ve kodlama adımlarını tek bir interaktif komutla otomatize ederek, doğrudan projenizin iş mantığına odaklanmanızı sağlar.
🎯 Felsefemiz
Bu paket, "örtük" varsayımlar yerine açık ve net komutları tercih eder. Amacımız, geliştirme sürecinizi hızlandırırken, kodun kontrolünün daima sizde kalmasını sağlamaktır. Ürettiğimiz kodun ve kurduğumuz altyapının güvenilir, esnek ve öngörülebilir olmasını garanti ederiz.
🚀 Temel Özellikler
- 🧠 Akıllı Kurulum Sihirbazı: Tek bir komutla (
fukibay:install) tüm temel altyapıyı kurun. Sihirbaz, size interaktif olarak veritabanı sürücünüzü sorar ve yapılandırmanızı otomatik olarak yapar. - Akıllı Kod Üretimi:
makekomutları ile saniyeler içinde, projenizin yapısına tam uyumlu Repository ve Service sınıfları oluşturun. - 🤖 Otomatik Soft Deletes Entegrasyonu:
- Repository oluştururken modelinizdeki
SoftDeletestrait'ini otomatik olarak algılar. - Service oluştururken, ilgili repository'nin soft-delete destekli olup olmadığını anlar ve gerekli
ProxiesSoftDeletestrait'ini sınıfa otomatik olarak ekler.
- Repository oluştururken modelinizdeki
- ⚡ Güçlü ve Esnek Sorgulama:
QueryParametersDTO'su sayesinde karmaşıkwhere,relation,orderBy,limit,scopeveexistsgibi sorguları zincirlemeden, tek bir nesne ile temiz bir şekilde yapın. - 🛠️ Kullanıma Hazır Yardımcılar: Kurulumla birlikte gelen
ApiResponder,HandlesFilesgibi trait'lerle API yanıtlarınızı ve dosya yönetimini anında standartlaştırın. - 🛡️ Otomatik API Hata Yönetimi: Kurulum,
ValidationExceptiongibi yaygın API hatalarını otomatik olarak yakalayıp standart bir JSON formatında döndüren birHandler.phpdosyası içerir. - Veritabanı Sürücü Desteği: Repository'lerinizi
PostgreSqlveMySqliçin özel alt klasörlerde oluşturarak projenizi düzenli tutar.
📦 Kurulum
Paketi projenize kurmak ve çalışır hale getirmek sadece iki adımdır.
Adım 1: Composer ile Paketi Yükleyin
Adım 2: Akıllı Kurulum Sihirbazını Çalıştırın
Bu komut, size hangi veritabanı sürücüsünü kullandığınızı soracak ve ardından gerekli tüm yapılandırma ve temel dosyaları projenize otomatik olarak kuracaktır.
🛠️ Kullanım Akışı
Adım 1: Repository Oluşturma
Bir Eloquent Modeli'ne bağlı yeni bir repository ve arayüzü oluşturmak için fukibay:make:repository komutunu kullanın.
Bu komut iki dosya oluşturur:
- Arayüz:
app/Repositories/Contracts/UserRepositoryInterface.php - Sınıf:
app/Repositories/PostgreSql/UserRepository.php(yapılandırmanıza göre)
Neden
--modelparametresi zorunlu? Model adını repository adından tahmin etmek (UserRepository->User) basit durumlarda işe yarasa da, karmaşık isimlendirmelerde ve farklı namespace yapılarında hatalara yol açabilir.--modelparametresini zorunlu kılarak, hangi modelin kullanılacağını açıkça belirtmenizi sağlıyor ve böylece %100 güvenilir ve hatasız kod üretiyoruz. Bu, paketin temel felsefesidir.
Soft Deletes Algılaması:
Eğer User modeliniz Illuminate\Database\Eloquent\SoftDeletes trait'ini kullanıyorsa, oluşturulan UserRepository sınıfı ve arayüzü bunu otomatik olarak algılayıp SoftDeletesRepositoryInterface'i ve ilgili trait'i uygulayacaktır.
Adım 2: Service Oluşturma (Akıllı Kısım)
İlgili repository'yi kullanan bir servis sınıfı oluşturun.
Paketin zekası burada devreye giriyor:
- Komut,
UserServiceiçinUserRepositoryInterface'in gerektiğini anlar. - Daha sonra bu arayüzün
SoftDeletesRepositoryInterface'i genişletip genişletmediğini kontrol eder. - Eğer cevap evet ise,
ProxiesSoftDeletestrait'ini servis sınıfına otomatik olarak ekler!
Örnek Çıktı (Eğer User modeli SoftDeletes kullanıyorsa):
Bu sayede, soft-delete metotlarını kullanmak için herhangi bir ek işlem yapmanıza gerek kalmaz.
Adım 3: Service Provider ile Bağlama
Oluşturduğunuz arayüzleri ve sınıfları Laravel'in Service Container'ına tanıtın.
Adım 4: Gelişmiş Sorgular (QueryParameters)
Paketin en güçlü yanlarından biri, QueryParameters DTO'su ile karmaşık ve okunabilir sorgular yapabilmektir.
Örnek Senaryo: Onaylanmış (status=approved), puanı 80'den yüksek (score > 80), profili (profile ilişkisi) olan ve en yeniye göre sıralanmış kullanıcıları getirelim.
Desteklenen Filtre Operatörleri:
=, !=, >, >=, <, <=, like, date, in, between, null, not_null, exists (ilişki var mı?), not_exists (ilişki yok mu?). Ayrıca dot notasyonu ile ilişkisel alanlarda da filtreleme yapabilirsiniz (profile.city => 'Ankara').
Adım 5: Kurulumla Gelen Yardımcıları Kullanma
fukibay:install komutu, işinizi kolaylaştıracak bazı trait'leri projenize kurar.
ApiResponder Trait'i
API yanıtlarınızı app/Traits/ApiResponder.php içindeki bu trait ile standartlaştırın.
HandlesFiles Trait'i
Dosya yükleme, silme ve güncelleme işlemlerini app/Traits/HandlesFiles.php içindeki bu trait ile kolayca yapın.
🎯 Komutların Özeti
| Komut | Açıklama |
|---|---|
fukibay:ping |
Paketin doğru kurulup kurulmadığını test eder. |
fukibay:install |
Gerekli temel arayüz, trait ve sınıfları interaktif sihirbaz ile app dizinine kurar. |
fukibay:make:repository <Ad> --model=<Model> |
Yeni bir repository sınıfı ve arayüzü oluşturur. |
fukibay:make:service <Ad> |
Yeni bir servis sınıfı oluşturur ve ilgili repository'yi akıllıca enjekte eder. |
Bu paket, Furkan Can Bayrak tarafından geliştirilmiştir. Katkıda bulunmak isterseniz, lütfen GitHub reposu üzerinden pull request gönderin.
All versions of laravel-starter-pack with dependencies
illuminate/support Version ^10.0 || ^11.0
illuminate/database Version ^10.0 || ^11.0
illuminate/pagination Version ^10.0 || ^11.0
illuminate/console Version ^10.0 || ^11.0
illuminate/filesystem Version ^10.0 || ^11.0