{"id":49251569,"url":"https://github.com/not-empty/aws-bucket-php-lib","last_synced_at":"2026-04-25T00:41:23.365Z","repository":{"id":39675115,"uuid":"306662627","full_name":"not-empty/aws-bucket-php-lib","owner":"not-empty","description":"PHP library to use AWS Bucket S3","archived":false,"fork":false,"pushed_at":"2026-01-27T17:46:45.000Z","size":56,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-19T17:17:06.822Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/not-empty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-23T14:34:56.000Z","updated_at":"2026-01-27T17:46:47.000Z","dependencies_parsed_at":"2023-11-27T12:41:04.521Z","dependency_job_id":null,"html_url":"https://github.com/not-empty/aws-bucket-php-lib","commit_stats":null,"previous_names":["not-empty/aws-bucket-php-lib"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/not-empty/aws-bucket-php-lib","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/not-empty%2Faws-bucket-php-lib","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/not-empty%2Faws-bucket-php-lib/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/not-empty%2Faws-bucket-php-lib/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/not-empty%2Faws-bucket-php-lib/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/not-empty","download_url":"https://codeload.github.com/not-empty/aws-bucket-php-lib/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/not-empty%2Faws-bucket-php-lib/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32246405,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-25T00:41:22.703Z","updated_at":"2026-04-25T00:41:23.360Z","avatar_url":"https://github.com/not-empty.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS Bucket PHP\n\n[![Latest Version](https://img.shields.io/github/v/release/not-empty/aws-bucket-php-lib.svg?style=flat-square)](https://github.com/not-empty/aws-bucket-php-lib/releases)\n[![codecov](https://codecov.io/gh/not-empty/aws-bucket-php-lib/graph/badge.svg?token=AEMV163UW6)](https://codecov.io/gh/not-empty/aws-bucket-php-lib)\n[![CI Build](https://img.shields.io/github/actions/workflow/status/not-empty/aws-bucket-php-lib/php.yml)](https://github.com/not-empty/aws-bucket-php-lib/actions/workflows/php.yml)\n[![Downloads Old](https://img.shields.io/packagist/dt/kiwfy/aws-bucket-php?logo=old\u0026label=downloads%20legacy)](https://packagist.org/packages/kiwfy/aws-bucket-php)\n[![Downloads](https://img.shields.io/packagist/dt/not-empty/aws-bucket-php-lib?logo=old\u0026label=downloads)](https://packagist.org/packages/not-empty/aws-bucket-php-lib)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)\n[![Packagist License (custom server)](https://img.shields.io/packagist/l/not-empty/aws-bucket-php-lib)](https://github.com/not-empty/aws-bucket-php-lib/blob/master/LICENSE)\n\nPHP library to connect to and use AWS S3 Bucket.\n\n### Installation\n\n[Release 8.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/8.0.0) Requires [PHP](https://php.net) 8.4\n\n[Release 7.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/7.0.0) Requires [PHP](https://php.net) 8.3\n\n[Release 6.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/6.0.0) Requires [PHP](https://php.net) 8.2\n\n[Release 5.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/5.0.0) Requires [PHP](https://php.net) 8.1\n\n[Release 4.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/4.0.0) Requires [PHP](https://php.net) 7.4\n\n[Release 3.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/2.0.0) Requires [PHP](https://php.net) 7.3\n\n[Release 2.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/2.0.0) Requires [PHP](https://php.net) 7.2\n\n[Release 1.0.0](https://github.com/not-empty/aws-bucket-php-lib/releases/tag/1.0.0) Requires [PHP](https://php.net) 7.1\n\nThe recommended way to install is through [Composer](https://getcomposer.org/).\n\n```sh\ncomposer require not-empty/aws-bucket-php-lib\n```\n\n### Usage\n\nPutting a file\n\n```php\nuse AwsBucket\\AwsBucket;\n$config = [\n   'credentials' =\u003e [\n       'key' =\u003e '', //you must put your aws iam key here\n       'secret' =\u003e '', //you must put your aws iam secret here\n   ],\n   'version' =\u003e 'latest',\n   'region' =\u003e 'us-east-1', //you must put your bucket region here\n];\n$awsBucket = new AwsBucket($config);\n$bucket = 'my-bucket'; //you must put your bucket name here\n$content = 'this is your file content';\n$name = 'sample';\n$extension = 'txt';\n$putFile = $awsBucket-\u003eputFile(\n    $bucket,\n    $content,\n    $name,\n    $extension\n);\nvar_dump($putFile);\n```\n\nListing files\n\n```php\n$listFiles = $awsBucket-\u003elistFiles(\n    $bucket\n);\nvar_dump($listFiles);\n```\n\nIf you getting 403 or 400 erros, you must configure your bucket permitions, in AWS console to allow the files uploads.\n\nif you want an environment to run or test it, you can build and install dependences like this\n\n```sh\ndocker build --build-arg PHP_VERSION=8.4-cli -t not-empty/aws-bucket-php-lib:php84 -f contrib/Dockerfile .\n```\n\nAccess the container\n```sh\ndocker run --name aws-bucket-php-lib -v ${PWD}/:/var/www/html -it not-empty/aws-bucket-php-lib:php84 bash\n```\n\nVerify if all dependencies is installed\n```sh\ncomposer install --no-dev --prefer-dist\n```\n\nput your credentials, region and name of bucket in sample file sample/aws-bucket-sample.php\n```php\n...\n$config = [\n   'credentials' =\u003e [\n       'key' =\u003e '', //you must put your aws iam key here\n       'secret' =\u003e '', //you must put your aws iam secret here\n   ],\n   'version' =\u003e 'latest',\n   'region' =\u003e 'us-east-1', //you must put your bucket region here\n];\n$bucket = 'my-bucket'; //you must put your bucket name here\n```\n\nand run\n```sh\nphp sample/aws-bucket-sample.php\n```\n\n### Development\n\nWant to contribute? Great!\n\nThe project using a simple code.\nMake a change in your file and be careful with your updates!\n**Any new code will only be accepted with all validations.**\n\nTo ensure that the entire project is fine:\n\nFirst you need to building a correct environment to install all dependences\n\n```sh\ndocker build --build-arg PHP_VERSION=8.4-cli -t not-empty/aws-bucket-php-lib:php84 -f contrib/Dockerfile .\n```\n\nAccess the container\n```sh\ndocker run --name aws-bucket-php-lib -v ${PWD}/:/var/www/html -it not-empty/aws-bucket-php-lib:php84 bash\n```\n\nInstall all dependences\n```sh\ncomposer install --dev --prefer-dist\n```\n\nRun all validations\n```sh\ncomposer check\n```\n\n**Not Empty Foundation - Free codes, full minds**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnot-empty%2Faws-bucket-php-lib","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnot-empty%2Faws-bucket-php-lib","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnot-empty%2Faws-bucket-php-lib/lists"}