<?php namespace Faker\Provider; /** * Depends on image generation from http://lorempixel.com/ */ class Image extends Base { /** * @var string */ public const BASE_URL = 'https://via.placeholder.com'; public const FORMAT_JPG = 'jpg'; public const FORMAT_JPEG = 'jpeg'; public const FORMAT_PNG = 'png'; /** * @var array * * @deprecated Categories are no longer used as a list in the placeholder API but referenced as string instead */ protected static $categories = [ 'abstract', 'animals', 'business', 'cats', 'city', 'food', 'nightlife', 'fashion', 'people', 'nature', 'sports', 'technics', 'transport', ]; /** * Generate the URL that will return a random image * * Set randomize to false to remove the random GET parameter at the end of the url. * * @example 'http://via.placeholder.com/640x480.png/CCCCCC?text=well+hi+there' * * @param int $width * @param int $height * @param string|null $category * @param bool $randomize * @param string|null $word * @param bool $gray * @param string $format * * @return string */ public static function imageUrl( $width = 640, $height = 480, $category = null, $randomize = true, $word = null, $gray = false, $format = 'png' ) { trigger_deprecation( 'fakerphp/faker', '1.20', 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead', ); // Validate image format $imageFormats = static::getFormats(); if (!in_array(strtolower($format), $imageFormats, true)) { throw new \InvalidArgumentException(sprintf( 'Invalid image format "%s". Allowable formats are: %s', $format, implode(', ', $imageFormats), )); } $size = sprintf('%dx%d.%s', $width, $height, $format); $imageParts = []; if ($category !== null) { $imageParts[] = $category; } if ($word !== null) { $imageParts[] = $word; } if ($randomize === true) { $imageParts[] = Lorem::word(); } $backgroundColor = $gray === true ? 'CCCCCC' : str_replace('#', '', Color::safeHexColor()); return sprintf( '%s/%s/%s%s', self::BASE_URL, $size, $backgroundColor, count($imageParts) > 0 ? '?text=' . urlencode(implode(' ', $imageParts)) : '', ); } /** * Download a remote random image to disk and return its location * * Requires curl, or allow_url_fopen to be on in php.ini. * * @example '/path/to/dir/13b73edae8443990be1aa8f1a483bc27.png' * * @return bool|string */ public static function image( $dir = null, $width = 640, $height = 480, $category = null, $fullPath = true, $randomize = true, $word = null, $gray = false, $format = 'png' ) { trigger_deprecation( 'fakerphp/faker', '1.20', 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead', ); $dir = null === $dir ? sys_get_temp_dir() : $dir; // GNU/Linux / OS X / Windows compatible // Validate directory path if (!is_dir($dir) || !is_writable($dir)) { throw new \InvalidArgumentException(sprintf('Cannot write to directory "%s"', $dir)); } // Generate a random filename. Use the server address so that a file // generated at the same time on a different server won't have a collision. $name = md5(uniqid(empty($_SERVER['SERVER_ADDR']) ? '' : $_SERVER['SERVER_ADDR'], true)); $filename = sprintf('%s.%s', $name, $format); $filepath = $dir . DIRECTORY_SEPARATOR . $filename; $url = static::imageUrl($width, $height, $category, $randomize, $word, $gray, $format); // save file if (function_exists('curl_exec')) { // use cURL $fp = fopen($filepath, 'w'); $ch = curl_init($url); curl_setopt($ch, CURLOPT_FILE, $fp); $success = curl_exec($ch) && curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200; fclose($fp); curl_close($ch); if (!$success) { unlink($filepath); // could not contact the distant URL or HTTP error - fail silently. return false; } } elseif (ini_get('allow_url_fopen')) { // use remote fopen() via copy() $success = copy($url, $filepath); if (!$success) { // could not contact the distant URL or HTTP error - fail silently. return false; } } else { return new \RuntimeException('The image formatter downloads an image from a remote HTTP server. Therefore, it requires that PHP can request remote hosts, either via cURL or fopen()'); } return $fullPath ? $filepath : $filename; } public static function getFormats(): array { trigger_deprecation( 'fakerphp/faker', '1.20', 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead', ); return array_keys(static::getFormatConstants()); } public static function getFormatConstants(): array { trigger_deprecation( 'fakerphp/faker', '1.20', 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead', ); return [ static::FORMAT_JPG => constant('IMAGETYPE_JPEG'), static::FORMAT_JPEG => constant('IMAGETYPE_JPEG'), static::FORMAT_PNG => constant('IMAGETYPE_PNG'), ]; } }
Name | Type | Size | Permission | Actions |
---|---|---|---|---|
ar_EG | Folder | 0755 |
|
|
ar_JO | Folder | 0755 |
|
|
ar_SA | Folder | 0755 |
|
|
at_AT | Folder | 0755 |
|
|
bg_BG | Folder | 0755 |
|
|
bn_BD | Folder | 0755 |
|
|
cs_CZ | Folder | 0755 |
|
|
da_DK | Folder | 0755 |
|
|
de_AT | Folder | 0755 |
|
|
de_CH | Folder | 0755 |
|
|
de_DE | Folder | 0755 |
|
|
el_CY | Folder | 0755 |
|
|
el_GR | Folder | 0755 |
|
|
en_AU | Folder | 0755 |
|
|
en_CA | Folder | 0755 |
|
|
en_GB | Folder | 0755 |
|
|
en_HK | Folder | 0755 |
|
|
en_IN | Folder | 0755 |
|
|
en_NG | Folder | 0755 |
|
|
en_NZ | Folder | 0755 |
|
|
en_PH | Folder | 0755 |
|
|
en_SG | Folder | 0755 |
|
|
en_UG | Folder | 0755 |
|
|
en_US | Folder | 0755 |
|
|
en_ZA | Folder | 0755 |
|
|
es_AR | Folder | 0755 |
|
|
es_ES | Folder | 0755 |
|
|
es_PE | Folder | 0755 |
|
|
es_VE | Folder | 0755 |
|
|
et_EE | Folder | 0755 |
|
|
fa_IR | Folder | 0755 |
|
|
fi_FI | Folder | 0755 |
|
|
fr_BE | Folder | 0755 |
|
|
fr_CA | Folder | 0755 |
|
|
fr_CH | Folder | 0755 |
|
|
fr_FR | Folder | 0755 |
|
|
he_IL | Folder | 0755 |
|
|
hr_HR | Folder | 0755 |
|
|
hu_HU | Folder | 0755 |
|
|
hy_AM | Folder | 0755 |
|
|
id_ID | Folder | 0755 |
|
|
is_IS | Folder | 0755 |
|
|
it_CH | Folder | 0755 |
|
|
it_IT | Folder | 0755 |
|
|
ja_JP | Folder | 0755 |
|
|
ka_GE | Folder | 0755 |
|
|
kk_KZ | Folder | 0755 |
|
|
ko_KR | Folder | 0755 |
|
|
lt_LT | Folder | 0755 |
|
|
lv_LV | Folder | 0755 |
|
|
me_ME | Folder | 0755 |
|
|
mn_MN | Folder | 0755 |
|
|
ms_MY | Folder | 0755 |
|
|
nb_NO | Folder | 0755 |
|
|
ne_NP | Folder | 0755 |
|
|
nl_BE | Folder | 0755 |
|
|
nl_NL | Folder | 0755 |
|
|
pl_PL | Folder | 0755 |
|
|
pt_BR | Folder | 0755 |
|
|
pt_PT | Folder | 0755 |
|
|
ro_MD | Folder | 0755 |
|
|
ro_RO | Folder | 0755 |
|
|
ru_RU | Folder | 0755 |
|
|
sk_SK | Folder | 0755 |
|
|
sl_SI | Folder | 0755 |
|
|
sr_Cyrl_RS | Folder | 0755 |
|
|
sr_Latn_RS | Folder | 0755 |
|
|
sr_RS | Folder | 0755 |
|
|
sv_SE | Folder | 0755 |
|
|
th_TH | Folder | 0755 |
|
|
tr_TR | Folder | 0755 |
|
|
uk_UA | Folder | 0755 |
|
|
vi_VN | Folder | 0755 |
|
|
zh_CN | Folder | 0755 |
|
|
zh_TW | Folder | 0755 |
|
|
Address.php | File | 3.49 KB | 0644 |
|
Barcode.php | File | 2.19 KB | 0644 |
|
Base.php | File | 20.44 KB | 0644 |
|
Biased.php | File | 1.79 KB | 0644 |
|
Color.php | File | 4.64 KB | 0644 |
|
Company.php | File | 901 B | 0644 |
|
DateTime.php | File | 11.88 KB | 0644 |
|
File.php | File | 25.1 KB | 0644 |
|
HtmlLorem.php | File | 9.98 KB | 0644 |
|
Image.php | File | 6 KB | 0644 |
|
Internet.php | File | 17.17 KB | 0644 |
|
Lorem.php | File | 7.62 KB | 0644 |
|
Medical.php | File | 648 B | 0644 |
|
Miscellaneous.php | File | 13.13 KB | 0644 |
|
Payment.php | File | 10.42 KB | 0644 |
|
Person.php | File | 3.23 KB | 0644 |
|
PhoneNumber.php | File | 6.45 KB | 0644 |
|
Text.php | File | 6.65 KB | 0644 |
|
UserAgent.php | File | 8.46 KB | 0644 |
|
Uuid.php | File | 1.78 KB | 0644 |
|