README

Pacchetto Symfony per la gestione avanzata delle località, comuni, province e regioni d'Italia (e del mondo)!

🏁 Configurazione rapida

1. Installa il bundle via Composer:

composer require pasqualepellicani/geo-localita-bundle

1. Aggiungi il bundle al file config/bundles.php:

PasqualePellicani\GeoLocalitaBundle\GeoLocalitaBundle::class => ['all' => true],

1. Aggiungi questa configurazione al file config/packages/doctrine.yaml del tuo progetto Symfony:

doctrine:
    orm:
        mappings:
            GeoLocalitaBundle:
                is_bundle: false
                type: attribute # oppure "annotation" se usi ancora le annotation
                dir: '%kernel.project_dir%/vendor/pasqualepellicani/geo-localita-bundle/src/Entity'
                prefix: 'PasqualePellicani\GeoLocalitaBundle\Entity'
                alias: GeoLocalitaBundle

1. Mappare i servizi, nel config/services.yaml aggiungi:

services:
    PasqualePellicani\GeoLocalitaBundle\:
        resource: '../vendor/pasqualepellicani/geo-localita-bundle/src/*'
        exclude: '../vendor/pasqualepellicani/geo-localita-bundle/src/{Entity,Tests,Migrations,Kernel.php}'
        autowire: true
        autoconfigure: true

1. Generazione delle migration

Dopo aver configurato Doctrine come sopra, puoi generare la migration per creare le tabelle del bundle:

php bin/console doctrine:migrations:diff
php bin/console doctrine:migrations:migrate

✨ Funzionalità

• 📦 Import automatico di tutti i dati geografici italiani da DatabaseComuni.it (dati NON inclusi per motivi di licenza).
• 🌍 Supporto città estere via GeoNames.
• 🔗 Relazioni Nazione ↔ Regione ↔ Provincia ↔ Città ↔ CAP ↔ Coordinate
• 🚀 Command pronto per import sequenziale e rollback.
• 🧩 Compatibile con Api Platform: Entity già serializzabili come API REST.
• 🛠️ Riutilizzabile: installa questo pacchetto in qualsiasi progetto Symfony via Composer.

📂 Dati richiesti

📥 I dati geografici italiani (premium) NON sono inclusi!
Copia i file .xlsx o .csv che hai acquistato nella cartella /var/data/ secondo istruzioni.
Sono supportati anche i dati GeoNames per città estere.

🚦 Licenza

• Codice: MIT License.
• Dati: l’utente deve possedere regolare licenza DatabaseComuni.it.
  (Vedi www.databasecomuni.it per l’acquisto).

Importazione dei dati

Per informazioni dettagliate su come importare i file di DatabaseComuni.it nel database del tuo progetto, consulta la guida dedicata:

👉 Guida all’importazione dei dati

All’interno troverai istruzioni passo-passo su:

• Dove posizionare i file scaricati dal sito DatabaseComuni.it
• Come lanciare il comando di importazione Symfony
• Opzioni avanzate e troubleshooting