PHP Başlangıç Şablonu

kurulum/ adresini açın; dört adımda çalışan bir site ve panel elde edin.

Ekran Görüntüleri

Aşağıdaki kareler bu depodaki kodun kurulduktan sonraki hâlidir; hepsi
kurulum/ sihirbazı tamamlandıktan sonra, örnek veriyle çekilmiştir.

Kurulum sihirbazı

Şablonun ayırt edici yanı burada başlar: .env dosyasını elle yazmaz,
veritabanını elle açmazsınız. Sihirbaz önce sunucunuzu denetler, sonra
şemayı kurar ve .env dosyasını sizin için üretir.

1. adım — gereksinim denetimi
2. adım — veritabanı bağlantısı

Panel

Kullanıcılar — rol rozetleri, arama, toplu işlem
Mesajlar — iletişim formundan gelen kayıtlar

Site ayarları — form, ayar tanımından üretilir
Sistem bilgisi — güvenlik denetim listesi

Ön yüz, koyu tema ve mobil

Ön yüz
Koyu tema — tek CSS değişken seti
Mobil

Bu şablon nedir?

Her yeni PHP projesinde baştan yazdığınız teknik altyapıyı hazır sunar.
Belirli bir iş uygulaması değildir; ERP, CRM, CMS, blog, SaaS, REST
API ya da iç uygulama — hepsinin altına aynı sağlam temeli koyar.

Composer yok, framework yok, CDN yok. İndirin, kurulum/ adresini
açın, birkaç adımda çalışan bir site + panel elde edin.

Tek cümlelik felsefe

Core, uygulamanın ne iş yaptığını bilmez. Yalnızca **nasıl
çalıştığını** sağlar.

// YANLIŞ — çekirdek iş mantığını biliyor
UserService::register($data);
ErpPersonel::olustur($user);

// DOĞRU — çekirdek duyurur, modül dinler
Events::dispatch(new UserRegistered($user));

Neler hazır?

Kurulum

Gereksinimler

• PHP 8.1+ (pdo_mysql, mbstring, json; gd ve fileinfo önerilir)
• MySQL 5.7+ / MariaDB 10.3+
• Apache (mod_rewrite) ya da Nginx

Adımlar

git clone https://github.com/CilginYazilim/cy-php-starter

1. Klasörü sunucunuza koyun
2. Tarayıcıda http://siteniz/kurulum/ adresini açın
3. Sihirbazı tamamlayın
4. Son adımdaki düğmeyle kurulum/ klasörünü silin

Hepsi bu. Komut satırı gerekmez — sihirbaz .env dosyasını yazar,
tabloları kurar, migration'ları çalıştırır (önbellek, kuyruk, API
anahtarları) ve yönetici hesabınızı açar. Paylaşımlı hostingde de
eksiksiz kurulur.

Örnek veri: Son adımda "Örnek verileri de yükle" kutusu vardır.
Şablonu ilk kez deniyorsanız işaretleyin — listeleri ve filtreleri
dolu görürsünüz (demo parolası Demo1234!). Gerçek bir projeye
başlıyorsanız boş bırakın, veritabanınız tertemiz kalır.

mod_rewrite yoksa: .env içinde APP_PRETTY_URLS=false yapın.
Uygulama index.php?r=… biçimine döner, başka hiçbir şey değişmez.

Klasör yapısı

├── index.php               Web giriş noktası
├── cy                      Konsol giriş noktası (php cy …)
├── sw.js                   Servis çalışanı (PWA)
│
├── app/
│   ├── bootstrap.php       Web + CLI ortak önyükleme
│   ├── Core/               ÇEKİRDEK (iş mantığı içermez)
│   │   ├── Api/ Cache/ Console/ Database/ Events/ Exceptions/
│   │   ├── Log/ Mail/ Modules/ Queue/ Schedule/ Storage/
│   │   └── Auth Config Csrf Database Env ErrorHandler Flash
│   │       Middleware RateLimiter Request Response Router
│   │       Session Setting Uploader Url Validator View
│   ├── Events/ Listeners/ Jobs/
│   ├── Models/             Entity'ler (ORM DEĞİL) + Role
│   ├── Repositories/       SQL yalnızca burada
│   ├── Http/Controllers/   Panel · Api · Site
│   └── Support/helpers.php
│
├── config/                 app db session log cache queue api storage
│                           upload security validation events
├── routes/                 web.php · events.php · schedule.php
├── database/               migrations/ · seeders/
├── modules/                Eklenebilir modüller (Ornek/ = çalışan örnek)
├── views/                  layouts · partials · emails · errors · sayfalar
├── assets/                 css · js · images (CDN yok)
├── storage/                logs · cache · files · mail (web'e kapalı)
├── upload/                 Yüklenen görseller (PHP çalıştırma kapalı)
└── kurulum/                Sihirbaz + database.sql + demo.sql (sonra SİLİN)

İsteğin yolculuğu

Tarayıcı → .htaccess → index.php → bootstrap → Session/Güvenlik
   → Ayarlar → Modüller → Router → Middleware → Controller
   → Repository → View / JSON

Konsol

php cy                      # tüm komutlar
php cy yardim migrate       # ayrıntılı yardım

# Şema
php cy make:migration "urunlere aciklama ekle"
php cy migrate                     php cy migrate --pretend
php cy migrate:status              php cy migrate:rollback --step=3
php cy migrate:fresh --seed

# Üreteçler
php cy make:module Stok            # çalışır durumda CRUD modülü
php cy make:controller Urun --api
php cy make:model Urun --repository
php cy make:seeder Urun

# Modüller
php cy module                      php cy module --enable=Stok

# Bakım
php cy cache:clear --expired       php cy config:cache
php cy log:purge --list            php cy queue:work --max=30
php cy schedule:run --list         php cy mail:test [email protected]

* * * * * cd /yol/site && php cy schedule:run >> /dev/null 2>&1

Modül eklemek

php cy make:module Stok
php cy module --enable=Stok
php cy migrate

Kapalı modül hiç yüklenmez — rotaları tanımlanmaz, sınıfları
yüklenmez, olayları dinlenmez.

Sık kullanılanlar

// Adres ve varlık (hepsi köke göreli)
url('panel/ayarlar');            asset('css/site.css');

// Ayarlar
config('db.host');               // config/ dosyaları (geliştirici)
setting('site_adi');             // ayarlar tablosu (yönetici, panelden)

// Yetki
can('users.delete');

// Marka rengi (Ayarlar → Sistem → Tema Rengi)
Theme::brand();                  // '#7c3aed' — doğrulanmış
Theme::styleTag();               // düzenlere basılan <style> bloğu

// Günlük
Logger::info('…', ['id' => 3], 'auth');
Logger::security('Şüpheli istek', ['ip' => $ip]);

// Önbellek
Cache::remember('rapor', 900, fn () => $agirHesap());

// Olay
Events::dispatch(new UserRegistered($user));

// Kuyruk
Queue::push(new RaporUret(3));

// Dosya
Uploader::store($request->file('belge'), ['disk' => 'private', 'group' => 'belge']);

// API yanıtı
ApiResponse::paginated($items, $total, $page, $perPage);

Örnek kodlar ve belgeler

Şablonun her parçası için çalışan örnek kod, açıklamalı anlatım ve
kopyalanabilir parçacıklar Çılgın Yazılım Kod Kütüphanesi'nde:

Bu bağlantılar sitenin alt bilgisinde de sabit durur (Örnek Kodlar
sütunu); kurduğunuz projede gezinirken bir tık uzaktadır.

Mobil

Ön yüz ve panel ayrı ayrı mobil için tasarlanmıştır — masaüstü
düzeninin küçültülmüş hâli değildir.

Kırılma noktaları iki yüzde de aynıdır: 992px (tablet) ve 768px
(telefon); 360px altı için ayrıca sadeleştirme vardır.

Güvenlik

Panel → Sistem Bilgisi sayfası bunların canlı denetimini yapar ve
her sorunun nasıl çözüleceğini yazar.

Canlıya çıkış

# .env
APP_ENV=production
APP_DEBUG=false
LOG_LEVEL=info

php cy config:cache && php cy migrate

• [ ] kurulum/ klasörü silindi
• [ ] HTTPS aktif
• [ ] storage/ ve upload/ yazılabilir
• [ ] php cy mail:test başarılı
• [ ] Cron kuruldu
• [ ] Sistem Bilgisi sayfasındaki tüm denetimler yeşil

Nginx kullanıyorsanız

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ ^/(app|config|storage|views|database|modules|kurulum)/ { deny all; }
location ~ /\.env  { deny all; }
location ~ ^/cy$   { deny all; }

location ~* ^/upload/.*\.php$ { deny all; }

Yeni projeye başlarken

git clone https://github.com/CilginYazilim/cy-php-starter yeni-proje
cd yeni-proje && rm -rf .git

# kurulum/ adresini aç, sihirbazı tamamla
# ("Örnek verileri de yükle" kutusunu işaretlemeyin)

rm -rf modules/Ornek app/Jobs/OrnekIs.php

php cy make:module KendiModulun

Sürüm

Sürüm numarası kodda, tek yerde durur:

// config/app.php
'version' => '1.1.0',

1.1.0

Mobil

• Ön yüz menüsü yapışkan hâle geldi; hamburger açılır panel kendi içinde

kayıyor, simgesi açıkken çarpıya dönüyor

• Tema düğmesi hamburgerin dışına alındı — menüyü açmadan erişilebiliyor
• Ön yüzdeki düğme ve menü satırları 44–46px dokunma hedefine çıkarıldı
• Ön yüz form alanlarına 16px kuralı eklendi (iOS'un otomatik

yakınlaştırması artık düzeni bozmuyor); daha önce yalnızca panelde vardı

• Ana sayfadaki hero eylemleri telefonda tek sütuna iniyor
• İletişim sayfasında telefonda form önce, bilgi kartları sonra geliyor
• Alt bilgi sütunları telefonda alt alta diziliyor; sabit WhatsApp düğmesi

artık alt bilginin son satırını kapatmıyor

• Panelde özet kartların tek sütuna inme sınırı 400px'ten 360px'e çekildi —

eski sınır iPhone 12/13/14 (390px) ve SE (375px) dahil neredeyse her
telefonu kapsıyor, kontrol paneli gereksiz yere uzuyordu

Düzeltmeler

• site.css ile site-sections.css arasındaki çakışan kurallar

temizlendi. Bunlardan biri telefonda hero kartının logosunu tamamen
gizliyordu (.cy-hero__logo { display: none })

• Sürüm numarası tek kaynağa indirildi. Üç farklı yerde üç farklı değer

duruyordu: kurulum/database.sql "2.1.0", Sistem Bilgisi varsayılanı
"1.0.0", GitHub sürüm etiketi "v1.0.0"

Eklenenler

• Alt bilgide Örnek Kodlar sütunu: kod kütüphanesi, şablonun sayfası

ve depo bağlantısı

• icon() yardımcısına book ve code simgeleri

Güncelliyorsanız: php cy migrate çalıştırın. Tek migration var,
veritabanındaki ölü sistem_surum ayarını siler.