README

Laravel-Mediable 是一个用于将媒体文件轻松上传和附加到 Laravel/Lumen 模型的包。

安装

通过 Composer

$ composer require simonmarcellinden/mediable

在 config/app.php 中注册包的服务提供者。在 Laravel 5.5 及以上版本中，如果启用了包自动发现，此步骤可以跳过。

打开并添加服务提供者到 bootstrap/app.php

	$app->register(\SimonMarcelLinden\Mediable\MediableServiceProvider::class);

发布配置

从项目的根目录运行以下命令

$ no config needed

运行迁移以将所需的表添加到数据库中。

$ php artisan migrate

示例用法

如果您需要为图像上传创建一个模型

创建一个 Eloquent 模型和控制器

    php artisan make:model Image -c

通过此包的模型扩展您的 Eloquent 模型。

<?php

namespace App\Models;

use SimonMarcelLinden\Mediable\Models\Media;

class Image extends Media {
	/**
	* If you want to use a different table than media , please specify it here.
	*
	* @var string
	*/
	protected $table = 'images';

	/**
	 * If you want your media to be stored in a specific file folder, then specify it here.
	 *
	 * @var array
	 */
	protected $basePath = 'images';
}

通过包的控制器扩展您的控制器，并指定控制器中使用的 Eloquent 模型。

<?php

namespace App\Http\Controllers;

use App\Models\Image;
use SimonMarcelLinden\Mediable\Http\Controllers\MediaController;

class ImageController extends MediaController {
	/**
	 * The attributes that are mass assignable.
	 *
	 * @var array
	 */
	protected $model = Image::class;
}

配置默认路由

	$router->group(['prefix' => 'image'], function () use ($router) {
		$router->get('/{id}', 'ImageController@show');
		$router->post('/upload', 'ImageController@upload');
		$router->delete('/delete/{id}', 'ImageController@delete');
	});

如果您需要一个多对多关系，请将以下代码添加到您的媒体模型中。

use SimonMarcelLinden\Mediable\Models\Media;

class Image extends Media {
	/**
     * Get all of the user that are assigned this model.
     */
    public function users() {
        return $this->morphedByMany(Drink::class, 'mediable');
    }

	/**
     * Get all of the products that are assigned this model.
     */
    public function products() {
        return $this->morphedByMany(Product::class, 'mediable');
	}
}

并将以下代码添加到您的 Eloquent 模型中

class Product extends Model {
	use Uuids;

	public function media() {
        return $this->morphToMany(Image::class, 'mediable', 'mediables', 'mediable_id', "media_id");
    }
}

class User extends Model {
	use Uuids;

	public function media() {
        return $this->morphToMany(Image::class, 'mediable', 'mediables', 'mediable_id', "media_id");
    }
}

变更日志

有关最近更改的更多信息，请参阅变更日志。

测试

$ composer test

贡献

有关详细信息，请参阅contributing.md和待办事项列表。

安全

如果您发现任何与安全相关的问题，请通过info@snerve.de发送电子邮件，而不是使用问题跟踪器。