uploadcare/uploadcare-php

• Introduce Rector to fix implicitly nullable parameter warnings.
• Thanks to @kayw-geek for the contribution.

• Added multi-page document conversion.
• Added unsafe content detection.
• \Uploadcare\Group::getDatetimeStored method is deprecated.
• Improved date conversion (thanks to @pestaa).

• Retrieve the Metadata without additional requests when using getMetadata.
• You can still get the fresh metadata for the file by calling getMetadata method from the MetadataApiInterface.

via #204

We've added a method to pass generated secure signature (e.g. to the file uploader) and updated fromUrl method to allow synchronically upload files from remote URLs.

Breaking change

• Uploadcare\Interfaces\UploaderInterface::checkStatus(string $token) now returns Uploadcare\Interfaces\File\FileInfoInterface

Added

• Uploadcare\Interfaces\UploaderInterface::syncUploadFromUrl method for synchronically uploading a file from a remote URL
• Uploadcare\Interfaces\UploaderInterface::getSignature method for get signature to use in third-party uploaders

Removed

• Uploadcare\Interfaces\Api\GroupApiInterface::storeGroup($id)
• Uploadcare\Group::store()

Added

• Method removeKey to remove medatada keys
• Samples for all API requests

Removed

• GroupApiInterface::storeGroup($id) method: see Uploadcare API changelog

Deprecated

• The $addFields parameter of FileApiInterface::listFiles method

Added

• GroupApiInterface::removeGroup($id) method to delete a group

This release is a result of REST API update to a new version. Read more about it here.

Removed

• PHP 7.1 support (now minimal version is 7.4, PHP 8.0 is also supported)
• FileInfoInterface::getImageInfo(), FileInfoInterface::getVideoInfo(), FileInfoInterface::getRekognitionInfo() — see FileInfoInterface::getContentInfo()

Added

• Support for REST API 0.7
• FileInfoInterface::getContentInfo(): returns ContentInfoInterface with getMime() (information about MimeType), getImage (ImageInfoInterface in case of an image) and getVideo (VideoInfoInterface in case of a video) methods;
• FileInfoInterface::getMetadata() method returns file associated metadata array-accessible object;
• Addons (AddonsApiInterface): execute and check status of an add-on application:
  • requestAwsRecognition($id): execute AWS Rekognition Add-On for a given target to detect labels in an image
  • checkAwsRecognition(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operation
  • requestAntivirusScan($id, bool $purge = false): execute ClamAV virus checking Add-On for a given target
  • checkAntivirusScan(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operation
  • requestRemoveBackground($id, ?RemoveBackgroundRequestInterface $backgroundRequest = null): execute remove.bg background image removal Add-On for a given target
  • checkRemoveBackground(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operation
• Application data FileInfoInterface::getAppdata(): method returns AppDataInterface with information about addon-applications and associated data:
  • AwsRecognitionLabelsInterface: information from previously executed requestAwsRecognition of image;
  • ClamAvVirusScanInterface: information from ClamAV antivirus scan
  • RemoveBgInterface: data from previously executed requestRemoveBackground remove.bg addon

Allow to use guzzlehttp/psr7:^2.

Added a Y-m-d\TH:i:s\Z input date format additionally to the Y-m-d\TH:i:s.u\Z.

Fix for an issue with the file list pagination:

• Added getPageRequestParameters method: use it to load the next page parameters from $fileListResponse->getNext()/$fileListResponse->getPrevious().
• Attention: if you've implemented your own class for FileApiInterface, add public getPageRequestParameters(?string $url): array method to the implementation.

Added

• Support for multipart uploads

Added

• Support for signed uploads

Added

• Allow to specify filename for local uploads
• Allow to control "autostore" for local uploads

Fixed

• Wrong return type for createRemoteCopy method in API.php. As result is always casted to string, the return type should be string

Deprecated

• $api->getUserAgent() was deprecated and will be removed in next major version. Use $api->getUserAgentHeader() instead.

Added

• Allow user to specify User Agent
• User agent reporting for the lib and integrations that use it
• data-integration attribute to the widget

Changed

• User agent now is reporting in new format by default
• $api->getUserAgent() replaced with $api->getUserAgentHeader()

Fixed

• $api->getGroupList($options = array()) method
• Some mistakes in description of methods
• Hitting max throttling attempts if request was successful