ar_EG
2 years ago
ar_JO
2 years ago
ar_SA
2 years ago
at_AT
2 years ago
bg_BG
2 years ago
bn_BD
2 years ago
cs_CZ
2 years ago
da_DK
2 years ago
de_AT
2 years ago
de_CH
2 years ago
de_DE
2 years ago
el_CY
2 years ago
el_GR
2 years ago
en_AU
2 years ago
en_CA
2 years ago
en_GB
2 years ago
en_HK
2 years ago
en_IN
2 years ago
en_NG
2 years ago
en_NZ
2 years ago
en_PH
2 years ago
en_SG
2 years ago
en_UG
2 years ago
en_US
2 years ago
en_ZA
2 years ago
es_AR
2 years ago
es_ES
2 years ago
es_PE
2 years ago
es_VE
2 years ago
et_EE
2 years ago
fa_IR
2 years ago
fi_FI
2 years ago
fr_BE
2 years ago
fr_CA
2 years ago
fr_CH
2 years ago
fr_FR
2 years ago
he_IL
2 years ago
hr_HR
2 years ago
hu_HU
2 years ago
hy_AM
2 years ago
id_ID
2 years ago
is_IS
2 years ago
it_CH
2 years ago
it_IT
2 years ago
ja_JP
2 years ago
ka_GE
2 years ago
kk_KZ
2 years ago
ko_KR
2 years ago
lt_LT
2 years ago
lv_LV
2 years ago
me_ME
2 years ago
mn_MN
2 years ago
ms_MY
2 years ago
nb_NO
2 years ago
ne_NP
2 years ago
nl_BE
2 years ago
nl_NL
2 years ago
pl_PL
2 years ago
pt_BR
2 years ago
pt_PT
2 years ago
ro_MD
2 years ago
ro_RO
2 years ago
ru_RU
2 years ago
sk_SK
2 years ago
sl_SI
2 years ago
sr_Cyrl_RS
2 years ago
sr_Latn_RS
2 years ago
sr_RS
2 years ago
sv_SE
2 years ago
th_TH
2 years ago
tr_TR
2 years ago
uk_UA
2 years ago
vi_VN
2 years ago
zh_CN
2 years ago
zh_TW
2 years ago
Address.php
2 years ago
Barcode.php
2 years ago
Base.php
2 years ago
Biased.php
2 years ago
Color.php
2 years ago
Company.php
2 years ago
DateTime.php
2 years ago
File.php
2 years ago
HtmlLorem.php
2 years ago
Image.php
2 years ago
Internet.php
2 years ago
Lorem.php
2 years ago
Medical.php
2 years ago
Miscellaneous.php
2 years ago
Payment.php
2 years ago
Person.php
2 years ago
PhoneNumber.php
2 years ago
Text.php
2 years ago
UserAgent.php
2 years ago
Uuid.php
2 years ago
Image.php
202 lines
| 1 | <?php |
| 2 | /** |
| 3 | * @license MIT |
| 4 | * |
| 5 | * Modified by impress-org on 23-January-2024 using Strauss. |
| 6 | * @see https://github.com/BrianHenryIE/strauss |
| 7 | */ |
| 8 | |
| 9 | namespace Give\Vendors\Faker\Provider; |
| 10 | |
| 11 | /** |
| 12 | * Depends on image generation from http://lorempixel.com/ |
| 13 | */ |
| 14 | class Image extends Base |
| 15 | { |
| 16 | /** |
| 17 | * @var string |
| 18 | */ |
| 19 | public const BASE_URL = 'https://via.placeholder.com'; |
| 20 | |
| 21 | public const FORMAT_JPG = 'jpg'; |
| 22 | public const FORMAT_JPEG = 'jpeg'; |
| 23 | public const FORMAT_PNG = 'png'; |
| 24 | |
| 25 | /** |
| 26 | * @var array |
| 27 | * |
| 28 | * @deprecated Categories are no longer used as a list in the placeholder API but referenced as string instead |
| 29 | */ |
| 30 | protected static $categories = [ |
| 31 | 'abstract', 'animals', 'business', 'cats', 'city', 'food', 'nightlife', |
| 32 | 'fashion', 'people', 'nature', 'sports', 'technics', 'transport', |
| 33 | ]; |
| 34 | |
| 35 | /** |
| 36 | * Generate the URL that will return a random image |
| 37 | * |
| 38 | * Set randomize to false to remove the random GET parameter at the end of the url. |
| 39 | * |
| 40 | * @example 'http://via.placeholder.com/640x480.png/CCCCCC?text=well+hi+there' |
| 41 | * |
| 42 | * @param int $width |
| 43 | * @param int $height |
| 44 | * @param string|null $category |
| 45 | * @param bool $randomize |
| 46 | * @param string|null $word |
| 47 | * @param bool $gray |
| 48 | * @param string $format |
| 49 | * |
| 50 | * @return string |
| 51 | */ |
| 52 | public static function imageUrl( |
| 53 | $width = 640, |
| 54 | $height = 480, |
| 55 | $category = null, |
| 56 | $randomize = true, |
| 57 | $word = null, |
| 58 | $gray = false, |
| 59 | $format = 'png' |
| 60 | ) { |
| 61 | trigger_deprecation( |
| 62 | 'fakerphp/faker', |
| 63 | '1.20', |
| 64 | 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead' |
| 65 | ); |
| 66 | |
| 67 | // Validate image format |
| 68 | $imageFormats = static::getFormats(); |
| 69 | |
| 70 | if (!in_array(strtolower($format), $imageFormats, true)) { |
| 71 | throw new \InvalidArgumentException(sprintf( |
| 72 | 'Invalid image format "%s". Allowable formats are: %s', |
| 73 | $format, |
| 74 | implode(', ', $imageFormats) |
| 75 | )); |
| 76 | } |
| 77 | |
| 78 | $size = sprintf('%dx%d.%s', $width, $height, $format); |
| 79 | |
| 80 | $imageParts = []; |
| 81 | |
| 82 | if ($category !== null) { |
| 83 | $imageParts[] = $category; |
| 84 | } |
| 85 | |
| 86 | if ($word !== null) { |
| 87 | $imageParts[] = $word; |
| 88 | } |
| 89 | |
| 90 | if ($randomize === true) { |
| 91 | $imageParts[] = Lorem::word(); |
| 92 | } |
| 93 | |
| 94 | $backgroundColor = $gray === true ? 'CCCCCC' : str_replace('#', '', Color::safeHexColor()); |
| 95 | |
| 96 | return sprintf( |
| 97 | '%s/%s/%s%s', |
| 98 | self::BASE_URL, |
| 99 | $size, |
| 100 | $backgroundColor, |
| 101 | count($imageParts) > 0 ? '?text=' . urlencode(implode(' ', $imageParts)) : '' |
| 102 | ); |
| 103 | } |
| 104 | |
| 105 | /** |
| 106 | * Download a remote random image to disk and return its location |
| 107 | * |
| 108 | * Requires curl, or allow_url_fopen to be on in php.ini. |
| 109 | * |
| 110 | * @example '/path/to/dir/13b73edae8443990be1aa8f1a483bc27.png' |
| 111 | * |
| 112 | * @return bool|string |
| 113 | */ |
| 114 | public static function image( |
| 115 | $dir = null, |
| 116 | $width = 640, |
| 117 | $height = 480, |
| 118 | $category = null, |
| 119 | $fullPath = true, |
| 120 | $randomize = true, |
| 121 | $word = null, |
| 122 | $gray = false, |
| 123 | $format = 'png' |
| 124 | ) { |
| 125 | trigger_deprecation( |
| 126 | 'fakerphp/faker', |
| 127 | '1.20', |
| 128 | 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead' |
| 129 | ); |
| 130 | |
| 131 | $dir = null === $dir ? sys_get_temp_dir() : $dir; // GNU/Linux / OS X / Windows compatible |
| 132 | // Validate directory path |
| 133 | if (!is_dir($dir) || !is_writable($dir)) { |
| 134 | throw new \InvalidArgumentException(sprintf('Cannot write to directory "%s"', $dir)); |
| 135 | } |
| 136 | |
| 137 | // Generate a random filename. Use the server address so that a file |
| 138 | // generated at the same time on a different server won't have a collision. |
| 139 | $name = md5(uniqid(empty($_SERVER['SERVER_ADDR']) ? '' : $_SERVER['SERVER_ADDR'], true)); |
| 140 | $filename = sprintf('%s.%s', $name, $format); |
| 141 | $filepath = $dir . DIRECTORY_SEPARATOR . $filename; |
| 142 | |
| 143 | $url = static::imageUrl($width, $height, $category, $randomize, $word, $gray, $format); |
| 144 | |
| 145 | // save file |
| 146 | if (function_exists('curl_exec')) { |
| 147 | // use cURL |
| 148 | $fp = fopen($filepath, 'w'); |
| 149 | $ch = curl_init($url); |
| 150 | curl_setopt($ch, CURLOPT_FILE, $fp); |
| 151 | $success = curl_exec($ch) && curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200; |
| 152 | fclose($fp); |
| 153 | curl_close($ch); |
| 154 | |
| 155 | if (!$success) { |
| 156 | unlink($filepath); |
| 157 | |
| 158 | // could not contact the distant URL or HTTP error - fail silently. |
| 159 | return false; |
| 160 | } |
| 161 | } elseif (ini_get('allow_url_fopen')) { |
| 162 | // use remote fopen() via copy() |
| 163 | $success = copy($url, $filepath); |
| 164 | |
| 165 | if (!$success) { |
| 166 | // could not contact the distant URL or HTTP error - fail silently. |
| 167 | return false; |
| 168 | } |
| 169 | } else { |
| 170 | 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()'); |
| 171 | } |
| 172 | |
| 173 | return $fullPath ? $filepath : $filename; |
| 174 | } |
| 175 | |
| 176 | public static function getFormats(): array |
| 177 | { |
| 178 | trigger_deprecation( |
| 179 | 'fakerphp/faker', |
| 180 | '1.20', |
| 181 | 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead' |
| 182 | ); |
| 183 | |
| 184 | return array_keys(static::getFormatConstants()); |
| 185 | } |
| 186 | |
| 187 | public static function getFormatConstants(): array |
| 188 | { |
| 189 | trigger_deprecation( |
| 190 | 'fakerphp/faker', |
| 191 | '1.20', |
| 192 | 'Provider is deprecated and will no longer be available in Faker 2. Please use a custom provider instead' |
| 193 | ); |
| 194 | |
| 195 | return [ |
| 196 | static::FORMAT_JPG => constant('IMAGETYPE_JPEG'), |
| 197 | static::FORMAT_JPEG => constant('IMAGETYPE_JPEG'), |
| 198 | static::FORMAT_PNG => constant('IMAGETYPE_PNG'), |
| 199 | ]; |
| 200 | } |
| 201 | } |
| 202 |