OSS PHP SDK exceptions (OssException) include various errors, such as invalid parameters and file missing. You can use the getMessage method to obtain error messages.

For more information about OssException, see GitHub.

Example for handling exceptions

The following code shows how to handle exceptions when creating a existing bucket and prints error messages.

    try {
    } catch (OssException $e) {
		print("Exception:" . $e->getMessage() . "\n");

You can also obtain the following information:

Parameter Description
HTTPStatus HTTP status code. You can get the status code using the getHTTPStatus method.
ErrorCode Specifies the error code returned by OSS. You can get the error code using the getErrorCode method.
ErrorMessage Specifies the error messages returned by OSS. You can get the error messages using the getErrorMessage method.
RequestId Specifies the UUID. It is unique and used to identify a request. If a problem persists, send the RequestId to OSS developers for help. You can get the RequestId using the getRequestId method.
Details Specifies detailed error messages returned by OSS. You can get the detailed error messages using the getDetails method.

Common OSS error codes

Error code Description HTTP status code
AccessDenied Access denied 403
BucketAlreadyExists The bucket already exists. 409
BucketNotEmpty The bucket is not empty. 409
EntityTooLarge The entity size exceeds the maximum limit. 400
EntityTooSmall The entity size is below the minimum limit. 400
FileGroupTooLarge The total file group size exceeds the maximum limit. 400
FilePartNotExist No such part exists. 400
FilePartStale The part has expired. 400
InvalidArgument The parameter format is invalid. 400
InvalidAccessKeyId No such AccessKeyId exists. 403
InvalidBucketName The bucket name is invalid. 400
InvalidDigest The digest is invalid. 400
InvalidObjectName The object name is invalid. 400
InvalidPart The part is invalid. 400
InvalidPartOrder The part order is invalid. 400
InvalidTargetBucketForLogging The buckets that store log files are invalid. 400
InternalError Internal OSS error 500
MalformedXML The XML format is invalid. 400
MethodNotAllowed The method is not allowed. 405
MissingArgument Parameters are not configured. 411
MissingContentLength The content length is not configured. 411
NoSuchBucket No such bucket exists. 404
NoSuchKey  No such object exists. 404
NoSuchUpload No such uploadId exists. 404
NotImplemented The methods are not implemented. 501
PreconditionFailed Precondition error 412
RequestTimeTooSkewed The local time set for OSSClient is deviated from the time set for the OSS server by over 15 minutes. 403
RequestTimeout Request timeout 400
SignatureDoesNotMatch Signature mismatch 403
InvalidEncryptionAlgorithmError The specified encryption algorithm (the entropy encoding type) is invalid. 400