{"id":28711160,"url":"https://github.com/leafsphp/s3","last_synced_at":"2026-03-10T04:03:19.246Z","repository":{"id":294213406,"uuid":"985431609","full_name":"leafsphp/s3","owner":"leafsphp","description":"🫙  Drop-in aws s3 module for Leaf FS","archived":false,"fork":false,"pushed_at":"2025-07-15T21:40:09.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-06T13:43:40.643Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/leafsphp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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},"funding":{"open_collective":"leaf","github":"leafsphp"}},"created_at":"2025-05-17T18:45:08.000Z","updated_at":"2025-06-14T22:02:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"dc20e7e0-9594-47b4-9aaa-e2aea20143c2","html_url":"https://github.com/leafsphp/s3","commit_stats":null,"previous_names":["leafsphp/s3"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/leafsphp/s3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leafsphp%2Fs3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leafsphp%2Fs3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leafsphp%2Fs3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leafsphp%2Fs3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leafsphp","download_url":"https://codeload.github.com/leafsphp/s3/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leafsphp%2Fs3/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30324185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":"2025-06-14T21:39:42.527Z","updated_at":"2026-03-10T04:03:19.230Z","avatar_url":"https://github.com/leafsphp.png","language":"PHP","readme":"\u003c!-- markdownlint-disable no-inline-html --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cbr\u003e\u003cbr\u003e\n  \u003cimg src=\"https://leafphp.netlify.app/assets/img/leaf3-logo.png\" height=\"100\"/\u003e\n  \u003ch1 align=\"center\"\u003eS3 Drop-in extension for Leaf FS\u003c/h1\u003e\n  \u003cbr\u003e\u003cbr\u003e\n\u003c/p\u003e\n\n# S3 for Leaf FS\n\n[![Latest Stable Version](https://poser.pugx.org/leafs/s3/v/stable)](https://packagist.org/packages/leafs/s3)\n[![Total Downloads](https://poser.pugx.org/leafs/s3/downloads)](https://packagist.org/packages/leafs/s3)\n[![License](https://poser.pugx.org/leafs/s3/license)](https://packagist.org/packages/leafs/s3)\n\nA drop-in extension for [Leaf FS](https://github.com/leafs/fs) that allows you to use S3 as a storage driver for Leaf FS.\n\n## Installation\n\nYou can easily install Leaf using [Composer](https://getcomposer.org/).\n\n```bash\ncomposer require leafs/s3\n```\n\n## Leaf MVC\n\nIf you are using Leaf MVC, add your S3 URL to the `.env` file:\n\n```env\nS3_URL=https://your-s3-url\n```\n\n## Leaf without MVC\n\nIf you are using Leaf without MVC, you can set the S3 URL in your code:\n\n```php\nstorage()-\u003ebucket('your-s3-url');\n```\n\n## Usage\n\nFrom there, you can use the s3 bucket as you would with your local storage, only wrapping your storage path in the `withBucket()` method to switch to bucket storage. For example, to upload a file:\n\n```php\nstorage()-\u003eupload('path/to/file.txt', withBucket('path/in/s3'));\n\n// or directly from the request\nrequest()-\u003eupload('file', withBucket('path/in/s3'));\n```\n\n## 💬 Stay In Touch\n\n- [Twitter](https://twitter.com/leafphp)\n- [Join the forum](https://github.com/leafsphp/leaf/discussions/37)\n- [Chat on discord](https://discord.com/invite/Pkrm9NJPE3)\n\n## 📓 Learning Leaf 3\n\n- Leaf has a very easy to understand [documentation](https://leafphp.dev) which contains information on all operations in Leaf.\n- You can also check out our [youtube channel](https://www.youtube.com/channel/UCllE-GsYy10RkxBUK0HIffw) which has video tutorials on different topics\n- You can also learn from [codelabs](https://codelabs.leafphp.dev) and contribute as well.\n\n## 😇 Contributing\n\nWe are glad to have you. All contributions are welcome! To get started, familiarize yourself with our [contribution guide](https://leafphp.dev/community/contributing.html) and you'll be ready to make your first pull request 🚀.\n\nTo report a security vulnerability, you can reach out to [@mychidarko](https://twitter.com/mychidarko) or [@leafphp](https://twitter.com/leafphp) on twitter. We will coordinate the fix and eventually commit the solution in this project.\n\n## 🤩 Sponsoring Leaf\n\nYour cash contributions go a long way to help us make Leaf even better for you. You can sponsor Leaf and any of our packages on [open collective](https://opencollective.com/leaf) or check the [contribution page](https://leafphp.dev/support/) for a list of ways to contribute.\n\nAnd to all our [existing cash/code contributors](https://leafphp.dev#sponsors), we love you all ❤️\n","funding_links":["https://opencollective.com/leaf","https://github.com/sponsors/leafsphp"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleafsphp%2Fs3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleafsphp%2Fs3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleafsphp%2Fs3/lists"}