Annex and do what you want with your pictures!
Latest commit 68ed658 Apr 5, 2016 @vinicius73 vinicius73 Merge pull request #8 from edbizarro/master
typecast image object before sending to amazon s3 client

Attacher - Pictures attachment tool for Laravel

Upload for S3, Copy, Local, Anything and attach images in your Models

Current Build Status

Code Climate Codacy Badge PullReview stats


Latest Stable Version Total Downloads Latest Unstable Version License

Inssues Inssues Stars


Powered by ZenHub


1 - Dependency

The first step is using composer to install the package and automatically update your composer.json file, you can do this by running:

composer require artesaos/attacher

2 - Provider

You need to update your application configuration in order to register the package so it can be loaded by Laravel, just update your config/app.php file adding the following code at the end of your 'providers' section:

# config/app.php

// file START ommited
    'providers' => [
        // other providers ommited
// file END ommited

3 - Facade

Optional. You do not need to register the Facade of Attacher, but if you want to have access to some shortcuts feel free to use it.

In order to use the Attacher facade, you need to register it on the config/app.php file, you can do that the following way:

# config/app.php

// file START ommited
    'aliases' => [
        // other Facades ommited
        'Attacher'   => 'Artesaos\Attacher\Facades\Attacher',
// file END ommited

3.1 - Facade API

Attacher::process(Model $model);
Attacher::addStyle($name, callable $closure);

4 - Configuration

Run in your console php artisan vendor:publish, now you have 3 new files, config/attacher.php, config/flysystem.php and database/migrations/2015_03_28_000000_create_attacher_images_table.php

Attacher need graham-campbell/flysystem Don't worry, Attacher registers the flysystem service automatically for you.

# config/attacher.php
return [
    'model'    => 'Artesaos\Attacher\AttacherModel', # You can customize the model for your needs.
    'base_url' => '', # The url basis for the representation of images.
    'path'     => '/uploads/images/:id/:style/:filename', # Change the path where the images are stored.

    # Where the magic happens.
    # This is where you record what the "styles" that will apply to your image.
    # Each style takes as the parameter is one \Intervention\Image\Image
    # See more in
    'style_guides'   => [
        # Optional
        # If you set the original style all other styles used his return to base
        'original'=> function($image)
            return $image->insert('public/watermark.png');
        # Generate thumb (?x500)
        'thumb'=> function($image)
            return $image->resize(null, 500, function ($constraint) {


The usage is very simple. The image destination information are in flysystem configuration file config/flysystem.php there you define which provider to use for uploading.

1 - Basic

$upload = Input::file('image');

$image = new \Artesaos\Attacher\AttacherModel();
$image->setupFile($upload); # attach image
$image->save(); # now attacher process file (generate styles and save in your provider configured in flysystem)

echo $image->url('original');
echo $image->url('thumb'); // your style

2 - Traits

Attacher provides you two traits to facilitate the creation of galleries/collections of images linked to other objects using the technique morphMany and morphOne

2.1 - HasImages

Bond with many images

namespace App;

use Illuminate\Database\Eloquent\Model;
use Artesaos\Attacher\Traits\HasImage;

class Projects extends Model
    use HasImages;

    protected $table = 'projects';


$upload = Input::file('image');

$project = Projects::find(73);

$image = $project->addImage($upload); # Create a new image, save model and save image file with your styles

echo $image->url('thumnail');


$project = Projects::find(73);

# Collection of images
$images = $project->images;

2.2 - HasImage [WIP]

Link to an image

namespace App;

use Illuminate\Database\Eloquent\Model;
use Artesaos\Attacher\Traits\HasImage;

class People extends Model
    use HasImage;

    protected $table = 'people';


$upload = Input::file('image');

$people = People::find(73);

$image = $people->addImage($upload); # Create a new image, save model and save image file with your styles

echo $image->url('thumnail');


$people = People::find(73);

echo $people->image->url('original');


Vinicius Reis