swatty007 / faker-image-generator
FakerPHP的占位符图像生成器
Requires
- php: ^8.1
- ext-gd: *
- fakerphp/faker: ~1.13
Requires (Dev)
- ext-exif: *
- friendsofphp/php-cs-fixer: ^2.18|^3
- orchestra/testbench: ^v8.0.0
- phpmd/phpmd: @stable
- phpmetrics/phpmetrics: ^2.7
- phpunit/phpunit: ^10
This package is auto-updated.
Last update: 2024-09-26 18:46:40 UTC
README
使用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'。
$faker->imageGenerator('img', 640, 480, 'png', true, 'Faker', '#0018ff', '#ffd800');
将生成一张640x480像素的蓝色png图片,其中包含黄色文字'Faker',位于您的项目的目录中,并返回完整的路径,如下所示:
'img/f523f8bec6ed65fb1d63ae8d09850f9c.png'
。
使用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存储库中所述。