first commit

Author: judgej

.gitignore

@@ -0,0 +1,7 @@
+.idea
+vendor
+composer.lock
+bin
+coverage
+coverage.xml
+composer.lock

LICENCE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 Jason Judge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,51 @@
+
+## Configuration in `config/filesystems.php`:
+
+```php
+[
+    ...
+    'disks' => [
+        ...
+        // Call this disk what you like.
+        'azure-file-storage' => [
+            // This driver.
+            'driver' => 'azure-file-storage',
+
+            // Account credentials.
+            'storageAccount' => env('AZURE_FLE_STORAGE_ACCOUNT'),
+            'storageAccessKey' => env('AZURE_FLE_STORAGE_ACCESS_KEY'),
+
+            // The file share.
+            // This driver supports one file share at a time (you cannot
+            // copy or move files between shares natively).
+            'fileShareName' => env('AZURE_FLE_STORAGE_HARE_NAME'),
+
+            // Optional settings
+            'disableRecursiveDelete' => false,
+            'driverOptions' => [],
+        ],
+    ]
+];
+```
+
+## Usage
+
+See [the Laravel documentation](https://laravel.com/docs/5.5/filesystem)
+for general usage of a file system in Laravel.
+A simple example follows:
+
+```
+use Storage;
+
+// List all files recursively from the root of the Azure share:
+
+$files = Storage::disk('azure-file-storage')->listAll();
+
+// Example:
+// array:25 [▼
+//   0 => "file1.txt"
+//   1 => "foo/file2.txt"
+//   2 => "foo/dee/dar/bigfile.txt"
+// ]
+```
+

composer.json

@@ -0,0 +1,46 @@
+{
+    "name": "academe/laravel-azure-file-storage-driver",
+    "description": "Azure File Storage filesystem driver for Laravel.",
+    "homepage": "https://github.com/academe",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Jason Judge",
+            "email": "jason@academe.co.uk"
+        }
+    ],
+    "support": {
+        "issues": "https://github.com/academe/laravel-azure-file-storage-driver/issues"
+    },
+    "keywords": [
+        "laravel",
+        "driver",
+        "azure",
+        "file storage"
+    ],
+    "autoload": {
+        "psr-4": {
+            "Academe\\Laravel\\AzureFileStorageDriver\\": "src"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Academe\\Laravel\\AzureFileStorageDriver\\Tests\\": "tests"
+        }
+    },
+    "require": {
+        "php": ">=7.0",
+        "consilience/flysystem-azure-file-storage": "dev-master"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "^6.0|^7.0",
+        "orchestra/testbench": "~3.3|~3.4|~3.5|~3.6"
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Academe\\Laravel\\AzureFileStorageDriver\\ServiceProvider"
+            ]
+        }
+    }
+}

src/ServiceProvider.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Academe\Laravel\AzureFileStorageDriver;
+
+use Storage;
+use League\Flysystem\Filesystem;
+
+use Consilience\Flysystem\Azure\AzureFileAdapter;
+use MicrosoftAzure\Storage\File\FileRestProxy;
+use Illuminate\Support\ServiceProvider as ServiceProviderContract;
+
+class ServiceProvider extends ServiceProviderContract
+{
+    /**
+     * Bootstrap the application services.
+     */
+    public function boot()
+    {
+        Storage::extend('azure-file-storage', function ($app, $config) {
+            $connectionString = sprintf(
+                'DefaultEndpointsProtocol=https;AccountName=%s;AccountKey=%s',
+                $config['storageAccount'],
+                $config['storageAccessKey']
+            );
+
+            $driverConfig = [
+                'endpoint' => $connectionString,
+                'container' => $config['fileShareName'],
+                'disableRecursiveDelete' => !empty($config['disableRecursiveDelete']),
+            ];
+
+            $fileService = FileRestProxy::createFileService(
+                $connectionString,
+                [] // $optionsWithMiddlewares
+            );
+
+            $driverOptions = !empty($config['driverOptions'])
+                ? $config['driverOptions']
+                : null;
+
+            return new Filesystem(
+                new AzureFileAdapter(
+                    $fileService,
+                    $driverConfig,
+                    $driverOptions
+                )
+            );
+        });
+    }
+
+    /**
+     * Register the application services.
+     */
+    public function register()
+    {
+        //
+    }
+}