1665b9180a
Unsplash provider (Search, Photo, Collection, Download, Exception, Jobs) with Core\Plug\Stock namespace alignment. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
83 lines
2.1 KiB
PHP
83 lines
2.1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Plug\Stock\Unsplash;
|
|
|
|
use Core\Plug\Concern\BuildsResponse;
|
|
use Core\Plug\Concern\UsesHttp;
|
|
use Core\Plug\Response;
|
|
use Illuminate\Support\Arr;
|
|
|
|
/**
|
|
* Search Unsplash photos.
|
|
*
|
|
* Usage:
|
|
* $results = (new Search())->query('social media');
|
|
* $results = (new Search())->query('', page: 2); // random photos
|
|
*/
|
|
class Search
|
|
{
|
|
use BuildsResponse;
|
|
use UsesHttp;
|
|
|
|
protected string $endpointUrl = 'https://api.unsplash.com';
|
|
|
|
protected string $clientId;
|
|
|
|
/**
|
|
* Default search terms for random photos when no query is provided.
|
|
*/
|
|
protected array $defaultSearchTerms = [
|
|
'social',
|
|
'content',
|
|
'marketing',
|
|
'business',
|
|
'technology',
|
|
'creative',
|
|
'lifestyle',
|
|
'professional',
|
|
'minimal',
|
|
'modern',
|
|
];
|
|
|
|
public function __construct()
|
|
{
|
|
$this->clientId = config('services.unsplash.client_id', '');
|
|
|
|
if (empty($this->clientId)) {
|
|
throw Exception::notConfigured();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Search for photos.
|
|
*
|
|
* @param string $query Search query (uses random term if empty)
|
|
* @param int $page Page number
|
|
* @param int $perPage Results per page (max 30)
|
|
*/
|
|
public function query(string $query = '', int $page = 1, int $perPage = 30): Response
|
|
{
|
|
$searchQuery = ! empty($query)
|
|
? $query
|
|
: Arr::random($this->defaultSearchTerms);
|
|
|
|
$response = $this->http()->get("{$this->endpointUrl}/search/photos", [
|
|
'client_id' => $this->clientId,
|
|
'query' => $searchQuery,
|
|
'page' => $page,
|
|
'per_page' => min($perPage, 30),
|
|
]);
|
|
|
|
return $this->fromHttp($response, function (array $data) {
|
|
$results = $data['results'] ?? [];
|
|
|
|
return [
|
|
'photos' => array_map([Photo::class, 'transform'], $results),
|
|
'total' => $data['total'] ?? 0,
|
|
'total_pages' => $data['total_pages'] ?? 0,
|
|
];
|
|
});
|
|
}
|
|
}
|