PHPackages                             patriotblog/php-offcloud - 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. patriotblog/php-offcloud

ActiveLibrary

patriotblog/php-offcloud
========================

PHP library for Offcloud.com

2223PHP

Since Nov 28Pushed 8y ago1 watchersCompare

[ Source](https://github.com/patriotblog/php-offcloud)[ Packagist](https://packagist.org/packages/patriotblog/php-offcloud)[ RSS](/packages/patriotblog-php-offcloud/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

PHP-Offcloud
============

[](#php-offcloud)

PHP library for Offcloud.com

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

[](#installation)

```
composer require patriotblog/php-offcloud

```

Offcloud.com API
================

[](#offcloudcom-api)

Introduction to the Offcloud.com API
------------------------------------

[](#introduction-to-the-offcloudcom-api)

Offcloud API is a solution that gives developers ability to interact with Offcloud.com service, including:

- Adding an URL to Offcloud for Instant downloading
- Adding an URL to Offcloud cloud.
- Adding an URL to Offcloud for Remote downloading

All requests return JSON, including errors. All parameters should be passed to API scripts as POST request variables.

Authentificate to the Offcloud.com API
--------------------------------------

[](#authentificate-to-the-offcloudcom-api)

The best way to authentificate to Offcloud is to add "?apikey=" to your API queries, along with your API key. You can find your API key into your account settings @

Submitting an input to Offcloud.com through the API
---------------------------------------------------

[](#submitting-an-input-to-offcloudcom-through-the-api)

### Adding an URL for instant downloading

[](#adding-an-url-for-instant-downloading)

To add an URL for instant downloading, you can make a POST call to the following URL with the available variables described below:

```
$offCloud = new PHPOffCloud\OffCloud(API_KEY);
$file = $offCloud->instantDownload(SOME_URL, PROXY_ID);

if($file_one){
    echo 'requestId: '.$file->requestId;
}

```

- url: URL of downloaded resource
- proxyId: (optional) ID of the preferred proxy server to use. If proxyId is not specified, the default user proxy server will be used

In the case of success, the script will return the OffCloudFile object that contains:

- requestId
- fileName: the name of the requested file
- url: url for instant download
- site: website name
- status: status of the requested file. Should be ‘created’
- originalLink: link to the original file
- createdOn: date and time when request was processed

In the case when adding this URL is not available for this user, API will return the following JSON answer:

- not\_available

Here are the following values of the ‘not\_available’ response and their descriptions:

NameDescriptionpremiumUser must purchase a premium downloading addon for this download.linksUser must purchase a Link increase addon for this download.proxyUser must purchase a proxy downloading addon for this download.videoUser must purchase a video sharing site support addon for this download.When a request cannot be processed, API will return error message in the JSON answer.

### Adding an URL for cloud downloading.

[](#adding-an-url-for-cloud-downloading)

To add an URL for cloud downloading, you can make a POST call to the following URL with the available variables described below:

```
$file = $offCloud->cloudDownload(SOME_URL);

```

- url: URL of downloaded resource

In the case of success, the script will return the OffCloudFile object that contains:

- requestId
- fileName: the name of the requested file
- url: url for download from the cloud
- site: website name
- status: status of the requested file downloading. Can be ‘created’, ‘downloaded’, ‘error’.
- originalLink: link to the original file
- createdOn: date and time when request was processed

If you want to start a process of downloading from the cloud, please, be convinced that the status of download is ‘downloaded’. You can check the status of download request by sending an API call (see the section “Retrieving a status of user’s cloud download” below).

In the case when adding this URL is not available for this user, API will return the following JSON answer:

- not\_available

Here are the following values of the ‘not\_available’ response and their descriptions:

NameDescriptionpremiumUser must purchase a premium downloading addon for this download.linksUser must purchase a Link increase addon for this download.proxyUser must purchase a proxy downloading addon for this download.cloudUser must purchase a clowd downloading upgrade addon for this download.videoUser must purchase a video sharing site support addon for this download.When a request cannot be processed, API will return error message in the JSON answer.

### Adding an URL for remote downloading.

[](#adding-an-url-for-remote-downloading)

To add an URL for remote downloading, you can make a POST call to the following URL with the available variables described below:

```
$file = $offCloud->remoteDownload(SOME_URL, REMOTE_OPTION_ID, FOLDER_ID);

```

- url: URL of downloaded resource
- remoteOptionId: ID of the remote account where to download
- folderId: Google Drive's ID of the folder to upload content to.

To get a list of all users remote accounts, see the section “Retrieving a list of remote accounts”.

In the case of success, the script will return the OffCloudFile object that contains:

- requestId
- fileName: the name of the requested file
- site: website name
- status: status of the requested file downloading. Can be ‘created’, ‘downloaded’, ‘error’.
- originalLink: original link to the file
- createdOn: date and time when request was processed

The API call doesn’t return a link for immediate downloading, you can only check the status of download request by sending additional API call (See the section “Retrieving a status of user’s remote download” below).

In the case when adding this URL is not available for this user, API will return the following JSON answer:

- not\_available

Here are the following values of the ‘not\_available’ response and their descriptions:

NameDescriptionpremiumUser must purchase a premium downloading addon for this download.linksUser must purchase a Link increase addon for this download.proxyUser must purchase a proxy downloading addon for this download.videoUser must purchase a video sharing site support addon for this download.When a request cannot be processed, API will return error message in the JSON answer.

Retrieving some data from Offcloud.com through the API
------------------------------------------------------

[](#retrieving-some-data-from-offcloudcom-through-the-api)

### Retrieving a list of available proxy servers

[](#retrieving-a-list-of-available-proxy-servers)

To get a list of available proxy servers, you can make a POST call to the following URL:

```
$proxies = $offCloud->proxies()

```

This script will return a JSON array of the available proxy servers with the following data:

- id
- name: name of the proxy server
- region: location of the proxy server

### Retrieving a status of user’s cloud download

[](#retrieving-a-status-of-users-cloud-download)

To get a status of user’s cloud download, you can make a POST call with a requestId parameter to the following URL:

```
$file->checkCloudStatus()

```

The server will return status of the download or an error message if the request cannot be processed.

### Exploring zipped files or folder archives from cloud

[](#exploring-zipped-files-or-folder-archives-from-cloud)

To explore your zipped files or folder archives in your cloud history, you can make a GET call with a requestId parameter to the following URL:

```
$file->cloudExplore()

```

The server will return a JSON array of download links to each file stored in archive.

### Retrieving a list of user’s remote accounts

[](#retrieving-a-list-of-users-remote-accounts)

To get a list of user’s remote accounts, you can make a POST call to the following URL:

```
$remoteAccounts = $offCloud->remoteAccounts();

```

This script will return a JSON array of the current user’s remote accounts with the following data:

- accountId
- type: type of account
- username: login used for the remote account
- status: status of the account
- host: remote host
- port: remote port
- usage: amount of traffic used by this remote account

### Retrieving a status of user’s remote download

[](#retrieving-a-status-of-users-remote-download)

To get a status of user’s remote download, you can make a POST call with a requestId parameter to the following URL:

```
$file->checkRemoteStatus()

```

The server will return a status of the download or an error message if the request cannot be processed.

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/781a3822f0f7b4f5b5c727552fd7f381a6aabc23fb4d93ce890cb967fb575fd5?d=identicon)[patriot](/maintainers/patriot)

---

Top Contributors

[![easyapprepo](https://avatars.githubusercontent.com/u/25583403?v=4)](https://github.com/easyapprepo "easyapprepo (7 commits)")[![patriotblog](https://avatars.githubusercontent.com/u/3022196?v=4)](https://github.com/patriotblog "patriotblog (1 commits)")

### Embed Badge

![Health badge](/badges/patriotblog-php-offcloud/health.svg)

```
[![Health](https://phpackages.com/badges/patriotblog-php-offcloud/health.svg)](https://phpackages.com/packages/patriotblog-php-offcloud)
```

PHPackages © 2026

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