Home » Php » amazon s3 – Seeing if object exists in S3 using PHP

amazon s3 – Seeing if object exists in S3 using PHP

Posted by: admin April 23, 2020 Leave a comment


I am using PHP and I am using the S3 API to upload a file, but I wanted to make sure that this exact filename doesn’t already exist in the bucket before upload.

I have found a few examples online that use “file_get_contents” but doesn’t this mean that you would have to download the entire file first? Usually, these files are about 10 mb, so ideally, I wouldn’t really want to do this.

Is there perhaps a way to use “file_get_contents” without downloading the file?

Or better yet, perhaps I could use an API request to see if the filename exists?

It’s not important to me whether or not the content, or filesize, is the same, just the filename.

How to&Answers:

Gets whether or not the specified Amazon S3 object exists in the specified bucket.

AmazonS3 doesObjectExist

$s3 = new AmazonS3();
$bucket = 'my-bucket' . strtolower($s3->key);

$response = $s3->doesObjectExist($bucket, 'test1.txt');

// Success? (Boolean, not a CFResponse object)


try to use code below:

$s3 = new S3();

$info = $s3->getObjectInfo($bucket, $filename);
if ($info)
    echo 'File exists';
    echo 'File does not exists';

download the S3 SDK from amazon for php. There is a class called S3; create an object of S3. The object will allow to call the getObjectInfo() method. Pass your S3 bucket name and the file name (often the file name is referred as key). The getObjectInfo() method will return some information if the file exists, otherwise the method will return FALSE.


Please note that the other suggestions are based on version 1 of the AWS SDK for PHP. For version 2, you’ll want to be familiar with the latest guide found here:


The “Getting Started” section in the link above will help you get the SDK installed and setup, so be sure to take your time reading through those docs if you haven’t done so already. When you’re done with the setup, you’ll want to be familiar with the stream wrapper method found here:


Finally, below is a brief, real-life example of how you could use it in the flow of your code.


// your filename
$filename = 'my_file_01.jpg';
// this will use AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY from env vars
$s3 = Aws\S3\S3Client::factory();
// S3_BUCKET must also be defined in env vars
$bucket = getenv('S3_BUCKET')?: die('No "S3_BUCKET" config var in found in env!');
// register stream wrapper method
// does file exist
$keyExists = file_exists("s3://".$bucket."/".$filename);
if ($keyExists) {
    echo 'File exists!';


If you have or have the ability to install the PECL extension HTTP then you can use http_head to make a head request easily and check whether the response was 200 or 404.