PHPackages                             siberfx/turkiye-address - 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. [Database &amp; ORM](/categories/database)
4. /
5. siberfx/turkiye-address

ActiveLibrary[Database &amp; ORM](/categories/database)

siberfx/turkiye-address
=======================

Laravel package for seeding Turkish address (city, district, neighborhood) tables from SQL dumps.

1.3.0(1mo ago)2959MITPHPPHP ^8.3|^8.4CI failing

Since Jul 14Pushed 1mo agoCompare

[ Source](https://github.com/siberfx/turkiye-il-ilce-mahalle)[ Packagist](https://packagist.org/packages/siberfx/turkiye-address)[ RSS](/packages/siberfx-turkiye-address/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (7)Versions (6)Used By (0)

Türkiye Adresler Laravel Paketi
===============================

[](#türkiye-adresler-laravel-paketi)

Bu paket, Türkiye'nin şehir, ilçe ve mahalle verilerini Laravel projelerine kolayca entegre etmenizi sağlar. SQL dump dosyaları, dinamik tablo isimleri, seeder, migration ve Eloquent modelleri ile birlikte gelir.

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

[](#özellikler)

- Türkiye'nin tüm şehir, ilçe ve mahalle verileri
- Esnek yapılandırma seçenekleri
- Performans için optimize edilmiş veri yükleme
- Kolay entegrasyon için hazır migration dosyaları
- Seçici yayınlama özelliği ile ihtiyacınız olan dosyaları yükleyin
- Laravel 11.x ve üzeri sürümlerle uyumlu

Kurulum
-------

[](#kurulum)

1. **Paketi Composer ile yükleyin**:

```
composer require siberfx/turkiye-address
```

2. **Servis Sağlayıcısını Kaydedin** (Laravel 10 ve öncesi için gerekebilir):

```
'providers' => [
    Siberfx\TurkiyePackage\TurkiyeAdreslerServiceProvider::class,
],
```

Kullanım
--------

[](#kullanım)

### Tüm Varlıkları Yayınlama

[](#tüm-varlıkları-yayınlama)

Tüm yapılandırma, migration ve seeder dosyalarını tek komutla yayınlayın:

```
php artisan turkiye:publish
```

### Seçerek Yayınlama

[](#seçerek-yayınlama)

Sadece ihtiyacınız olan dosyaları seçerek yayınlayabilirsiniz:

```
# Sadece config dosyasını yayınla
php artisan turkiye:publish --config

# Sadece migration dosyalarını yayınla
php artisan turkiye:publish --migrations

# Sadece seeder ve SQL dosyalarını yayınla
php artisan turkiye:publish --seeders

# Mevcut dosyaların üzerine yaz
php artisan turkiye:publish --force
```

### Migration'ları Çalıştırma

[](#migrationları-çalıştırma)

Yayınlanan migration dosyalarını çalıştırın:

```
php artisan migrate
```

### Verileri Yükleme

[](#verileri-yükleme)

Seeder'ı `DatabaseSeeder.php` dosyanıza ekleyin:

```
$this->call(\Siberfx\TurkiyePackage\Database\Seeders\TurkiyeSeeder::class);
```

Ardından verileri yükleyin:

```
php artisan db:seed
```

Yapılandırma
------------

[](#yapılandırma)

`config/turkiye-package.php` dosyasından tablo isimlerini ve model sınıflarını özelleştirebilirsiniz:

```
return [
    'cities_table' => env('TURKIYE_CITIES_TABLE', 'cities'),
    'districts_table' => env('TURKIYE_DISTRICTS_TABLE', 'districts'),
    'neighborhoods_table' => env('TURKIYE_NEIGHBORHOODS_TABLE', 'neighborhoods'),
    'city_model' => 'Siberfx\\TurkiyePackage\\Models\\City',
    'district_model' => 'Siberfx\\TurkiyePackage\\Models\\District',
    'neighborhood_model' => 'Siberfx\\TurkiyePackage\\Models\\Neighborhood',
];
```

Modellerin Kullanımı
--------------------

[](#modellerin-kullanımı)

```
use Siberfx\TurkiyePackage\Models\City;
use Siberfx\TurkiyePackage\Models\District;
use Siberfx\TurkiyePackage\Models\Neighborhood;

// Tüm şehirleri getir
$iller = City::all();

// Belirli bir ile ait ilçeleri getir (city_id farklı tablo isimleri kullanılıyorsa değiştirilmnelidir )
$ilceler = District::where('city_id', 1)->get();

// Belirli bir ilçeye ait mahalleleri getir (district_id farklı tablo isimleri kullanılıyorsa değiştirilmnelidir )
$mahalleler = Neighborhood::where('district_id', 10)->get();
```

İlişkiler
---------

[](#i̇lişkiler)

Modeller arasında tanımlanmış ilişkileri kullanabilirsiniz:

```
// Bir şehrin tüm ilçeleri
$il = City::find(1);
$ilceler = $il->districts;

// Bir ilçenin tüm mahalleleri
$ilce = District::find(10);
$mahalleler = $ilce->neighborhoods;
```

Sürüm Geçmişi
-------------

[](#sürüm-geçmişi)

Detaylı değişiklikler için [CHANGELOG.md](CHANGELOG.md) dosyasına bakınız.

Katkıda Bulunma
---------------

[](#katkıda-bulunma)

Katkılarınızı bekliyoruz! Lütfen önce bir konu açarak yapmak istediğiniz değişikliği tartışın.

Lisans
------

[](#lisans)

Bu paket [MIT lisansı](LICENSE) altında lisanslanmıştır.

İletişim
--------

[](#i̇letişim)

SiberFX -

Proje Linki:

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance91

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

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

Every ~64 days

Total

5

Last Release

45d ago

PHP version history (2 changes)1.0.0PHP &gt;=8.2

1.3.0PHP ^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/319c5a3ca014236bc2d28e3e37825e1ec467b51455c020c6666d1f40f493c2e1?d=identicon)[siberfx](/maintainers/siberfx)

---

Top Contributors

[![siberfx](https://avatars.githubusercontent.com/u/10257240?v=4)](https://github.com/siberfx "siberfx (34 commits)")

---

Tags

addresscitiesneighborhoodresidenceturkiyelaraveladdresssqlcityseederturkeydistrictneighborhood

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/siberfx-turkiye-address/health.svg)

```
[![Health](https://phpackages.com/badges/siberfx-turkiye-address/health.svg)](https://phpackages.com/packages/siberfx-turkiye-address)
```

###  Alternatives

[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[mnabialek/laravel-sql-logger

Log SQL queries in Laravel/Lumen framework

158796.3k2](/packages/mnabialek-laravel-sql-logger)[epigra/trgeozones

Türkiye İl İlçe Semt Muhit Mahalle ve Posta Kodları Laravel Paketi. Adds Turkish Geographical Zones Support to your project including Cities, Districts and Countries in Turkish

8820.3k](/packages/epigra-trgeozones)[woenel/prpcmblmts

Philippines region, province, cities/municipalities and barangays Laravel migration and table seeder.

2818.3k](/packages/woenel-prpcmblmts)[nevadskiy/laravel-geonames

Populate your database using the GeoNames service.

2715.1k](/packages/nevadskiy-laravel-geonames)[matriphe/laraciproid

Indonesia city and province data migration and seeder for Laravel.

232.5k](/packages/matriphe-laraciproid)

PHPackages © 2026

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