1. Go to this page and download the library: Download alrez/iran-states library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
alrez / iran-states example snippets
use Alrez\IranStates\Models\City;
$city = City::find(1);
// استفاده از trait methods
$state = $city->getStateById($city->state_id);
$citiesInSameState = $city->getCitiesByState($city->state_id);
$belongsToTehran = $city->belongsToState(8); // تهران
use Alrez\IranStates\Traits\InteractWithState;
class User extends Model
{
use InteractWithState;
// حالا میتوانید از متدهای trait استفاده کنید
}
$user = new User();
$userState = $user->getStateById($user->state_id);
$citiesInUserState = $user->getCitiesByState($user->state_id);
use Alrez\IranStates\Traits\InteractWithStates;
class Organization extends Model
{
use InteractWithStates;
// حالا میتوانید از متدهای trait استفاده کنید
}
$org = new Organization();
$allStates = $org->getAllStates();
$statesWithCities = $org->getAllStatesWithCities();
$searchedStates = $org->searchStates('خراسان');
use Alrez\IranStates\Services\CityStateService;
$service = new CityStateService();
// دریافت همه استانها (از cache)
$allStates = $service->getAllStates();
// دریافت استانها با شهرها (برای dropdown ها)
$statesWithCities = $service->getAllStatesWithCities();
// دریافت یک استان خاص
$state = $service->getStateById(8);
// دریافت یک استان با شهرهایش
$stateWithCities = $service->getStateWithCitiesById(8);
// دریافت شهرهای یک استان
$cities = $service->getCitiesByStateId(8);
// دریافت یک شهر خاص
$city = $service->getCityById(1);
// جستجو در شهرها
$searchedCities = $service->searchCities('تهران');
// جستجو در استانها
$searchedStates = $service->searchStates('خراسان');
// عملیات batch برای چندین استان
$multipleStates = $service->getStatesByIds([1, 2, 3]);
$citiesFromMultipleStates = $service->getCitiesByStateIds([1, 2, 3]);
// آمار
$statesCount = $service->getStatesCount();
$citiesCount = $service->getCitiesCount();
// پاک کردن cache
$service->clearCache();
use Alrez\IranStates\Traits\ValidationRules;
class YourController
{
use ValidationRules;
public function validateState($request)
{
$rules = $this->getStateRules();
// اعتبارسنجی...
}
public function validateCity($request)
{
$rules = $this->getCityRules();
// اعتبارسنجی...
}
}
use Alrez\IranStates\Models\City;
$city = City::find(1);
// Using trait methods
$state = $city->getStateById($city->state_id);
$citiesInSameState = $city->getCitiesByState($city->state_id);
$belongsToTehran = $city->belongsToState(8); // Tehran
use Alrez\IranStates\Traits\InteractWithState;
class User extends Model
{
use InteractWithState;
// Now you can use trait methods
}
$user = new User();
$userState = $user->getStateById($user->state_id);
$citiesInUserState = $user->getCitiesByState($user->state_id);
use Alrez\IranStates\Traits\InteractWithStates;
class Organization extends Model
{
use InteractWithStates;
// Now you can use trait methods
}
$org = new Organization();
$allStates = $org->getAllStates();
$statesWithCities = $org->getAllStatesWithCities();
$searchedStates = $org->searchStates('Khorasan');
use Alrez\IranStates\Services\CityStateService;
$service = new CityStateService();
// Get all states (cached)
$allStates = $service->getAllStates();
// Get states with cities (for dropdowns)
$statesWithCities = $service->getAllStatesWithCities();
// Get specific state
$state = $service->getStateById(8);
// Get state with its cities
$stateWithCities = $service->getStateWithCitiesById(8);
// Get cities of a state
$cities = $service->getCitiesByStateId(8);
// Get specific city
$city = $service->getCityById(1);
// Search cities
$searchedCities = $service->searchCities('Tehran');
// Search states
$searchedStates = $service->searchStates('Khorasan');
// Batch operations for multiple states
$multipleStates = $service->getStatesByIds([1, 2, 3]);
$citiesFromMultipleStates = $service->getCitiesByStateIds([1, 2, 3]);
// Statistics
$statesCount = $service->getStatesCount();
$citiesCount = $service->getCitiesCount();
// Clear cache
$service->clearCache();
use Alrez\IranStates\Traits\ValidationRules;
class YourController
{
use ValidationRules;
public function validateState($request)
{
$rules = $this->getStateRules();
// Validation...
}
public function validateCity($request)
{
$rules = $this->getCityRules();
// Validation...
}
}
bash
php artisan iranStates:install
bash
php artisan vendor:publish --tag=iran-states
bash
php artisan iranStates:install
bash
php artisan vendor:publish --tag=iran-states
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.