Download the PHP package cubes-doo/srbija-naselja without Composer
On this page you can find all versions of the php package cubes-doo/srbija-naselja. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cubes-doo/srbija-naselja
More information about cubes-doo/srbija-naselja
Files in cubes-doo/srbija-naselja
Package srbija-naselja
Short Description Spisak naselja, opstina, postanskih brojeva i okruga u Republici Srbiji
License
Informations about the package srbija-naselja
Cubes DOO / Srbija Naselja
Ovaj paket pruža osnovnu bazu naselja u Srbiji.
Baza naselja je napravlena na osnovu Wiki stranica sa spiskovima poštanskih brojeva: Списак насељених места у Србији Spisak poštanskih brojeva u Srbiji
Dokumentacija
Instalacija
Instalacija paketa se vrši uobičajno košišćenjem composer-a
Integracija sa Laravel 5 framework-om
Paket dolazi sa "ServiceProvider"-om i "Facade"-om za Laravel 5 framework.
Ukoliko koristite Laravel verzije manje od 5.5 morate da ukljucite service provider direktno u config/app.php
Primeri koriscenja
Celokupno koriscenje paketa se koristi pomicu klase CubesDoo\SrbijaNaselja\SrbijaNaseljaService
Ili ako koristite Laravel, pomocu fasade
Odnosno preko Dependency Injection-a
Kada importujete SrbijaNaselja
servis mozete da koristite njegove metode:
SrbijaNaselja::naselja()
Dobija se lista naselja tj niz asocijativnih nizova u formatu:
SrbijaNaselja::naselje(11550)
Dobija se naselje na osnovu postanskog broja u formatu:
SrbijaNaselja::opstine()
Dobija se lista opstina tj niz asocijativnih nizova u formatu:
SrbijaNaselja::opstina(11550)
Dobija se opstina na osnovu postanskog broja u formatu:
SrbijaNaselja::okruzi()
Dobija se lista okruga tj niz string-ova:
SrbijaNaselja::okrug(11550)
Dobija se naziv okruga na osnovu postanskog broja:
Latinica
Po default-u se daju nazivi na cirilici, ukoliko zelte nazive na latinici, pre opisanih metoda pozovite metodu latinica
ili
U Laravel-u ukoliko je podesen jezik na 'sr', service provider ce ucitati 'latinicu'!
Doprinos paketu
Svako je dobrodošao da pomogne usavršavanju paketa.
Baza naselja Republike Srbije
Baza naselja je data u vise formata na latinici i ćirilici u fajlovima:
- data/naselja.sr_Cyrl_RS.php - PHP niz sa naseljima na Cirilici
- data/naselja.sr_Cyrl_RS.csv - CSV niz sa naseljima na Cirilici
- data/naselja.sr_RS.php - PHP niz sa naseljima na Latinici
- data/naselja.sr_RS.csv - CSV niz sa naseljima na Latinici
Fajlovi u CSV formatu se ne koriste već su ubačeni radi eventualnog importa ukoliko ima potrebe.
Sami nazivi i postanski brojevi nisu 100% provereni, neophodna je pomoc contributor-a.
Pokretanje testova
Napisani su PUPUnit testovi za sam servis i za bazu znaja u foldertu tests
.
Ukoliko menjate spomenute fajlove baze obavezno pokrenite testove!!!
Testovi se pokrecu pomocu komande