You can obtain bucket metadata using the TosClient->headBucket API. This API also allows you to verify whether a bucket exists. Sample code is as follows:

<?php​
​
require_once __DIR__ . '/vendor/autoload.php';​
​
use Tos\TosClient;​
use Tos\Exception\TosClientException;​
use Tos\Exception\TosServerException;​
use Tos\Model\HeadBucketInput;​
​
try {​
    $client = new TosClient([​
        'region' => 'your region',​
        'endpoint' => 'your endpoint',​
        'ak' => getenv('TOS_ACCESS_KEY'),​
        'sk' => getenv('TOS_SECRET_KEY'),​
    ]);​
       ​
    $input = new HeadBucketInput('bucket-test');​
    $output = $client->headBucket($input);​
​
    echo $output->getRequestId() . PHP_EOL;​
    echo $output->getRegion() . PHP_EOL;​
    echo $output->getStorageClass() . PHP_EOL;​
    echo $output->getAzRedundancyType() . PHP_EOL;​
} catch (TosClientException $ex) {​
    echo $ex->getMessage() . PHP_EOL;​
} catch (TosServerException $ex) {​
    if($ex->getStatusCode() === 404){​
        echo 'bucket does not exist' . PHP_EOL;​
    }​
    echo $ex->getRequestId() . PHP_EOL;​
    echo $ex->getStatusCode() . PHP_EOL;​
}​

Last updated: 2025.09.23 14:41:21

Public security network record in Beijing: No. 11010802032137