PHPackages                             hasirciogluhq/fframework - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. hasirciogluhq/fframework

ActiveLibrary[Framework](/categories/framework)

hasirciogluhq/fframework
========================

Lightweight PHP framework: HTTP routing, views, config, and PDO-friendly database helpers.

v1.0.0(2mo ago)01MITPHPPHP ^8.1

Since Apr 10Pushed 2mo agoCompare

[ Source](https://github.com/hasirciogluhq/FFramework)[ Packagist](https://packagist.org/packages/hasirciogluhq/fframework)[ RSS](/packages/hasirciogluhq-fframework/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (2)Versions (4)Used By (0)

[![FFramework — dark zinc, red accent](docs/assets/readme-banner.svg)](docs/assets/readme-banner.svg)
**FFramework** · hafif PHP çatısı · routing · views · genişletilebilir çekirdek

[![PHP](https://camo.githubusercontent.com/15e2b3600eac2dad73c9e02a323e978aeb1a0486887926f81e6a10187564748c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d4443323632363f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net/)[![Composer](https://camo.githubusercontent.com/59bcd54d0544fec9dccb17caecce51fe3365eea9a21029b93304d5634b1027ef/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f6d706f7365722d322e782d3237323732613f7374796c653d666c61742d737175617265266c6f676f3d636f6d706f736572266c6f676f436f6c6f723d7768697465)](composer.json)[![Packagist](https://camo.githubusercontent.com/b2822327780ff949445ec6e004e1c4cab03d321f5e0a7e2eaa4b97068dbfa626/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5061636b61676973742d686173697263696f676c756871253246666672616d65776f726b2d3138313831623f7374796c653d666c61742d737175617265266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/hasirciogluhq/fframework)[![License](https://camo.githubusercontent.com/8cc6ec24afbfeb04ff7b81a01d5b8987251a3b2952239aab56bf059a312f9e7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d3138313831623f7374796c653d666c61742d737175617265)](LICENSE)

---

Özet
----

[](#özet)

FFramework, web uygulamaları için **sade bir PHP iskeleti** sunar: yönlendirme, görünüm katmanı, yapılandırma ve veritabanı gibi parçalar tek bir çizgide tutulur. Amaç; gereksiz süslerden kaçınıp **okunabilir, hızlı** bir başlangıç noktası vermektir.

> Görsel dil: koyu zemin, **kırmızı vurgu**, katmanlı derinlik — depo kökündeki karşılama sayfası (`test-app`) ile aynı çizgi.

---

Özellikler
----------

[](#özellikler)

AlanAçıklama**Routing**Grup, parametre, `Request` ile uyumlu handler imzaları**Views**Derlenen şablonlar, `test-app/resources/views` altında örnek arayüz**HTTP**`Request` üzerinde sorgu, gövde ve route parametreleri**Veritabanı**PDO tabanlı `FFramework\Database\DB` (bkz. `src/database/DB.php`)**Test altyapısı**`phpunit/phpunit` (dev bağımlılık)---

Gereksinimler
-------------

[](#gereksinimler)

- PHP **8.1+**
- `ext-pdo` (Composer `require` içinde belirtilir)

---

Kurulum
-------

[](#kurulum)

### Mevcut projeye paket olarak (önerilen)

[](#mevcut-projeye-paket-olarak-önerilen)

[Packagist](https://packagist.org) üzerinde paket adı: **`hasirciogluhq/fframework`**. GitHub organizasyonu / repo adı farklıysa `composer.json` içindeki `name` alanını buna göre güncelle. Depoyu Packagist’e [Submit](https://packagist.org/packages/submit) ile ekledikten sonra:

```
composer require hasirciogluhq/fframework
```

Sonra kendi uygulamanızda `vendor/autoload.php` yükleyip `ROOT_PATH` (uygulama kökü), `routes/`, `resources/views`, `storage/cache/views` gibi dizinleri tanımlayın; örnek akış için aşağıdaki `test-app` giriş dosyasına bakın.

### Bu depoyu klonlayarak (geliştirme / örnek uygulama)

[](#bu-depoyu-klonlayarak-geliştirme--örnek-uygulama)

```
git clone https://github.com/hasirciogluhq/fframework.git
cd fframework
composer install
```

Örnek uygulama: `test-app/public/index.php` → `vendor` üst dizinde (`../vendor/autoload.php`).

Yerel sunucu:

```
cd test-app
php -S localhost:8000 -t public public/index.php
```

### Paket doğrulama

[](#paket-doğrulama)

```
composer validate --strict
```

---

Üretim hazırlığı (özet değerlendirme)
-------------------------------------

[](#üretim-hazırlığı-özet-değerlendirme)

KonuDurumNot**Çekirdek HTTP / routing**Kısmenİstek yaşam döngüsü çalışır; hata yanıtları JSON içinde dosya/satır dökebilir — prod’da `DEBUG=false` ve özel 500 handler şart.**Hata gösterimi**Dikkat`Kernel` prod’da `display_errors` kapalı; yine de yakalanan istisnaların içeriği log’a ayrı yazılmalı, kullanıcıya genel mesaj verilmeli.**Veritabanı (`DB`)**Riskli`configs_db_*` sabitleri tanımlı değilse sınıf yüklemesi hata verir; bağlantı hatasında `die()` kullanılıyor. Üretim için env tabanlı yapılandırma ve istisna yönetimi gerekir.**Oturum**Bilinçli seçimHer `Request` ile `session_start()` — API-only projelerde kapatılmalı veya lazy olmalı.**Güvenlik başlıkları / CSRF / rate limit**YokUygulama katmanında veya ters proxy (nginx) ile eklenmeli.**Yayınlama**StandartWeb kökü yalnızca `public/`; `storage` yazılabilir, kod kökü dışarı açılmamalı.**Sonuç:** Kütüphane / iskelet olarak **erken aşama**; üretim öncesi yukarıdaki maddeler netleştirilmeden “tam hazır” sayılmamalı.

---

Proje yapısı (özet)
-------------------

[](#proje-yapısı-özet)

```
src/              # FFramework\ — çekirdek paket
test-app/         # Örnek uygulama ve karşılama sayfası
docs/assets/      # README banner (SVG)

```

---

Dokümantasyon &amp; iletişim
----------------------------

[](#dokümantasyon--iletişim)

- **API / doküman:** yakında — şimdilik kaynak kod ve `test-app` örnekleri ana referans.
- **E-posta:**
- **Sosyal:** [Instagram](https://instagram.com/hasirciogluhq) · [Facebook](https://www.facebook.com/hasirciogluhq) · [Twitter/X](https://twitter.com/hasirciogluhq) · [Discord](https://discord.gg/y38CZgHMMq)

---

Yasal (örnek uygulama route’ları)
---------------------------------

[](#yasal-örnek-uygulama-routeları)

Örnek `test-app` içinde tanımlıysa: `/policy?page=privacy` · `/policy?page=use` · `/policy?page=cookie`

---

Katkı
-----

[](#katkı)

1. Depoyu fork’la
2. Dal aç (`feat/…` / `fix/…`)
3. Değişiklikleri gönder (pull request)

---

**FFramework™** · © benzeri tüm haklar saklıdır

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance88

Actively maintained with recent releases

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

61d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/48149766c33a023f6b1de25fbbda7759798011c69b5329c0e3fa81b68a52ca6f?d=identicon)[hasirciogli](/maintainers/hasirciogli)

---

Top Contributors

[![hasirciogluhq](https://avatars.githubusercontent.com/u/86384408?v=4)](https://github.com/hasirciogluhq "hasirciogluhq (44 commits)")

---

Tags

frameworkphpphp8php81php82phpframeworkhttpphpframeworkroutingmvcfframework

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hasirciogluhq-fframework/health.svg)

```
[![Health](https://phpackages.com/badges/hasirciogluhq-fframework/health.svg)](https://phpackages.com/packages/hasirciogluhq-fframework)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
