Вложение → фото вещи. */ public static function from_meta( mixed $stored ): array { $links = array(); if ( ! is_array( $stored ) ) { return $links; } foreach ( $stored as $attachment_id => $link ) { $attachment_id = (int) $attachment_id; if ( $attachment_id <= 0 || ! is_array( $link ) || ! is_string( $link['id'] ?? null ) || '' === $link['id'] ) { continue; } $links[ $attachment_id ] = array( 'id' => $link['id'], 'size' => is_int( $link['size'] ?? null ) ? $link['size'] : null, ); } return $links; } /** * Фото вещи из ответа aiModelka в том виде, в каком его получает окно: id, слот и размер * файла. * * Без id или со слотом не из списка спеки ответ окну бесполезен и опасен: занятость слотов * окно ведёт по ответам, и выдуманный слот привёл бы к загрузке поверх фото. * * @param mixed $photo Фото вещи (`SourcePhoto`) из ответа API. * @return array{id: string, slot: string, sizeBytes: int|null}|null Null — ответ не того вида. */ public static function photo_ref( mixed $photo ): ?array { if ( ! is_array( $photo ) || ! is_string( $photo['id'] ?? null ) || '' === $photo['id'] ) { return null; } if ( ! in_array( $photo['slot'] ?? null, self::SLOTS, true ) ) { return null; } return array( 'id' => $photo['id'], 'slot' => $photo['slot'], 'sizeBytes' => is_int( $photo['sizeBytes'] ?? null ) ? $photo['sizeBytes'] : null, ); } /** * Записывает загрузку: вложение → фото вещи, в которое оно легло. * * @param array $links Записи. * @param int $attachment_id Вложение. * @param array{id: string, slot: string, sizeBytes: int|null} $photo Фото вещи из ответа (photo_ref). * @return array Новые записи. */ public static function remember( array $links, int $attachment_id, array $photo ): array { $links[ $attachment_id ] = array( 'id' => $photo['id'], 'size' => $photo['sizeBytes'], ); return $links; } /** * Какие вложения сейчас в съёмке: записи, чьё фото вещи всё ещё в фотосессии и с тем же * файлом. * * Размер сравнивается, только когда известен с обеих сторон: без него отличить замену * нечем, и фото считается тем же. * * @param array $links Записи из меты. * @param array $source_photos Фото вещи фотосессии (`sourcePhotos`). * @return array Вложение → фото вещи сейчас. */ public static function in_session( array $links, array $source_photos ): array { $by_id = array(); foreach ( $source_photos as $photo ) { $ref = self::photo_ref( $photo ); if ( null !== $ref ) { $by_id[ $ref['id'] ] = $ref; } } $alive = array(); foreach ( $links as $attachment_id => $link ) { $ref = $by_id[ $link['id'] ] ?? null; if ( null === $ref ) { continue; } if ( null !== $link['size'] && null !== $ref['sizeBytes'] && $link['size'] !== $ref['sizeBytes'] ) { // Фото вещи то же, а файл в нём другой: человек заменил его в слоте. continue; } $alive[ $attachment_id ] = $ref; } return $alive; } /** * Записи, которые стоит хранить дальше, — только о фото, которые ещё в съёмке. * * @param array $links Записи из меты. * @param array $alive Результат in_session(). * @return array */ public static function only_alive( array $links, array $alive ): array { return array_intersect_key( $links, $alive ); } }