library assets {🖫 4,712, ⚐ 32, ★ 4}

nodes/assets

Package to make upload and generation of urls matching the files

Wednesday, September 6, 2017
by nodes
Repository
2 Watchers
4 Stars
4,712 Installations

PHP
1 Dependents
0 Suggesters
3 Forks
3 Open issues
32 Versions
12 % Grown

The README.md

Assets

A easy integration for handling files with Laravel., _(*1)

, _(*2)

📝 Introduction

One thing we at Nodes have been missing in Laravel is a fast easy file storage integration system., _(*3)

The Storage facade made it easier, but we still need the option to upload from differente formats and store to a very specific folder structure, retrieve a path and be able to create urls to serve api and sites., _(*4)

📦 Installation

To install this package you will need:, _(*5)

Laravel 5.1+
PHP 5.5.9+

You must then modify your composer.json file and run composer update to include the latest version of the package in your project., _(*6)

"require": {
    "nodes/assets": "^1.1"
}

Or you can run the composer require command from your terminal., _(*7)

composer require nodes/assets:^1.1

🔧 Setup

Setup service provider in config/app.php, _(*8)

Nodes\Assets\ServiceProvider::class

Setup alias in config/app.php, _(*9)

'Assets' => Nodes\Assets\Support\Facades\Assets::class

Publish config files, _(*10)

php artisan vendor:publish --provider="Nodes\Assets\ServiceProvider"

If you want to overwrite any existing config files use the --force parameter, _(*11)

php artisan vendor:publish --provider="Nodes\Assets\ServiceProvider" --force

S3 + ImgIX

In general.php config, _(*12)

'upload' => [
        'provider' => function () {
            $s3Config = config('filesystems.disks.s3');
            $awsS3Config = config('nodes.assets.provider.aws-s3');
            return new \Nodes\Assets\Upload\Providers\AmazonS3($awsS3Config, $s3Config);
        },
    ],   
    'url'    => [
        'provider' => function () {
            $imgIxConfig = config('nodes.assets.providers.imgix');

            return new \Nodes\Assets\Url\Providers\ImgIX($imgIxConfig);
        },
    ],

Make sure to have .env setup, _(*13)

```.dotenv AMAZON_BUCKET=bucket AMAZON_KEY=key AMAZON_SECRET=secret AMAZON_REGION=eu-west-1 CDN_BASE_URL=nodes-cdn-development.imgix.net, _(*14)


### Vapor Cloud

In general.php config

```php

<?php

return [

    'upload' => [
        'provider' => function () {
            $s3Config = config('filesystems.disks.s3');
            $vaporCloudConfig = config('nodes.assets.providers.vapor-cloud');

            return new \Nodes\Assets\Upload\Providers\VaporCloud($s3Config, $vaporCloudConfig);
        },
    ],

    'url'    => [
        'provider' => function () {
            $vaporCloudConfig = config('nodes.assets.providers.vapor-cloud');

            return new \Nodes\Assets\Url\Providers\VaporCloud($vaporCloudConfig);
        },
    ],
];

Make sure to have .env setup, _(*15)

AMAZON_BUCKET=bucket
AMAZON_KEY=key
AMAZON_SECRET=secret
AMAZON_REGION=eu-west-1
AMAZON_CLOUDFRONT_URL={insert imgix base url here locally}
AMAZON_CLOUDFRONT_URL_DATA={insert imgix base url here locally}

Public Folder

Public folder method can resize images. To setup, you need Intervention image lib. To install run, _(*16)

composer require intervention/image

Then add the following to app.php, _(*17)

providers array, _(*18)

Intervention\Image\ImageServiceProvider::class

aliases array, _(*19)

'Image' => Intervention\Image\Facades\Image::class

finally run, _(*20)

php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravel5"

Configure for public folder

Modify the configuration in config/nodes/assets/general.php, _(*21)

return [
    'upload' => [
        'provider' => function () {
            return new \Nodes\Assets\Upload\Providers\PublicFolder();
        },
    ],
    'url'    => [
        'provider' => function () {
            return new \Nodes\Assets\Url\Providers\PublicFolder();
        },
    ],
];

⚙ Usage

Global methods

function assets_add($file, $folder = null, UploadSettings $settings = null)

function assets_add_uploaded_file(UploadedFile $file, $folder = null, UploadSettings $settings = null)

function assets_add_url($url, $folder = null, UploadSettings $settings = null)

function assets_add_data_uri($dataUri, $folder = null, UploadSettings $settings = null)

function assets_get($path, UrlSettings $settings = null)

Facade methods

Assets::add($file, $folder = null, UploadSettings $settings = null)

Assets::addFromUploadedFile(UploadedFile $file, $folder = null, UploadSettings $settings = null)

Assets::addFromUrl($url, $folder = null, UploadSettings $settings = null)

Assets::addFromDataUri($dataUri, $folder = null, UploadSettings $settings = null)

Assets::get($path)

🏆 Credits

This package is developed and maintained by the PHP team at Nodes, _(*22)

, _(*23)

📄 License

This package is open-sourced software licensed under the MIT license, _(*24)

The Versions

06/09 2017

dev-master

9999999-dev

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

06/09 2017

1.1.15

1.1.15.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

30/08 2017

1.1.14

1.1.14.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

06/06 2017

1.1.13

1.1.13.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

16/02 2017

1.1.12

1.1.12.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

16/02 2017

1.1.11

1.1.11.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

16/02 2017

1.1.10

1.1.10.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

10/02 2017

1.1.9

1.1.9.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

10/02 2017

dev-develop

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

26/10 2016

1.1.8

1.1.8.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

14/10 2016

1.1.7

1.1.7.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

26/09 2016

1.1.6

1.1.6.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

26/09 2016

1.1.5

1.1.5.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

10/09 2016

1.1.4

1.1.4.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

10/09 2016

1.1.3

1.1.3.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

08/09 2016

1.1.2

1.1.2.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

18/08 2016

1.1.1

1.1.1.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

30/06 2016

1.1.0

1.1.0.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

22/06 2016

1.0.9

1.0.9.0

Package to make upload and generation of urls matching the files

Sources Download

MIT

The Requires

The Development Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

13/06 2016

1.0.8

1.0.8.0

Makes it easier to manage and upload files to your assets provider.

Sources Download

MIT

The Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

07/06 2016

1.0.7

1.0.7.0

Makes it easier to manage and upload files to your assets provider.

Sources Download

The Requires

by Morten Rugaard

by Casper Rasmussen

by Rasmus Ebbesen

laravel s3 cdn assets files nodes

25/02 2016

1.0.6

1.0.6.0

Makes it easier to manage and upload files to your assets provider.

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

06/02 2016

1.0.5

1.0.5.0

Makes it easier to manage and upload files to your assets provider.

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

20/01 2016

1.0.4

1.0.4.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

19/01 2016

1.0.3

1.0.3.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

10/01 2016

1.0.1

1.0.1.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

10/01 2016

1.0.2

1.0.2.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

08/01 2016

1.0.0

1.0.0.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

21/12 2015

0.1.3

0.1.3.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

24/11 2015

0.1.2

0.1.2.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

13/11 2015

0.1.1

0.1.1.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes

13/11 2015

0.1.0

0.1.0.0

Package to make upload and generation of urls matching the files

Sources Download

The Requires

by Casper Rasmussen

laravel s3 cdn assets files nodes