KinopoiskDev PHP Wrapper v1.0.0

composer require devcraftclub/kinopoisk-dev-php

<?php

use KinopoiskDev\Http\MovieRequests;
use KinopoiskDev\Filter\MovieSearchFilter;

// Создание клиента
$request = new MovieRequests(apiToken: 'your-api-token');

// Поиск фильмов с расширенными фильтрами
$filter = new MovieSearchFilter();
$filter->withYearBetween(2020, 2024)
       ->withMinRating(7.0, 'kp')
       ->withAllGenres(['драма', 'комедия'])
       ->onlyMovies();

$movies = $request->searchMovies($filter);

// Получение информации о фильме
$movie = $request->getMovieById(301);
echo $movie->name; // "Матрица"

KinopoiskDev/
├── Attributes/          # PHP 8.3+ атрибуты
├── Contracts/           # Интерфейсы (PSR-3, кэширование)
├── Enums/              # Перечисления
├── Exceptions/         # Специализированные исключения
├── Filter/             # Классы фильтров
├── Http/               # HTTP запросы
├── Models/             # Модели данных
├── Responses/          # Ответы API
├── Services/           # Сервисы
└── Utils/              # Утилиты

$filter = new MovieSearchFilter();
$filter->withYearBetween(2020, 2024)
       ->withMinRating(7.0, 'kp')
       ->withAllGenres(['драма', 'комедия'])
       ->onlyMovies()
       ->inTop250();

$movies = $kinopoisk->searchMovies($filter);

$filter = new PersonSearchFilter();
$filter->onlyActors()
       ->ageRange(30, 50)
       ->withMinRating(7.0, 'kp');

$persons = $kinopoisk->searchPersons($filter);

$filter = new ImageSearchFilter();
$filter->onlyPosters()
       ->minResolution(1920, 1080)
       ->onlyHighRes();

$images = $kinopoisk->getMovieImages(301, $filter);

class Movie {
    #[Validation(required: true, minLength: 1, maxLength: 255)]
    public string $title;

    #[Validation(min: 1900, max: 2030)]
    public int $year;

    #[Sensitive(hideInJson: true)]
    public string $apiToken;
}