NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #3335 most downloaded on Packagist
Uploadcare PHP integration handles uploads and further operations with files by wrapping Upload and REST APIs.
Latest stable
v4.4.0
Last release 20 days ago
02 Nov 2026
Release timing varies
gaps range from 3 weeks to 1.8 years
Nearly every release is documented
notes for 50 of 52 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
55 releases · first in 2013
Drag across the ruler to compare, or tap a release to open it.
Uploadcare\Api::tags() with getTags, replaceTags and updateTags methods.
Uploadcare\Api::tags() with getTags, replaceTags and updateTags methods.Uploadcare\Interfaces\File\FileInfoInterface::getTags() returns the tags of a file without an additional request.Uploadcare\Api::search() with search and
nextPage methods, and the Uploadcare\Search\SearchQuery builder for search conditions.Uploadcare\Interfaces\File\FileInfoInterface has a new getTags method, and every upload method of
Uploadcare\Interfaces\UploaderInterface has a new trailing array $tags = [] parameter. Custom
implementations of these interfaces must be updated.- Support Guzzle 8 and psr7 3.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Introduce Rector to fix implicitly nullable parameter warnings.
\Uploadcare\Group::getDatetimeStored method is deprecated.
\Uploadcare\Group::getDatetimeStored method is deprecated.Retrieve the Metadata without additional requests when using getMetadata.
getMetadata.getMetadata method from the MetadataApiInterface.via https://github.com/uploadcare/uploadcare-php/pull/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 fr
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.
Uploadcare\Interfaces\UploaderInterface::checkStatus(string $token) now returns Uploadcare\Interfaces\File\FileInfoInterfaceUploadcare\Interfaces\UploaderInterface::syncUploadFromUrl method for synchronically uploading a file from a remote URLUploadcare\Interfaces\UploaderInterface::getSignature method for get signature to use in third-party uploadersUploadcare\Interfaces\Api\GroupApiInterface::storeGroup($id)Uploadcare\Group::store()Method removeKey to remove medatada keys
removeKey to remove medatada keysGroupApiInterface::storeGroup($id) method: see Uploadcare API changelog
GroupApiInterface::storeGroup($id) method: see Uploadcare API changelog$addFields parameter of FileApiInterface::listFiles methodGroupApiInterface::removeGroup($id) method to delete a groupThis release is a result of REST API update to a new version. Read more about it here.
This release is a result of REST API update to a new version. Read more about it here.
FileInfoInterface::getImageInfo(), FileInfoInterface::getVideoInfo(), FileInfoInterface::getRekognitionInfo() — see FileInfoInterface::getContentInfo()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;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 imagecheckAwsRecognition(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operationrequestAntivirusScan($id, bool $purge = false): execute ClamAV virus checking Add-On for a given targetcheckAntivirusScan(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operationrequestRemoveBackground($id, ?RemoveBackgroundRequestInterface $backgroundRequest = null): execute remove.bg background image removal Add-On for a given targetcheckRemoveBackground(string $id): check the status of an Add-On execution request that had been started using the Execute Add-On operationFileInfoInterface::getAppdata(): method returns AppDataInterface with information about addon-applications and associated data:
Allow to use guzzlehttp/psr7:^2.
Allow to use guzzlehttp/psr7:^2.
Added a Y-m-d\THs\Z input date format additionally to the Y-m-d\THs.u\Z.
Added a Y-m-d\TH:i:s\Z input date format additionally to the Y-m-d\TH:i:s.u\Z.
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:
Fix for an issue with the file list pagination:
getPageRequestParameters method: use it to load the next page parameters from $fileListResponse->getNext()/$fileListResponse->getPrevious().FileApiInterface, add public getPageRequestParameters(?string $url): array method to the implementation.Resolved issue with invalid signed urls being generated for image processing (#186).
Resolved issue with invalid signed urls being generated for image processing (#186).
Now you can generate Secure CDN URLs for images with transformations.
Now you can generate Secure CDN URLs for images with transformations.
Fixed file copy methods between default Uploadcare storage and remote storage (Amazon s3)
Fixed file copy methods between default Uploadcare storage and remote storage (Amazon s3)
Serialization for originalFileUrl.
Serialization for originalFileUrl.
Added support for guzzlehttp/guzzle:^7.
Added support for guzzlehttp/guzzle:^7.
Brand new Uploadcare PHP library. It covers 100% of Uploadcare APIs.
Brand new Uploadcare PHP library. It covers 100% of Uploadcare APIs.
Features:
Check out README to learn how to include this PHP library into your project and to explore new usage examples.
File and dependent classes.GuzzleHttp\ClientInterface client
implementation if you want.Support for upload large files with Multipart uploader
### Added - Support for signed uploads.
Allow to specify filename for local uploads
createRemoteCopy method in API.php.
As result is always casted to string, the return type should be string$api->getUserAgent() was deprecated and will be removed in next major version. Use $api->getUserAgentHeader() instead.
$api->getUserAgent() was deprecated and will be removed in next major version. Use $api->getUserAgentHeader() instead.Allow a user to specify User Agent
$api->getUserAgent() replaced with $api->getUserAgentHeader()$api->getGroupList($options = array()) method$api->getUserAgent() replaced with $api->getUserAgentHeader()$api->getGroupList($options = array()) methodadd __isset() to classes that have __get() that fixes class behaviours in PHP 7.0.6+ (see error description)
__isset() to classes that have __get() that fixes class behaviours in PHP 7.0.6+ (see error description)- fix File->op()
File->op()change File->crop() and File->scaleCrop() behaviou, now they throw exceptions if parameters $width or $height are 0 or not provided
File->crop() and File->scaleCrop() behaviou, now they throw exceptions if parameters $width or $height are 0 or not providedFile->getPath() methodApi->createRemoteCopy() default behaviourchange the signature of Uploader->fromUrl(), old signature is deprecated but will work until 3.0
Api->storeMultipleFiles() and Api->deleteMultipleFiles()Api->createLocalCopy() and Api->createRemoteCopy()Helper->deprecate() methodUploader->fromUrl(), old signature is deprecated but will work until 3.0File->copy() and File->copyTo()Api->copyFile()Nothing published for this version
bump widget version to 2.9.0 (see widget changelog)
fix: File in a Group is not loosing default effects (cropping etc.)
bump widget version to 2.8.2 (see widget changelog)
fix of throttled request exception
add throttled requests handling
upgrade server api usage to v0.4, add new style pagination support
change logic of Api->getGroupList() and Api->__getPath()
use proper authentication instead of simple
- fix Group->getFiles()
Group->getFiles()- add Uploader->createGroup() - add Group->updateInfo() - add Group API tests
bump widget version to 2.3.5 (see widget changelog)
Group->store()IMPORTANT: backward incompatible changes in widget behavior introduced in 2.0.0, please read changelog entry carefully
bump widget version to 1.4.6 (see widget changelog)
bump widget version to 1.4.2 (see widget changelog)
update widget version to 1.2.0 (Flickr support) (see widget changelog)
be more explicit on cURL errors
fix sample-project composer file
$async argument to Widget->getScriptTag()update widget version to 1.0.1 (see widget changelog)
Allow changing default CDN host.
move lib code from uploadcare/lib/5.x/ to src/Uploadcare
uploadcare/lib/5.x/ to src/UploadcareThis is last uploadcare-php version that will support php 5.2. Expect no features added, only bugs fixed.
This is last uploadcare-php version that will support php 5.2. Expect no features added, only bugs fixed.
bump widget version to 0.17.2 (see widget changelog)
support 'limit' param in Api->getFileList() and Api->getFilePaginationInfo()
bump widget version to 0.17.1 (see widget changelog)
use http://www.ucarecdn.com as cdn base
Nothing published for this version
Nothing published for this version
One column per quarter.