uploadcare/uploadcare-php

• 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.

Secure delivery image processing fix

• Resolved issue with invalid signed urls being generated for image transformations.

Secure CDN URLs for transformed images

• Now you can generate Secure CDN URLs for images with transformations.

Fix

• Fixed file copy methods between default Uploadcare storage and remote storage (Amazon s3).

Fix

• Serialization for originalFileUrl.

Fix

• Added support for guzzlehttp/guzzle:^7.

BREAKING CHANGES

• You must update PHP to 5.6 or a newer version.
• This completely new version is not backward compatibile with the previous one!

Features

• Add interfaces for all File and dependent classes.
• Add Guzzle http client as standard client. You can override client with any GuzzleHttp\ClientInterface client implementation if you want.
• Full REST and Upload APIs coverage.

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

• add __isset() to classes that have __get() that fixes class behaviours in PHP 7.0.6+ see error description

• fix File->op()

• change File->crop() and File->scaleCrop() behaviou, now they throw exceptions if parameters $width or $height are 0 or not provided
• add File->getPath() method
• fix Api->createRemoteCopy() default behaviour

• use latest stable build of version 3 (see [widget changelog][widget changelog])
• use REST API version 0.5
• update pagination functions for files and groups
• add batch files methods: Api->storeMultipleFiles() and Api->deleteMultipleFiles()
• add new copy methods: Api->createLocalCopy() and Api->createRemoteCopy()
• add Helper->deprecate() method
• change the signature of Uploader->fromUrl(), old signature is deprecated but will work until 3.0
• deprecate File->copy() and File->copyTo()
• deprecate Api->copyFile()

• bump widget version to 2.9.0 (see [widget changelog][widget changelog])
• add optional "full" argument to Widget->getScriptTag

• fix: File in a Group is not loosing default effects (cropping etc.)

• bump widget version to 2.8.2 (see [widget changelog][widget changelog])

• fix of throttled request exception (thanks to Alexey Scherbakov, https://github.com/lexabug)
• fix of pagination logic

• add throttled requests handling
• add customizable User Agent string
• fix upload from url logical bug
• bump widget to 2.5.9 (see [widget changelog][widget changelog])

• upgrade server api usage to v0.4, add new style pagination support
• add FileIterator
• change logic of Api->getFileList(): it returns FileIterator object instead of array and incoming parameters are now grouped in an array
• remove Api->getFilePaginationInfo()

• change logic of Api->getGroupList() and Api->__getPath()
• fix #41
• bump widget version to 2.5.1 (see [widget changelog][widget changelog])

• use proper authentication instead of simple
• bump widget version to 2.5.0 (see [widget changelog][widget changelog])

• fix Group->getFiles()

• add Uploader->createGroup()
• add Group->updateInfo()
• add Group API tests

• fix Group->store()
• bump widget version to 2.3.5 (see [widget changelog][widget changelog])

• IMPORTANT: backward incompatible changes in widget behavior introduced in 2.0.0, please read changelog entry carefully
• bump widget version to 2.3.4 (see [widget changelog][widget changelog])
• allow CDN URLs in Group constructor

• bump widget version to 1.4.6 (see [widget changelog][widget changelog])
• fix Api->copyFile() when copying to custom storage
• add File->copyTo() shortcut

• bump widget version to 1.4.2 (see [widget changelog][widget changelog])
• add AUTHORS.txt

• bump widget version to 1.2.0 (see [widget changelog][widget changelog])

• be more explicit on cURL errors

• fix sample-project composer file
• always write widget's charset
• default to sync widget load
• add optional $async argument to Widget->getScriptTag()

• bump widget version to 1.0.1 (see [widget changelog][widget changelog])

• allow setting custom CDN host

• accept CDN URL in File's constructor
• bump widget version to 0.18.3 (see [widget changelog][widget changelog])

This is last uploadcare-php version that will support php 5.2. Expect no features added, only bugs fixed.

• bump widget version to 0.18.1 (see [widget changelog][widget changelog])

• fix file copy request
• bump widget version to 0.17.2 (see [widget changelog][widget changelog])

• support limit param in Api->getFileList() and Api->getFilePaginationInfo()

• bump widget version to 0.17.1 (see [widget changelog][widget changelog])
• fix HEAD requests
• allow custom User Agent
• prepopulate File with data on Api->getFileList()
• add Groups API
• add File->copy()