Tous les produits
Search
Centre de documentation

Object Storage Service:Exception handling (PHP SDK V1)

Dernière mise à jour :Aug 18, 2026

Le SDK PHP OSS lève une exception OssException en cas d'erreur, par exemple si les paramètres sont invalides ou si le fichier n'existe pas. Utilisez la méthode getMessage pour récupérer le message d'erreur.

Pour plus d'informations sur OssException, consultez GitHub.

Exemple de gestion des exceptions

L'exemple de code suivant montre comment gérer l'exception levée lors de la création d'un bucket déjà existant. Le code affiche le message d'erreur.

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

Vous pouvez également obtenir les informations suivantes :

Paramètre

Description

HTTPStatus

Code d'état HTTP. Appelez la méthode getHTTPStatus pour obtenir cette valeur.

ErrorCode

Code d'erreur renvoyé par OSS. Appelez la méthode getErrorCode pour obtenir cette valeur.

ErrorMessage

Message d'erreur renvoyé par OSS. Appelez la méthode getErrorMessage pour obtenir cette valeur.

RequestId

Identifiant universel unique (UUID) de la requête. Si vous ne parvenez pas à résoudre un problème, communiquez ce RequestId à un développeur OSS pour obtenir de l'aide. Appelez la méthode getRequestId pour obtenir cette valeur.

Details

Description détaillée du message d'erreur renvoyé par OSS. Appelez la méthode getDetails pour obtenir cette valeur.

Codes d'erreur OSS courants

Code d'erreur

Description

Code d'état HTTP

AccessDenied

Accès refusé.

403

BucketAlreadyExists

Le bucket existe déjà.

409

BucketNotEmpty

Le bucket n'est pas vide.

409

EntityTooLarge

L'entité est trop volumineuse.

400

EntityTooSmall

L'entité est trop petite.

400

FileGroupTooLarge

Le groupe de fichiers est trop volumineux.

400

FilePartNotExist

La partie du fichier n'existe pas.

400

FilePartStale

La partie du fichier est obsolète.

400

InvalidArgument

Le format du paramètre est incorrect.

400

InvalidAccessKeyId

L'ID AccessKey n'existe pas.

403

InvalidBucketName

Le nom du bucket est incorrect.

400

InvalidDigest

Le condensé est incorrect.

400

InvalidObjectName

Le nom de l'objet est incorrect.

400

InvalidPart

La partie est incorrecte.

400

InvalidPartOrder

L'ordre des parties est incorrect.

400

InvalidTargetBucketForLogging

Le bucket cible pour l'opération de journalisation est incorrect.

400

InternalError

Une erreur interne s'est produite dans OSS.

500

MalformedXML

Le format XML est incorrect.

400

MethodNotAllowed

La méthode n'est pas prise en charge.

405

MissingArgument

Un paramètre est manquant.

411

MissingContentLength

La longueur du contenu est manquante.

411

NoSuchBucket

Le bucket n'existe pas.

404

NoSuchKey

L'objet n'existe pas.

404

NoSuchUpload

L'ID de téléchargement multipartie n'existe pas.

404

NotImplemented

La méthode ne peut pas être traitée.

501

PreconditionFailed

Une erreur de prétraitement s'est produite.

412

RequestTimeTooSkewed

La différence entre l'heure du client et l'heure du serveur OSS est supérieure à 15 minutes.

403

RequestTimeout

La requête a expiré.

400

SignatureDoesNotMatch

La signature est incorrecte.

403

InvalidEncryptionAlgorithmError

L'algorithme de chiffrement spécifié est incorrect.

400