# PHP

Use Tigris with PHP through the [AWS SDK for PHP](https://aws.amazon.com/sdk-for-php/). The SDK works with Tigris by changing the endpoint configuration.

For the full SDK reference, see the [AWS PHP SDK guide](/docs/sdks/s3/aws-php-sdk/.md).

## Prerequisites[​](#prerequisites "Direct link to Prerequisites")

* PHP 8.1+
* Composer
* A Tigris account — create one at [storage.new](https://storage.new)
* An access key from [console.storage.dev/createaccesskey](https://console.storage.dev/createaccesskey)

## Install[​](#install "Direct link to Install")

```
composer require aws/aws-sdk-php
```

## Configure credentials[​](#configure-credentials "Direct link to Configure credentials")

Set your Tigris credentials as environment variables:

```
export AWS_ACCESS_KEY_ID="tid_your_access_key"

export AWS_SECRET_ACCESS_KEY="tsec_your_secret_key"
```

## Create a client[​](#create-a-client "Direct link to Create a client")

```
<?php

require 'vendor/autoload.php';



use Aws\S3\S3Client;



$s3 = new S3Client([

    'region' => 'auto',

    'endpoint' => 'https://t3.storage.dev',

    'version' => 'latest',

]);
```

The client reads credentials from the `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` environment variables automatically.

## Basic operations[​](#basic-operations "Direct link to Basic operations")

### List buckets[​](#list-buckets "Direct link to List buckets")

```
$result = $s3->listBuckets();



foreach ($result['Buckets'] as $bucket) {

    echo $bucket['Name'] . "\n";

}
```

### Upload an object[​](#upload-an-object "Direct link to Upload an object")

```
$s3->putObject([

    'Bucket' => 'my-bucket',

    'Key' => 'hello.txt',

    'Body' => 'Hello, World!',

]);
```

### Download an object[​](#download-an-object "Direct link to Download an object")

```
$result = $s3->getObject([

    'Bucket' => 'my-bucket',

    'Key' => 'hello.txt',

]);



echo $result['Body'] . "\n";
```

### List objects[​](#list-objects "Direct link to List objects")

```
$result = $s3->listObjectsV2([

    'Bucket' => 'my-bucket',

]);



foreach ($result['Contents'] ?? [] as $object) {

    echo "  {$object['Key']}  ({$object['Size']} bytes)\n";

}
```

### Generate a presigned URL[​](#generate-a-presigned-url "Direct link to Generate a presigned URL")

```
$command = $s3->getCommand('GetObject', [

    'Bucket' => 'my-bucket',

    'Key' => 'hello.txt',

]);



$request = $s3->createPresignedRequest($command, '+60 minutes');

echo (string) $request->getUri() . "\n";
```

## Next steps[​](#next-steps "Direct link to Next steps")

* [AWS PHP SDK reference](/docs/sdks/s3/aws-php-sdk/.md) — presigned URLs, custom domains, and full configuration details
* [Snapshots and forks](/docs/buckets/snapshots-and-forks/.md) — Tigris snapshot and fork concepts