feature: add Laravel adapter

README.md

@@ -25,6 +25,29 @@ $mapIt = new MapIt(
 );
 ```
 
+### Laravel
+
+If you're using Laravel, this package provides a service provider that automatically registers the `MapIt` class and uses `.env` variables to configure the key and URL.
+
+```sh
+MAPIT_KEY=...
+MAPIT_URL=...
+```
+
+You can then request it from the container when you need to use it.
+
+```php
+use C6Digital\MapIt\MapIt;
+
+class MyController
+{
+    public function __invoke(MapIt $mapIt)
+    {
+        // ...
+    }
+}
+```
+
 ### Retrieving postcodes
 
 ```php

composer.json

@@ -45,6 +45,13 @@
             "phpstan/extension-installer": true
         }
     },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "C6Digital\\MapIt\\Laravel\\MapItServiceProvider"
+            ]
+        }
+    },
     "minimum-stability": "dev",
     "prefer-stable": true
 }

config/mapit.php

@@ -0,0 +1,8 @@
+<?php
+
+return [
+
+    'key' => env('MAPIT_KEY'),
+    'url' => env('MAPIT_URL', 'https://mapit.mysociety.org'),
+
+];

src/Laravel/MapItServiceProvider.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace C6Digital\MapIt\Laravel;
+
+use C6Digital\MapIt\MapIt;
+use Illuminate\Contracts\Foundation\Application;
+use Illuminate\Support\ServiceProvider;
+
+class MapItServiceProvider extends ServiceProvider
+{
+    public function register()
+    {
+        $this->mergeConfigFrom(
+            __DIR__.'/../config/mapit.php',
+            'mapit'
+        );
+
+        $this->app->singleton(MapIt::class, static function (Application $app): MapIt {
+            return new MapIt(
+                key: $app['config']->get('mapit.key'),
+                url: $app['config']->get('mapit.url'),
+            );
+        });
+    }
+
+    public function boot()
+    {
+        $this->publishes([
+            __DIR__.'/../config/mapit.php' => config_path('mapit.php'),
+        ]);
+    }
+}