AWS: Create Zip from S3 with PHP

In modern cloud - based applications, Amazon Web Services (AWS) S3 is a popular choice for storing and retrieving large amounts of data. Sometimes, you may need to create a ZIP archive of multiple files stored in an S3 bucket. This can be useful for tasks like batch downloading, data backup, or sending multiple files in a single package. PHP, being a widely used server - side scripting language, provides a great way to interact with AWS S3 and create ZIP files. In this blog post, we will explore how to create a ZIP file from files stored in an AWS S3 bucket using PHP.

Table of Contents#

  1. Core Concepts
  2. Typical Usage Scenarios
  3. Common Practice
  4. Best Practices
  5. Conclusion
  6. FAQ
  7. References

Article#

Core Concepts#

AWS S3#

Amazon S3 is an object storage service that offers industry - leading scalability, data availability, security, and performance. It allows you to store and retrieve any amount of data from anywhere on the web. Files in S3 are stored as objects within buckets, and each object has a unique key.

PHP and AWS SDK for PHP#

The AWS SDK for PHP provides a set of classes and methods to interact with various AWS services, including S3. To use it, you need to install the SDK via Composer, which is a dependency management tool for PHP. Once installed, you can authenticate with AWS using your access key and secret key and then perform operations like listing objects in a bucket, downloading objects, etc.

ZIP Archive in PHP#

PHP has a built - in ZipArchive class that allows you to create, read, and modify ZIP files. You can add files to a ZIP archive, set file permissions, and finally save the archive to a local file or output it for download.

Typical Usage Scenarios#

Batch Download#

Suppose you have a web application where users can select multiple files from an S3 bucket for download. Instead of forcing the user to download each file individually, you can create a ZIP archive of the selected files and provide a single download link.

Data Backup#

You may want to periodically backup a set of files from an S3 bucket. Creating a ZIP file of these files can make the backup process more organized and efficient. You can then store the ZIP file in another location, such as a local server or another S3 bucket.

File Sharing#

When sharing multiple files with other users or systems, sending a single ZIP file is more convenient than sending multiple individual files. You can create a ZIP file from relevant S3 files and share it via email, FTP, or other means.

Common Practice#

Step 1: Install AWS SDK for PHP#

First, make sure you have Composer installed on your system. Then, create a composer.json file in your project directory with the following content:

{
    "require": {
        "aws/aws - sdk - php": "^3.0"
    }
}

Run composer install to install the AWS SDK for PHP.

Step 2: Authenticate with AWS#

require'vendor/autoload.php';
 
use Aws\S3\S3Client;
 
$s3 = new S3Client([
    'version' => 'latest',
    'region'  => 'your - aws - region',
    'credentials' => [
        'key'    => 'your - aws - access - key',
        'secret' => 'your - aws - secret - key',
    ]
]);

Step 3: List Objects in the S3 Bucket#

$bucket = 'your - s3 - bucket - name';
$result = $s3->listObjects([
    'Bucket' => $bucket
]);
 
$objects = $result['Contents'];

Step 4: Create a ZIP Archive#

$zip = new ZipArchive;
$zipFileName = 'archive.zip';
 
if ($zip->open($zipFileName, ZipArchive::CREATE) === TRUE) {
    foreach ($objects as $object) {
        $key = $object['Key'];
        $tempFilePath = tempnam(sys_get_temp_dir(), 's3_');
        $s3->getObject([
            'Bucket' => $bucket,
            'Key'    => $key,
            'SaveAs' => $tempFilePath
        ]);
        $zip->addFile($tempFilePath, $key);
        unlink($tempFilePath);
    }
    $zip->close();
}

Step 5: Output the ZIP File for Download#

header('Content - Type: application/zip');
header('Content - Disposition: attachment; filename="'.$zipFileName.'"');
header('Content - Length: '. filesize($zipFileName));
readfile($zipFileName);
unlink($zipFileName);

Best Practices#

Error Handling#

Add proper error handling throughout your code. For example, when opening the ZIP archive, if it fails, you should log the error and provide a meaningful message to the user. When downloading objects from S3, handle cases where the object is not found or there is a network error.

Memory Management#

When dealing with large files or a large number of files, be mindful of memory usage. Downloading files to a temporary location and then immediately adding them to the ZIP archive helps reduce memory consumption.

Security#

Protect your AWS access keys. Do not hard - code them in your PHP files. Instead, use environment variables or AWS IAM roles for better security.

Conclusion#

Creating a ZIP file from files stored in an AWS S3 bucket using PHP is a useful technique with various practical applications. By understanding the core concepts, typical usage scenarios, and following common and best practices, you can implement this functionality in your PHP applications effectively and securely.

FAQ#

Q1: Can I create a ZIP file directly in S3 without downloading the files locally?#

A1: As of now, there is no direct way to create a ZIP file in S3 without downloading the files locally. You need to download the files, create the ZIP file using PHP's ZipArchive class, and then optionally upload the ZIP file back to S3.

Q2: What if I have a large number of files in the S3 bucket?#

A2: If you have a large number of files, you may need to implement pagination when listing objects in the S3 bucket. Also, be careful with memory usage and consider processing the files in batches.

Q3: How can I handle errors when downloading files from S3?#

A3: You can use try - catch blocks when making API calls to S3. For example, when using $s3->getObject(), wrap it in a try - catch block and handle the Aws\Exception\AwsException that may be thrown.

References#

2025-10