Asset Repository

To work with the Asset Repository, use the following Facade:

use Statamic\Facades\Asset;

Methods

Querying

Examples

Get all assets in a container

Asset::query()
    ->where('container', 'main')
    ->get();

Get all assets in a folder

Asset::query()
->where('container', 'main')
    ->where('folder', 'team_photos')
    ->get();

Get all assets without an alt tag

Asset::query()
    ->where('container', 'main')
    ->where('alt', null)
    ->get();

Get all Assets with "thumbnail" in the path.

Asset::query()
    ->where('container', 'main')
    ->where('path', 'like', '%thumbnail%')
    ->get();

Get the newest 10 assets from a container

Asset::query()
    ->where('container', 'main')
    ->orderBy('last_modified', 'desc')
    ->get();

Creating

Start by making an instance of an asset with the make method.
You need at least a path and the container before you can save an asset.

$asset = Asset::make()->container('assets')->path('images/hat.jpg');

Or, if you have an asset container instance, you can use the makeAsset method.

$asset = $container->makeAsset('images/hat.jpg');

Once you have an asset instance, you can add data to it.

$asset->data(['foo' => 'bar']);

Finally, save it. It'll return a boolean for whether it succeeded.

$asset->save(); // true or false

$file = $request->file('file');
$asset->upload($file);