216

I have got user's avatars uploaded in Laravel storage. How can I access them and render them in a view?

The server is pointing all requests to /public, so how can I show them if they are in the /storage folder?

1

13 Answers 13

439

The best approach is to create a symbolic link like @SlateEntropy very well pointed out in the answer below. To help with this, since version 5.3, Laravel includes a command which makes this incredibly easy to do:

php artisan storage:link

That creates a symlink from public/storage to storage/app/public for you and that's all there is to it. Now any file in /storage/app/public can be accessed via a link like:

http://somedomain.com/storage/image.jpg

If, for any reason, your can't create symbolic links (maybe you're on shared hosting, etc.) or you want to protect some files behind some access control logic, there is the alternative of having a special route that reads and serves the image. For example a simple closure route like this:

Route::get('storage/{filename}', function ($filename)
{
    $path = storage_path('public/' . $filename);

    if (!File::exists($path)) {
        abort(404);
    }

    $file = File::get($path);
    $type = File::mimeType($path);

    $response = Response::make($file, 200);
    $response->header("Content-Type", $type);

    return $response;
});

You can now access your files just as you would if you had a symlink:

http://somedomain.com/storage/image.jpg

If you're using the Intervention Image Library you can use its built in response method to make things more succinct:

Route::get('storage/{filename}', function ($filename)
{
    return Image::make(storage_path('public/' . $filename))->response();
});

WARNING

Keep in mind that by manually serving the files you're incurring a performance penalty, because you're going through the entire Laravel request lifecycle in order to read and send the file contents, which is considerably slower than having the HTTP server handle it.

21
  • That seems good. I would like to ask one more question. Is it recommended to store files like avatars, thumbs and so on (uploaded files from users) in storage? May 12, 2015 at 13:23
  • 6
    You can store them wherever you like, but unless those are private files I think you're better off storing them in the public directory. This way you'll be avoiding the overhead of having to compose an image response that could be handled much faster by the HTTP server.
    – Bogdan
    May 12, 2015 at 13:27
  • 2
    Personally I wouldn't store user files in the public folder, I find things much tidier and more manageable when the storage folder is used for storage. May 12, 2015 at 13:31
  • 2
    I wouldn't recommend either of these because then you're adding the overhead of loading Laravel again and/or leveraging PHP to read each image. Using a symlink as described by CmdSft would be much faster. Feb 28, 2016 at 7:39
  • 4
    @user1960364 That's why the last paragraph strongly suggests to use the symlink approach. But the answer itself, while not the best solution from a performance standpoint, is still valid and may be the only approach for people running apps on shared servers where symlinks may be impossible to setup. The answer also showcases how you can serve files programatically if the need ever arises, maybe for serving encrypted files like asked in this question.
    – Bogdan
    Feb 28, 2016 at 12:37
55

One option would be to create a symbolic link between a subfolder in your storage directory and public directory.

For example

ln -s /path/to/laravel/storage/avatars /path/to/laravel/public/avatars

This is also the method used by Envoyer, a deployment manager built by Taylor Otwell, the developer of Laravel.

7
  • I am bit new to this. Does this need to be run on terminal or be defined in a config file somewhere in laravel? Jan 7, 2016 at 23:54
  • yes, you need to run this though the command line. It would need to be setup anywhere you deploy the app. Jan 8, 2016 at 11:37
  • For Windows users, here is a standalone tool for that if you don't want to use CMD : github.com/amd989/Symlinker#downloads
    – David
    Mar 29, 2016 at 18:59
  • 3
    The question asked how to show user avatars stored in storage publicly, usually avatars don't require any sort of access control. If no security is required using any sort of middleware or route is just a wasted hit to your resources. It is also worth noting since Laravel 5.2 a separate file "disk" exists for public files (laravel.com/docs/5.2/filesystem) using symlinks. Apr 14, 2016 at 11:09
  • 8
    There's an artisan command to do this in Laravel 5.3 : $ php artisan storage:link
    – Phil
    Nov 11, 2016 at 12:29
30

According to Laravel 5.2 docs, your publicly accessible files should be put in directory

storage/app/public

To make them accessible from the web, you should create a symbolic link from public/storage to storage/app/public.

ln -s /path/to/laravel/storage/app/public /path/to/laravel/public/storage

Now you can create in your view an URL to the files using the asset helper:

echo asset('storage/file.txt');
20

If you are on windows you can run this command on cmd:

mklink /j /path/to/laravel/public/avatars /path/to/laravel/storage/avatars 

from: http://www.sevenforums.com/tutorials/278262-mklink-create-use-links-windows.html

0
16

First of all you need to create a symbolic link for the storage directory using the artisan command

php artisan storage:link

Then in any view you can access your image through url helper like this.

url('storage/avatars/image.png');
8

If you want to load a small number of Private images You can encode the images to base64 and echo them into <img src="{{$image_data}}"> directly:

$path = image.png
$full_path = Storage::path($path);
$base64 = base64_encode(Storage::get($path));
$image_data = 'data:'.mime_content_type($full_path) . ';base64,' . $base64;

I mentioned private because you should only use these methods if you do not want to store images publicly accessible through url ,instead you Must always use the standard way (link storage/public folder and serve images with HTTP server).

Beware encoding to base64() have two important down sides:

  1. This will increase image size by ~30%.
  2. You combine all of the images sizes in one request, instead of loading them in parallel, this should not be a problem for some small thumbnails but for many images avoid using this method.
5

It is good to save all the private images and docs in storage directory then you will have full control over file ether you can allow certain type of user to access the file or restrict.

Make a route/docs and point to any controller method:

public function docs() {

    //custom logic

    //check if user is logged in or user have permission to download this file etc

    return response()->download(
        storage_path('app/users/documents/4YPa0bl0L01ey2jO2CTVzlfuBcrNyHE2TV8xakPk.png'), 
        'filename.png',
        ['Content-Type' => 'image/png']
    );
}

When you will hit localhost:8000/docs file will be downloaded if any exists.

The file must be in root/storage/app/users/documents directory according to above code, this was tested on Laravel 5.4.

5

If disk 'local' is not working for you then try this :

  1. Change local to public in 'default' => env('FILESYSTEM_DRIVER', 'public'), from project_folder/config/filesystem.php
  2. Clear config cache php artisan config:clear
  3. Then create sym link php artisan storage:link

To get url of uploaded image you can use this Storage::url('image_name.jpg');

1
4

without site name

{{Storage::url($photoLink)}}

if you want to add site name to it example to append on api JSON felids

 public function getPhotoFullLinkAttribute()
{
 Storage::url($this->attributes['avatar']) ;
}
3

You can run this command in your console to make link:

php artisan storage:link
2

If you are using php then just please use the php symlink function, like following:

symlink('/home/username/projectname/storage/app/public', '/home/username/public_html/storage')

change the username and project name to the right names.

2
  • Where is this to be used exactly?
    – askepott
    Nov 26, 2020 at 22:06
  • ssh terminal, if you have ssh access Nov 30, 2020 at 7:26
1

For me it worked with sub-folder route

Route::get('/storage/{folder}/{filename}', function ($folder,$filename)
{
    $path = storage_path('app/public/' .$folder.'/'. $filename);

    if (!File::exists($path)) {
        abort(404);
    }

    $file = File::get($path);
    $type = File::mimeType($path);

    $response = Response::make($file, 200);
    $response->header("Content-Type", $type);

    return $response;
});
0

If you are like me and you somehow have full file paths (I did some glob() pattern matching on required photos so I do pretty much end up with full file paths), and your storage setup is well linked (i.e. such that your paths have the string storage/app/public/), then you can use my little dirty hack below :p)

 public static function hackoutFileFromStorageFolder($fullfilePath) {
        if (strpos($fullfilePath, 'storage/app/public/')) {
           $fileParts = explode('storage/app/public/', $fullfilePath);
           if( count($fileParts) > 1){
               return $fileParts[1];
           }
        }

        return '';
    }

Not the answer you're looking for? Browse other questions tagged or ask your own question.