PHPackages                             flogti/spanish-cities - 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. flogti/spanish-cities

ActiveLibrary

flogti/spanish-cities
=====================

Add all spanish autonomous community, provinces and towns easily in Laravel.

v2.0.0(5y ago)42.1k↓33.3%1[2 issues](https://github.com/flogti/spanish-cities/issues)MITPHP

Since Feb 4Pushed 5y ago1 watchersCompare

[ Source](https://github.com/flogti/spanish-cities)[ Packagist](https://packagist.org/packages/flogti/spanish-cities)[ RSS](/packages/flogti-spanish-cities/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (5)Used By (0)

Laravel Spanish Cities
======================

[](#laravel-spanish-cities)

Ciudades de España para laravel.

Spanish Cities es un paquete que añade a tu proyecto laravel todas las comunidades autónomas, provncias y ciudades de España, todas ellas relacionadas y con sus capitales. Es muy fácil de usar y añadir la posibilidad de que cualquiera de tus modelos pertenezca a una ciudad de España

Instalación
-----------

[](#instalación)

Usar [Composer](https://getcomposer.org/) es la manera mas sencilla.

```
composer require flogti/spanish-cities
```

Uso
---

[](#uso)

Solo usa el siguiente comando y se ejecutaran las migraciones y los seeders necesarios.

```
php artisan spanish-cities:install
```

Para poder asignar ciudades a un modelo utiliza, añade a la tabla que necesites el campo **town\_id**. Así podrás usar los métodos disponibles.

Métodos
-------

[](#métodos)

Añade el trait **HasTown** a cualquier modelo. Por ejemplo en el modelo User sería así.

```
...
use Flogti\SpanishCities\Traits\HasTown;

class User extends Authenticatable
{
    use Notifiable, HasTown;
    ...
```

### Relación town

[](#relación-town)

Al usar el campo town\_id, incluye la relación con la tabla de ciudades y puedes acceder a la ciudad.

```
//Devuelve la ciudad a la que pertenece.
$town = $user->town;
```

### province()

[](#province)

```
//Devuelve la provincia a la cual pertenece su ciudad.
$province = $user->province();
```

### community()

[](#community)

```
//Devuelve la comunidad autónoma a la cual pertenece su ciudad.
$community = $user->community();
```

El modelo Town
--------------

[](#el-modelo-town)

Puedes obtener la provincia a la que pertenece.

```
$province = $town->province;
```

El modelo Province
------------------

[](#el-modelo-province)

Puedes obtener la comunidad a la que pertenece, su capital y las ciudades que pertenecen a esa provincia.

```
//Devuelve la comunidad a la cual pertenece la provincia.
$community = $province->community;

//Devuelve la capital de esa provincia.
$capital = $province->capital;

//Devuelve las ciudades que pertenecen a esa provincia.
$towns = $province->towns;
```

El modelo Community
-------------------

[](#el-modelo-community)

Puedes obtener su capital y las provincias y ciudades que pertenecen a esa provincia.

```
//Devuelve la capital de esa comunidad.
$capital = $community->capital;

//Devuelve las provincias que pertenecen a esa comunidad.
$provinces = $community->provinces;

//Devuelve las ciudades que pertenecen a esa comunidad.
$towns = $community->towns;
```

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity59

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 ~37 days

Total

4

Last Release

2177d ago

Major Versions

v1.1.0 → v2.0.02020-05-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/36d5dce8d32fe39898628741bc1636043c2cc5f02f9d747c748080e9d3895c90?d=identicon)[flogti](/maintainers/flogti)

---

Top Contributors

[![flogti](https://avatars.githubusercontent.com/u/60626677?v=4)](https://github.com/flogti "flogti (2 commits)")

### Embed Badge

![Health badge](/badges/flogti-spanish-cities/health.svg)

```
[![Health](https://phpackages.com/badges/flogti-spanish-cities/health.svg)](https://phpackages.com/packages/flogti-spanish-cities)
```

PHPackages © 2026

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