smknstd / fakerphp-picsum-images
Alternative image provider for fakerphp using picsum.photos
Fund package maintenance!
smknstd
Installs: 84 908
Dependents: 2
Suggesters: 0
Security: 0
Stars: 32
Watchers: 3
Forks: 5
Open Issues: 0
Requires
- php: ^8.0
- fakerphp/faker: ^1.10
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.0
- phpunit/phpunit: ^9.5
- spatie/ray: ^1.28
- vimeo/psalm: ^4.8
Suggests
- ext-curl: *
README
Introduction
Alternative image provider for fakerphp using picsum.photos
This package has been forked from mmo/faker-images for fzaninotto/faker (deprecated ~ Oct 2020).
Ressources
Installation
You can install the package via composer in dev dependency section:
composer require --dev smknstd/fakerphp-picsum-images
Usage
$faker = \Faker\Factory::create(); $faker->addProvider(new \Smknstd\FakerPicsumImages\FakerPicsumImagesProvider($faker)); // return a string that contains a url like 'https://picsum.photos/800/600/' $faker->imageUrl(width: 800, height: 600); // return a string that contains a url which returns the same random image based on the provided seed $filePath= $faker->image(width: 800, height: 800, seed: 'useremail@example.com'); // download a properly sized image from picsum into a file with a file path like '/tmp/13b73edae8443990be1aa8f1a483bc27.jpg' $filePath= $faker->image(dir: '/tmp', width: 640, height: 480);
Also, there are some more options :
- alternative webp format
- effects (grayscale, blurry)
- seeding ensures you can get the same photo each time by providing a seed string
- returning a specific photo based on an id instead of a random one (ex: https://picsum.photos/id/1/800/600)
Testing
composer test
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.