PHPackages                             ppz/s3service - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. ppz/s3service

ActiveLibrary[File & Storage](/categories/file-storage)

ppz/s3service
=============

PPZ S3 Upload Service Facade

v1.1.0(11mo ago)019MITPHPPHP ^8.0

Since Jun 4Pushed 11mo agoCompare

[ Source](https://github.com/famintech/ppz-s3service-package)[ Packagist](https://packagist.org/packages/ppz/s3service)[ RSS](/packages/ppz-s3service/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

PPZ S3Service Laravel Package
=============================

[](#ppz-s3service-laravel-package)

A Laravel package that provides a simple facade for uploading files to a custom S3-compatible endpoint via an API. This package is designed to be easily integrated into Laravel applications, supporting Laravel 8.x through 12.x.

Features
--------

[](#features)

- Facade-based API for file uploads
- Configurable endpoint and API key
- Simple integration with Laravel's service provider and config system

Installation
------------

[](#installation)

Require the package via Composer:

```
composer require ppz/s3service
```

Usage
-----

[](#usage)

You can use the `PPZS3Service` facade to upload one or more files to your S3-compatible API endpoint.

```
use PPZS3Service;

// Single file upload
$response = PPZS3Service::upload([
    'file' => $request->file('file'), // Required: uploaded file instance
    'directory' => 'e-ejen',          // Required: S3 directory/folder
    'tag' => 'qr',                    // Required: Tag for the file
    'emp_id' => 'KKS020',             // Required: Employee ID
    // Optional parameters:
    // 'filename' => 'custom_name',    // Optional: Custom filename
    // 'is_temporary' => 1,            // Optional: 1 for temporary, 0 for permanent
    // 'description' => 'QR E-Ejen',   // Optional: File description
]);

// Multiple file upload
$response = PPZS3Service::upload([
    'file' => $request->file('file'), // Required: array of uploaded file instance
    'directory' => 'e-ejen',         // Required
    'tag' => 'qr',                   // Required
    'emp_id' => 'KKS020',            // Required
    // ...other optional params
]);

// Handling the response
if (!empty($response['success']) && $response['success']) {
    // For single file: $response['data']
    // For multiple files: $response['results'] (array of results)
} else {
    $errorMsg = $response['message'] ?? 'Upload failed';
}
```

### Parameter Reference

[](#parameter-reference)

ParameterRequiredTypeDescriptionfileYesfile/arrayThe file(s) to uploaddirectoryYesstringS3 directory/foldertagYesstringTag for the file (e.g. 'qr')emp\_idYesstringEmployee ID (required for all uploads)filenameNostringCustom filename (extension will be set by API)is\_temporaryNobool/int1 for temporary, 0 for permanentdescriptionNostringFile descriptionConfiguration
-------------

[](#configuration)

Publish the configuration file:

```
php artisan vendor:publish --tag=s3service-config
```

This will create a `config/s3service.php` file with the following options:

Set the corresponding environment variables in your `.env` file:

```
PPZ_S3_UPLOAD_ENDPOINT=https://your-upload-endpoint
PPZ_API_KEY=your-api-key

```

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance51

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

348d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/eb73c2ea4802e47d37c59afb9d1ce7dc4ac0fb2816f8c1687573332bd74edbf8?d=identicon)[famintech](/maintainers/famintech)

---

Top Contributors

[![zapirolabs](https://avatars.githubusercontent.com/u/116142085?v=4)](https://github.com/zapirolabs "zapirolabs (11 commits)")[![fathulamin-ppz](https://avatars.githubusercontent.com/u/242363191?v=4)](https://github.com/fathulamin-ppz "fathulamin-ppz (4 commits)")

### Embed Badge

![Health badge](/badges/ppz-s3service/health.svg)

```
[![Health](https://phpackages.com/badges/ppz-s3service/health.svg)](https://phpackages.com/packages/ppz-s3service)
```

###  Alternatives

[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[illuminate/filesystem

The Illuminate Filesystem package.

15161.6M2.6k](/packages/illuminate-filesystem)[stechstudio/laravel-zipstream

A fast and simple streaming zip file downloader for Laravel.

4633.7M3](/packages/stechstudio-laravel-zipstream)[spatie/laravel-google-cloud-storage

Google Cloud Storage filesystem driver for Laravel

2408.9M13](/packages/spatie-laravel-google-cloud-storage)[azure-oss/storage-blob-laravel

Azure Storage Blob filesystem driver for Laravel

63582.2k1](/packages/azure-oss-storage-blob-laravel)[spatie/laravel-backup-server

Backup multiple applications

17016.7k1](/packages/spatie-laravel-backup-server)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)