woodsandwalker/faker-picture

A provider for FakerPHP to generate images from https://picsum.photos.

v1.0.0 2020-12-03 15:58 UTC

This package is auto-updated.

Last update: 2024-10-29 05:53:59 UTC


README

Packagist Downloads Packagist Version

Faker-Picture is a provider for the FakerPHP library to get a random image URL from picsum.photos.

Getting Started

Installation

Faker-Picture requires fakerphp/faker >= 1.12

composer require woodsandwalker/faker-picture

Basic Usage

<?php

include 'vendor/autoload.php';

// use the factory to create a Faker\Generator instance
$faker = Faker\Factory::create();

// add the picture provider to Faker
$faker->addProvider(new WW\Faker\Provider\Picture($faker));

// generate a picture url
echo $faker->pictureUrl(
    640,	// width (px)
    480,	// height (px)
    false,	// grayscale (boolean)
    0,		// blur (0 = no blur, 10 = max blur)
);
// 'https://picsum.photos/640/480'

// generate and save picture and return filepath
echo $faker->picture(
    null,	// directory to save picture (string)
    640,	// width (px)
    480,	// height (px)
    true,	// whether to return full path or just file name (boolean)
    false,	// grayscale (boolean)
    0,		// blur (0 = no blur, 10 = max blur)
);
// '/tmp/0a23be9a5ab609119e14223a22acce50.jpg'

License

Faker-Picture is released under the MIT License. See the bundled LICENSE file for details.