PHPackages                             yandex/fotki - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. yandex/fotki

ActiveLibrary[API Development](/categories/api)

yandex/fotki
============

PHP-library for interactions with Yandex.Fotki / PHP реализация API для работы с сервисом Яндекс.Фотки

v0.4.2(12y ago)189510[2 issues](https://github.com/yandex-php/php-yandex-fotki/issues)[1 PRs](https://github.com/yandex-php/php-yandex-fotki/pulls)The MIT License (MIT)PHPPHP &gt;=5.3.0

Since Nov 15Pushed 8y ago4 watchersCompare

[ Source](https://github.com/yandex-php/php-yandex-fotki)[ Packagist](https://packagist.org/packages/yandex/fotki)[ RSS](/packages/yandex-fotki/feed)WikiDiscussions master Synced today

READMEChangelog (4)DependenciesVersions (5)Used By (0)

API для работы с сервисом Яндекс.Фотки
======================================

[](#api-для-работы-с-сервисом-яндексфотки)

Функционал
----------

[](#функционал)

- [Получение Fimp-токена](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-Fimp-%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D0%B0) по логину/паролю
- [Получение OAuth-токена](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-OAuth-%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%D0%B0)
- [Получение сервисного документа](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D1%81%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BD%D0%BE%D0%B3%D0%BE-%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0)
- Загрузка изображения [-&gt;](http://api.yandex.ru/fotki/doc/concepts/add-photo.xml)
- [Постраничная выдача коллекций](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D1%81%D1%82%D1%80%D0%B0%D0%BD%D0%B8%D1%87%D0%BD%D0%B0%D1%8F-%D0%B2%D1%8B%D0%B4%D0%B0%D1%87%D0%B0-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B9)
- [Получение данных альбома](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B0%D0%BB%D1%8C%D0%B1%D0%BE%D0%BC%D0%B0)
- Добавление нового альбома [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/albums-create.xml)
- Редактирование альбома [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/album-edit.xml)
- Удаление альбома [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/album-delete.xml)
- [Получение данных фотографии](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%B8)
- Редактирование фотографии [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/photo-edit.xml)
- Удаление фотографии [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/photo-delete.xml)
- [Получение данных тега](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D1%82%D0%B5%D0%B3%D0%B0)
- Добавление тега [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/add-tag.xml)
- Редактирование тега [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/edit-tag.xml)
- Удаление тега [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/delete-tag.xml)
- [Получение данных коллекции альбомов](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8-%D0%B0%D0%BB%D1%8C%D0%B1%D0%BE%D0%BC%D0%BE%D0%B2)
- Добавление нового альбома [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/albums-collection-create.xml)
- [Получение данных коллекции фотографий альбома](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8-%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%B9-%D0%B0%D0%BB%D1%8C%D0%B1%D0%BE%D0%BC%D0%B0)
- Загрузка изображения в альбом [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/album-photos-collection-add.xml)
- [Получение данных общей коллекции фотографий](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BE%D0%B1%D1%89%D0%B5%D0%B9-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8-%D1%84%D0%BE%D1%82%D0%BE%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%B9)
- Загрузка изображения в общую коллекцию фотографий [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/all-photos-collection-add.xml)
- [Получение данных коллекции тегов](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8-%D1%82%D0%B5%D0%B3%D0%BE%D0%B2)
- [Получение данных коллекции фоторафий тега](https://github.com/dmkuznetsov/php-yandex-fotki/wiki/%D0%9F%D0%BE%D0%BB%D1%83%D1%87%D0%B5%D0%BD%D0%B8%D0%B5-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B8-%D1%84%D0%BE%D1%82%D0%BE%D1%80%D0%B0%D1%84%D0%B8%D0%B9-%D1%82%D0%B5%D0%B3%D0%B0)
- Получение коллекции новых интересных фотографий [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/interesting-photos-get.xml)
- Получение коллекции популярных фотографий [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/top-photos-get.xml)
- Получение коллекции "Фото дня" [-&gt;](http://api.yandex.ru/fotki/doc/operations-ref/day-photos-get.xml)

Примеры
-------

[](#примеры)

```
$api = new \Yandex\Fotki\Api($login);

// Загрузка сервисного документа, в котором ссылки на коллекции
// пункт необязательный, но в Яндексе написано, что ссылки могут
// когда-нибудь измениться
$api->loadServiceDocument()

// Аутентификация
// Принимает пароль от аккаунта или fimp-token
// Внимание! При получении Fimp-токена - Яндекс часто отвечает 502 ошибкой
try {
    $api->auth($passwordOrToken);
} catch(\Yandex\Fotki\Exception\ServerError $ex) {
    // Яндекс ответил 502. Повторите попытку снова. Как правило, раза с 5 удается получить токен
} catch(\Yandex\Fotki\Exception\Api\Auth $ex) {
    // Что-то с самой авторизацией (см. $ex->getMessage())
}

// Сохраните токен куда-нибудь. По документации - время жизни токена неограничено
$token = $api->getAuth()->getToken();

// Получение коллекции альбомов
$collection = $api->getAlbumsCollection()
    ->setLimit(5) // лимит на загрузку 5 альбомов
    ->load();
$collection->getList();

// Загрузка всей коллекции
$collection = $api->getAlbumsCollection()->loadAll();

// Постраничная загрузка коллекции
try {
    $collection = $api->getAlbumsCollection()->load()->next()->next()->next();
} catch(\Yandex\Fotki\Exception\Api\StopIteration $ex) {
    // Окончание постраничной навигации
}

// Список альбомов в коллекции
$albums = $collection->getList();

$album = null;
// Проходимся по альбомам коллекции (берем первый попавшийся)
foreach($albums as $id => $item) {
    $album = $item;
    break;
}

// Работа с альбомом - это работа с коллекцией фотографий
// и мета-информацией об альбоме.
// Загружаем все фотки альбома
$photos = $album->loadAll()->getList();
```

По всему коду прописаны php-doc комментарии, поэтому в IDE должны быть нормальные подсказки по методам у объектов.

### Кэширование

[](#кэширование)

Для объектов API реализован интерфейс Serializable, что позволит вам сохранять полученные объекты в текстовом представлении.

```
$api = new \Yandex\Fotki\Api($login);
$api->auth($token);

// Загружаем все альбомы в коллекцию
$collection = $api->getAlbumsCollection()->loadAll();

// Сериализуем коллекцию (и можем сохранить в кэш, например)
echo serialize($collection);
```

### Загрузка фото

[](#загрузка-фото)

```
$api = new \Yandex\Fotki\Api($login);
$api->oauth($token);

// Получаем путь к картинке на сервере.
$imgPath = 'path_to_photo.png';

try {
    // Попробуем загрузить картинку на Яндекс.Фотки
    // Вторым параметром можно (не обязательно) указать id фотоальбома, в который должна попасть фотка
    $arPhoto = $api->sendPhoto(array('image'=> '@'. $imgPath,'access' => 'public'), 479011);
} catch (\Yandex\Fotki\Exception\Api $ex) {
}
// Посмотрим что получилось.
print_r($arPhoto);
```

###  Health Score

29

↑

LowBetter than 60% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

4558d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/81781c2d19f41ae031eded90a80fab0b4cc0ddbe825651d5eb77ad2983447c62?d=identicon)[dmkuznetsov](/maintainers/dmkuznetsov)

---

Top Contributors

[![pafnuty](https://avatars.githubusercontent.com/u/1635679?v=4)](https://github.com/pafnuty "pafnuty (4 commits)")[![romka-chev](https://avatars.githubusercontent.com/u/5673136?v=4)](https://github.com/romka-chev "romka-chev (3 commits)")[![dmkuznetsov](https://avatars.githubusercontent.com/u/223224016?v=4)](https://github.com/dmkuznetsov "dmkuznetsov (2 commits)")

---

Tags

apiyandexfotki

### Embed Badge

![Health badge](/badges/yandex-fotki/health.svg)

```
[![Health](https://phpackages.com/badges/yandex-fotki/health.svg)](https://phpackages.com/packages/yandex-fotki)
```

###  Alternatives

[yandex/geo

PHP-library for interactions with geo-coding Yandex.Maps

117309.0k3](/packages/yandex-geo)[hardworm/webmaster.api

Yandex Webmaster Api v4.1 library

109.7k](/packages/hardworm-webmasterapi)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
