swatty007/faker-image-generator

FakerPHP的占位符图像生成器

3.0.0 2023-09-26 16:17 UTC

This package is auto-updated.

Last update: 2024-09-26 18:46:40 UTC


README

Package Banner

Latest Version on Packagist License: MIT Build Status Code Style Quality Score Total Downloads

使用GD为fzaninotto/Faker生成占位符图像,以便在应用程序或测试中快速生成虚假图像,无需依赖外部服务。

这是从bruceheller/images-generator分支出来的,因为那个包似乎已经不再积极维护了。

安装

您可以通过composer安装此包

composer require swatty007/faker-image-generator

配置

安装包后,您可以通过以下方式发布配置文件

php artisan vendor:publish --provider="Swatty007\FakerImageGenerator\FakerImageGeneratorServiceProvider"

它包含一些可选的配置参数,并完全文档化。

配置允许您定义一些全局图像属性,这些属性将在所有生成实例之间共享。这是对原始包的补充,以便更容易在整个应用程序中共享类似风格。

用法

结合使用FakerImageGenerationProvider类和Faker来生成新图像

$faker = Factory::create();
$imageGenerator = new FakerImageGenerationProvider($faker);
$image = $faker->imageGenerator();

它将在您的临时目录内(如果可用)生成一张640*480像素的黑色png图片,并返回图片的完整路径,如下所示:'/tmp/13b73edae8443990be1aa8f1a483bc27.png'

参数

imageGenerator()方法允许您在元素级别上定义渲染选项,这些选项与您的配置属性相同,并将允许您快速生成唯一的图像。

示例

$faker->imageGenerator();

将生成一张640x480像素的黑色png图片,上面有白色的文字'640x480'。

Default Image

$faker->imageGenerator('img', 640, 480, 'png', true, 'Faker', '#0018ff', '#ffd800');

将生成一张640x480像素的蓝色png图片,其中包含黄色文字'Faker',位于您的项目的目录中,并返回完整的路径,如下所示:'img/f523f8bec6ed65fb1d63ae8d09850f9c.png'

Custom Image

使用Faker的强大功能的一个更复杂的示例

$faker->imageGenerator('img', $faker->numberBetween(600, 800), $faker->numberBetween(400, 600), 'jpg', true, $faker->word, $faker->hexColor, $faker->hexColor);

将返回一个随机颜色的jpeg图片,宽度在600到800像素之间,高度在400到600像素之间,上面有随机颜色的随机单词!

测试

composer test

变更日志

有关最近更改的更多信息,请参阅CHANGELOG

待办事项

由于这是一个现有包的分支,为了在现代应用程序中运行,其未来的开发计划可能也适用于此包。然而,它当前的功能满足了我的需求。尽管如此,还有一些待办事项是开放的,并欢迎通过拉取请求进行提交 🧐

  • 改进README
  • 过渡到GitHub Actions
  • 改进和扩展现有测试!
  • 添加对ImageMagick和/或GraphicsMagick的支持,以便更快地生成图片。

否则,任何建议都欢迎!您可以分支此项目并提交您的PR :)

贡献

有关详细信息,请参阅CONTRIBUTING

安全

如果您发现任何安全问题,请通过info@martin-niehoff.de发送电子邮件,而不是使用问题跟踪器。

致谢

许可

MIT许可(MIT)。有关更多信息,请参阅许可文件

本项目包含的Roboto字体文件遵循Apache许可证2.0,如Roboto存储库中所述。