Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/efureev/laravel-files
https://github.com/efureev/laravel-files
file image laravel laravel-package
Last synced: about 7 hours ago
JSON representation
- Host: GitHub
- URL: https://github.com/efureev/laravel-files
- Owner: efureev
- Created: 2018-12-25T14:01:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-01-23T13:57:13.000Z (almost 6 years ago)
- Last Synced: 2024-04-24T01:21:43.434Z (7 months ago)
- Topics: file, image, laravel, laravel-package
- Language: PHP
- Size: 1.81 MB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
[](https://packagist.org/packages/feugene/laravel-files)
[](https://packagist.org/packages/feugene/laravel-files)
[](https://packagist.org/packages/feugene/laravel-files)
[](https://travis-ci.org/efureev/laravel-files)
[](https://codeclimate.com/github/efureev/laravel-files/maintainability)
[](https://codeclimate.com/github/efureev/laravel-files/test_coverage)
## Information
Add-on file model for Laravel models. Implements work with native files.
## Install
- `composer require feugene/laravel-files`
## Examples
- Add ServiceProvider into your app: `config/app.php` (section: `providers`)
```php
// ...
Feugene\Files\ServiceProvider::class,
```
or if Laravel >= 5.7 - use service discover.
- Run `php artisan migrate` for add table for file
### File upload
Only simple upload:
```php
public function store()
{
$list = app(UploadService::class)
->upload();
return [
'success' => $list->isNotEmpty(),
'files' => $list,
];
}
```
Upload with wrapped file to model via after actions:
```php
public function store()
{
$list = app(UploadService::class)
->setAfterAction(AfterModelAction::class)
->upload();
return [
'success' => $list->isNotEmpty(),
'files' => $list,
];
}
```
Upload with wrapped file to custom model and custom path:
```php
public function store(int $sectionId)
{
/** @var Section $section */
$section = Section::findOrFail($sectionId);
$this->authorize('uploadFile', $section);
$upload = new Upload($section);
$path = $upload->getUploadPath();
$list = app(UploadService::class)
->setPath($path)
->setAction(BeforeBaseAction::class, 'before')
->setAfterAction(AfterModelAction::class)
->setAfterAction(function ($file) use ($section) {
/** @var \Feugene\Files\Models\File $file */
return File::create([
'section_id' => $section->id,
'author_id' => \Auth::id(),
'name' => $file->getBaseFile()->getFilename(),
'file_id' => $file->getKey()
]);
})
->upload();
return [
'success' => $list->isNotEmpty(),
'files' => $list,
];
}
```
### Relations and image operations
```php
// find image type from DB
/** @var ImageFile $file */
$file = ImageFile::find($id);
// create child relation with clone image
$child = $file->createChild();
// Image scale to 50% from original
// without relation
$child = $file->scale(new ScaleModificator(50));
// create child relation
$child = $file->createChild(new ScaleModificator(50));
// Image resize to 50px by width
// without relation
$child = $file->resize(new ResizeModificator(50));
// create child relation
$child = $file->createChild(new ResizeModificator(50));
// Image resize to 50px by height
// without relation
$child = $file->resize(new ResizeModificator(null, 50));
// create child relation
$child = $file->createChild(new ResizeModificator(null, 50));
// Image resize to 50px by height and 100px by width and bestFit options
// without relation
$child = $file->resize(new ResizeModificator(100, 50));
// create child relation
$child = $file->createChild(new ResizeModificator(100, 50));
// Image resize to 50px by height and 100px by width and important size (100x50)
// without relation
$child = $file->resize(new ResizeModificator(100, 50, false));
$child = $file->resize(new ResizeModificator(100, 50, false), true); // if original image is smaller than target image
// create child relation
$child = $file->createChild(new ResizeModificator(100, 50, false));
```