FM / basic-usage

/var/www/flurhymez/vendor/spatie/laravel-medialibrary/docs/basic-usage/

/var/www/flurhymez/vendor/spatie/laravel-medialibrary/docs/basic-usage

Name	Size	Mode	Actions
associating-files.md	1737	0644	edit dl rm
preparing-your-model.md	376	0644	edit dl rm
retrieving-media.md	5030	0644	edit dl rm
_index.md	37	0644	edit dl rm

Edit: /var/www/flurhymez/vendor/spatie/laravel-medialibrary/docs/basic-usage/associating-files.md (1737B)

---
title: Associating files
weight: 2
---

You can associate a file with a model like this:

```php
$yourModel = YourModel::find(1);
$yourModel
   ->addMedia($pathToFile)
   ->toMediaCollection();
```

The file will now be associated with the `YourModel` instance and will be moved to the disk you've configured.

If you want to not move, but copy, the original file you can call `preservingOriginal`:

```php
$yourModel
   ->addMedia($pathToFile)
   ->preservingOriginal()
   ->toMediaCollection();
```

You can also add a remote file to the media library:

```php
$url = 'http://medialibrary.spatie.be/assets/images/mountain.jpg';
$yourModel
   ->addMediaFromUrl($url)
   ->toMediaCollection();
```

If a file already exists on a storage disk, you can also add it to the media library:

```php
$yourModel
   ->addMediaFromDisk('/path/to/file', 's3')
   ->toMediaCollection();
```

The media library does not restrict what kinds of files may be uploaded or associated with models. If you are accepting file uploads from users, you should take steps to validate those uploads, to ensure you don't introduce security vulnerabilities into your project. Laravel has [a rule to validate uploads based on MIME type or file extension](https://laravel.com/docs/validation).

## Are you a visual learner?

Here's a video that shows how to associate files.

Want to see more videos like this? Check out our [free video course on how to use Laravel Media Library](https://spatie.be/videos/discovering-laravel-media-library).

cmd: