Upgrading

Upgrading to Files.com PHP SDK 2.0? Learn about namespace changes for exception classes to comply with PSR-4 and PSR-12 standards.

In Version 2.0, the Files.com PHP SDK was updated to comply with both the PSR-12 coding standard and the PSR-4 autoloading standard. No new classes were added or any existing classes removed, but some were moved to comply with the PSR-4 standard. If a client of the sdk references the moved classes, the client code will need to be updated to reference the new location of these classes.

Exception Classes

The affected classes were primarily Exception classes. Exceptions were moved into their own namespace (and source files).

The following table shows the classes that were changed for compliance

Base Exceptions

The Base exception were moved from the \Files namespace to the \Files\Exception namespace.

Examples of Base Exceptions Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\ApiExceptionFiles\Exception\ApiException
\Files\FilesExceptionFiles\Exception\FilesException
\Files\ConfigurationExceptionFiles\Exception\ConfigurationException

BadRequest Exceptions

The BadRequest group of exceptions were moved from the \Files\BadRequest namespace to the \Files\Exception\BadRequest namespace.

Example of BadRequest Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\BadRequest\AgentUpgradeRequiredExceptionFiles\Exception\BadRequest\AgentUpgradeRequiredException

NotAuthenticated Exceptions

The NotAuthenticated group of exceptions were moved from the \Files\NotAuthenticated namespace to the \Files\Exception\NotAuthenticated namespace.

Example of NotAuthenticated Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\NotAuthenticated\AdditionalAuthenticationRequiredExceptionFiles\Exception\NotAuthenticated\AdditionalAuthenticationRequiredException

NotAuthorized Exceptions

The NotAuthorized group of exceptions were moved from the \Files\NotAuthorized namespace to the \Files\Exception\NotAuthorized namespace.

Example of NotAuthorized Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\NotAuthorized\ApiKeyIsDisabledExceptionFiles\Exception\NotAuthorized\ApiKeyIsDisabledException

NotFound Exceptions

The NotFound group of exceptions were moved from the \Files\NotFound namespace to the \Files\Exception\NotFound namespace.

Example of NotFound Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\NotFound\ApiKeyNotFoundExceptionFiles\Exception\NotFound\ApiKeyNotFoundException

ProcessingFailure Exceptions

The ProcessingFailure group of exceptions were moved from the \Files\ProcessingFailure namespace to the \Files\Exception\ProcessingFailure namespace.

Example of ProcessingFailure Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\ProcessingFailure\AlreadyCompletedExceptionFiles\Exception\ProcessingFailure\AlreadyCompletedException

RateLimited Exceptions

The ProcessingFailure group of exceptions were moved from the \Files\RateLimited namespace to the \Files\Exception\RateLimited namespace.

Example of RateLimited Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\RateLimited\DuplicateShareRecipientExceptionFiles\Exception\RateLimited\DuplicateShareRecipientException

ServiceUnavailable Exceptions

The ServiceUnavailable group of exceptions were moved from the \Files\ServiceUnavailable namespace to the \Files\Exception\ServiceUnavailable namespace.

Example of ServiceUnavailable Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\ServiceUnavailable\AgentUnavailableExceptionFiles\Exception\ServiceUnavailable\AgentUnavailableException

SiteConfiguration Exceptions

The SiteConfiguration group of exceptions were moved from the \Files\SiteConfiguration namespace to the \Files\Exception\SiteConfiguration namespace.

Example of SiteConfiguration Classes moved.

SDK < 2.0 Class LocationSDK >= 2.0 Class Location
\Files\SiteConfiguration\AccountAlreadyExistsExceptionFiles\Exception\SiteConfiguration\AccountAlreadyExistsException