Download the PHP package hamrocdn/sdk without Composer
On this page you can find all versions of the php package hamrocdn/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package sdk
HamroCDN PHP SDK
Official PHP SDK for HamroCDN — a simple, typed, and framework-agnostic way to upload, fetch, and manage files from your HamroCDN account.
📦 Installation
Install via Composer:
Requirements
- PHP 8.0+
- GuzzleHTTP 7.10+
That’s it.
No Laravel dependencies, no magic — just pure PHP.
⚙️ Configuration
You can pass your API key directly, or rely on environment/config values if available.
Alternatively, if your environment has them:
the SDK automatically detects and uses them.
⚡ Quick Start
Here’s a quick example showing upload and fetch in action:
🚀 Usage
This SDK make use of public API provided by HamroCDN. To get your API key, sign up at hamrocdn.com and navigate to Edit Profile page in your dashboard.
1. List Uploads
1.1 Paginated
The index() method returns paginated results.
You can provide pagination parameters such as page and per_page:
Returns an object containing
data(array ofUploadmodels) andmeta(pagination info).
Example of returned metadata:
1.2 All Uploads
To fetch all uploads without pagination, use the all() method:
Returns an array of
Uploadmodels.
2. Fetch a Single Upload
3. Upload a File
To delete the file after a certain time, use the
deleteAfterparameter (in seconds):This will set the
deleteAtproperty on the returnedUploadmodel.
4. Upload by Remote URL
Also supports the
deleteAfterparameter.
🧱 Models
🗂 HamroCDN\Models\Upload
| Property | Type | Description |
|---|---|---|
nanoId |
string |
Unique identifier of the upload |
user |
User or null |
Owner of the file (if authenticated) |
deleteAt |
Carbon or null |
Deletion timestamp if temporary |
original |
File |
File information (URL, size) |
Methods
getNanoId():stringgetUser():?UsergetDeleteAt():?CarbongetOriginal():FiletoArray():array
👤 HamroCDN\Models\User
| Property | Type | Description |
|---|---|---|
name |
string |
Name of the uploader |
email |
string |
Email of the uploader |
Methods
getName():stringgetEmail():stringtoArray():array
🧾 HamroCDN\Models\File
| Property | Type | Description |
|---|---|---|
url |
string |
Public CDN URL |
size |
int |
File size in bytes |
Methods
getUrl():stringgetSize():inttoArray():array
⚡ Error Handling
All SDK errors extend HamroCDN\Exceptions\HamroCDNException.
Example:
The SDK automatically wraps:
- Network issues (
GuzzleException) - Invalid JSON responses
- Missing API key or misconfiguration
🧪 Testing
This SDK is built with Pest and supports real API integration tests.
A dedicated testing environment is configured within the HamroCDN infrastructure, ensuring safe, production-like validations.
Run tests locally:
🪄 Framework Integrations
This SDK is framework-agnostic. If you’re using Laravel, check out the companion package:
It provides service providers, configuration publishing, and automatic Facade binding.
🧩 Type Safety / Static Analysis
- Fully typed with PHPStan annotations
- 100% PHP 8.0+ compatible
- Pint with
laravelpreset for code style - Rector for automated refactoring
- SonarCloud integration for code quality
📄 License
This package is open-sourced software licensed under the MIT license.
🤝 Contributing
Contributions are welcome! Please create a pull request or open an issue if you find any bugs or have feature requests.
⭐ Support
If you find this package useful, please consider starring the repository on GitHub to show your support.
