boomdraw/laravel-dummy-image

基于 kingkool68/dummyimage 的 Laravel 模拟图片生成器

0.2.1 2018-09-15 18:07 UTC

This package is auto-updated.

Last update: 2024-09-06 00:25:43 UTC


README

此包允许您在 Laravel 框架中生成动态模拟图片。

它基于 Russell Heimlich 的模拟图片生成器

安装后,您可以进行如下操作

// Generate and store an image
DummyImage::put($path, $disk);

// Generate and return image as response
DummyImage::toResponse($code, $headers);

// Generate and return image as base64
DummyImage::toBase64($code, $headers);

安装

Laravel

您可以通过 composer 安装此包

composer require boomdraw/laravel-dummy-image

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="BoomDraw\DummyImage\DummyImageServiceProvider" --tag="config"

发布后,config/dummyimage.php 配置文件包含

return [

    /*
     * Default disk for generated image
     */
    'disk' => 'local',

    /*
     * Default path for generated image
     */
    'path' => 'dummyimage',

    /*
     * Additional headers for response
     */
    'headers' => [
        //
    ],

    /*
     * Additional html color names with hex value for name to hex convertation
     */
    'color_names' => [
        //'color_name' => '00ffff'
    ],
];

使用方法

// Generate an image with custom params
$image = DummyImage::generate($dimensions = '200x1:5', $format = 'gif', $bg_color = 'ff00cc', $fg_color = '00ffcc', $text = 'I am image text');

// Generate and store an image
$image->put($path, $disk);

// Generate and return image as response
$image->toResponse($code, $headers);

// Generate and return image as base64 string
$image->toBase64($code, $headers);

如果使用的方法未包含 generate(),则将使用默认参数生成图片。

您可以提供自己的参数来生成图片

  • $dimensions - 图片尺寸。
    您可以提供图片尺寸和/或比例。默认使用 '800x600'。
    示例
    '800x600' 将生成宽度为 800px 和高度为 600px 的图片
    '800' 将生成宽度为 800px 和高度为 800px 的图片
    '250x1:2' 将生成宽度为 250px 和高度为 500px 的图片
    '1:3x300' 将生成宽度为 100px 和高度为 300px 的图片
  • $format - 生成的图片格式 ('jpg', 'gif', 'png')。默认格式为 'png'。
  • $bg-color - 图片背景颜色(十六进制)。默认为白色 ('ffffff')。
  • $fg_color - 图片文字颜色(十六进制)。默认为黑色 ('000000')。
  • $text 变量提供将在图片上写入的文本。默认为图片尺寸。

资源

许可

MIT 许可证 (MIT)。

软件按“原样”提供,不提供任何形式的保证,无论是明示的、暗示的,还是关于适销性、特定用途的适用性或非侵权性的保证。在任何情况下,作者或版权所有者都不应对任何索赔、损害或其他责任负责,无论这些责任是因合同、侵权或其他原因而产生的,与软件或其使用或其他方式有关。