README

一个简单的Laravel 5 Composer包，用于文件上传和图片缩放/裁剪。

• 安装
• 上传文件
• 缩放图片和创建缩略图

安装

要安装Upstream，请确保已在Laravel 5的composer.json文件中添加了regulus/upstream。

"require": {
	"regulus/upstream": "0.6.*"
},

然后，在命令行中运行php composer.phar update。Composer将安装Upstream包。现在，您只需要在config/app.php中注册服务提供者并设置Upstream的别名。将以下内容添加到providers数组中

Regulus\Upstream\UpstreamServiceProvider::class,

并将以下内容添加到aliases数组中

'Upstream' => Regulus\Upstream\Facade::class,

最后，运行php artisan vendor:publish以发布配置文件和语言文件。

上传文件

$config = [
	'path'            => 'uploads/pdfs', // the path to upload to
	'field'           => 'file',         // name of field (use "fields" for an array with multiple fields)
	'filename'        => 'temp',         // the basename of the file (extension will be added automatically)
	'fileTypes'       => ['png', 'jpg'], // the file types to allow
	'createDirectory' => true,           // automatically creates directory if it doesn't exist
	'overwrite'       => true,           // whether or not to overwrite existing file of the same name
	'maxFileSize'     => '5MB',          // the maximum filesize of file to be uploaded
];

$upstream = Upstream::make($config);
$result   = $upstream->upload();

注意：提供了特殊的filename字符串，包括[LOWERCASE]、[UNDERSCORED]、[LOWERCASE-UNDERSCORED]、[DASHED]、[LOWERCASE-DASHED]和[RANDOM]。前五个用于对原始文件名进行格式调整。后者可用于将文件名设置为随机字符串（包括其原始扩展名）。

缩放图片和创建缩略图

$config = [
	'path'               => 'uploads/images',
	'fields'             => ['picture', 'picture2'],
	'filename'           => 'temp',
	'fileTypes'          => 'images',
	'createDirectory'    => true,
	'overwrite'          => true,
	'maxFileSize'        => '5MB',
	'imageResize'        => true,
	'imageResizeQuality' => 60,
	'imageCrop'          => true,
	'imageDimensions'    => [
		'w'  => 720, // image width
		'h'  => 360, // image height
		'tw' => 180, // thumbnail image width
		'th' => 180, // thumbnail image height
	],
];

$upstream = Upstream::make($config);
$result   = $upstream->upload();

完整的配置数组位于src/config/config.php配置文件中。您可以使用以下命令在上传图片后裁剪图片

$config = [
	'path'            => 'uploads/images',
	'filename'        => 'temp-'.$id.'.jpg',
	'newFilename'     => $id.'.jpg',
	'createDirectory' => true,
	'overwrite'       => true,
	'imageThumb'      => true,
	'imageDimensions' => [
		'w'  => 260, // image width
		'h'  => 260, // image height
		'tw' => 120, // thumbnail image width
		'th' => 120, // thumbnail image height
	],
	'cropPosition' => [
		'x' => $input['x'],      // X position
		'y' => $input['y'],      // Y position
		'w' => $input['width'],  // width of cropped area
		'h' => $input['height'], // height of cropped area
	],
];

$result = Upstream::cropImage($config);

您可以使用JavaScript图片裁剪器（例如Cropper）来设置cropPosition。如果将cropPosition设置为null或未设置，则图片将首先缩放到目标尺寸的140%，然后从中心裁剪。