PHPackages                             mobirox/mobileproxy-sdk - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. mobirox/mobileproxy-sdk

ActiveLibrary[HTTP &amp; Networking](/categories/http)

mobirox/mobileproxy-sdk
=======================

Official PHP SDK for MobileProxy.Space API — private mobile proxies on real GSM devices

v1.0.0(3mo ago)04[1 issues](https://github.com/mobileproxy/php-sdk/issues)MITPHPPHP &gt;=7.4CI passing

Since Mar 5Pushed 3mo agoCompare

[ Source](https://github.com/mobileproxy/php-sdk)[ Packagist](https://packagist.org/packages/mobirox/mobileproxy-sdk)[ Docs](https://mobileproxy.space)[ RSS](/packages/mobirox-mobileproxy-sdk/feed)WikiDiscussions main Synced 3w ago

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

MobileProxy.Space PHP SDK
=========================

[](#mobileproxyspace-php-sdk)

[![CI](https://github.com/mobileproxy/php-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/mobileproxy/php-sdk/actions/workflows/ci.yml)

Official PHP SDK for the [MobileProxy.Space](https://mobileproxy.space) API — private mobile proxies on real GSM devices across 52 countries.

Features
--------

[](#features)

- **Full API coverage** — all endpoints wrapped in typed, documented methods
- **PSR-4 autoloading** — install via Composer
- **Typed exceptions** — `ApiException`, `AuthenticationException`, `RateLimitException`
- **IP rotation** — dedicated `changeIp()` method with no rate limit
- **PHP 7.4+** compatible

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

[](#installation)

```
composer require mobirox/mobileproxy-sdk
```

Quick Start
-----------

[](#quick-start)

```
use MobileProxy\Client;
use MobileProxy\Exception\ApiException;

$client = new Client('YOUR_API_TOKEN');

// Check balance
$balance = $client->getBalance();
echo "Balance: {$balance['balance']}";

// List active proxies
$proxies = $client->getMyProxy();

// Get current IP of a proxy
$ip = $client->getProxyIp(12345);

// Rotate IP (no rate limit)
$client->changeIp('your_proxy_key');
```

API Methods
-----------

[](#api-methods)

### Proxy Information

[](#proxy-information)

MethodDescription`getProxyIp($proxyId, $checkSpam)`Get current IP address of a proxy`getMyProxy($proxyId)`List active proxies (all or specific)`getIpStats()`IP address statistics by GEO### Proxy Management

[](#proxy-management)

MethodDescription`changeProxyCredentials($proxyId, $login, $password)`Change proxy login/password`rebootProxy($proxyId)`Restart the modem`editProxy($proxyId, $rebootTime, $ipAuth, $comment)`Update proxy settings`changeIp($proxyKey, $format, $userAgent)`Rotate IP (no rate limit)### Equipment &amp; GEO

[](#equipment--geo)

MethodDescription`changeEquipment($proxyId, $options)`Switch modem/SIM/operator/city`getAvailableEquipment($proxyId, $options)`List available equipment by GEO`getGeoList($proxyId, $geoId)`Available GEOs for a proxy`getOperators($geoId)`Operators for a GEO`getCountries($onlyAvailable)`List of countries`getCities()`List of cities### Blacklist

[](#blacklist)

MethodDescription`getBlackList($proxyId)`Get equipment/operator blacklist`addOperatorToBlackList($proxyId, $operatorId)`Block an operator`removeOperatorFromBlackList($proxyId, $operatorId)`Unblock an operator`removeFromBlackList($proxyId, $blackListId, $eid)`Remove equipment from blacklist### Purchasing &amp; Billing

[](#purchasing--billing)

MethodDescription`buyProxy($options)`Purchase a proxy`refundProxy($proxyId)`Request a refund`getBalance()`Account balance`getPrices($countryId)`Prices for a country`getTestProxy($geoId, $operator)`Get a free 2-hour trial proxy### Utilities

[](#utilities)

MethodDescription`checkEquipmentAvailability($eid)`Check if equipment is available`viewUrlFromDifferentIps($url, $countryId)`Anti-cloaking: view URL from another country`getTaskResult($taskId)`Get async task resultError Handling
--------------

[](#error-handling)

```
use MobileProxy\Exception\ApiException;
use MobileProxy\Exception\AuthenticationException;
use MobileProxy\Exception\RateLimitException;

try {
    $client->getBalance();
} catch (AuthenticationException $e) {
    // Invalid API token
} catch (RateLimitException $e) {
    // Too many requests — back off and retry
    // Limit: 3 × (number of active proxies) requests/sec
} catch (ApiException $e) {
    echo $e->getMessage();
    echo $e->getHttpCode();
    print_r($e->getResponseBody());
}
```

Configuration
-------------

[](#configuration)

```
$client = new Client('YOUR_API_TOKEN', [
    'timeout' => 120,    // request timeout in seconds
    'debug'   => true,   // enable cURL verbose output
]);
```

Rate Limits
-----------

[](#rate-limits)

API requests are limited to **3 × (number of active proxies)** per second. For example, 10 proxies = 30 req/s. The `changeIp()` method uses a separate endpoint with **no rate limit**.

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- cURL extension
- JSON extension

Links
-----

[](#links)

- [API Documentation](https://mobileproxy.space/en/user.html?api)
- [Dashboard](https://mobileproxy.space/en/user.html)
- [Website](https://mobileproxy.space)
- [Chrome Extension](https://chromewebstore.google.com/detail/mobile-proxy-manager/lhbdhjhflkejgkkhlgacbaogbaaollac)

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance79

Regular maintenance activity

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 Bus Factor1

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

Unknown

Total

1

Last Release

109d ago

### Community

Maintainers

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

---

Top Contributors

[![mobileproxy](https://avatars.githubusercontent.com/u/96537630?v=4)](https://github.com/mobileproxy "mobileproxy (2 commits)")

---

Tags

proxyapi clientscrapinghttp-proxysocks5mobile-proxymobileproxy

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mobirox-mobileproxy-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/mobirox-mobileproxy-sdk/health.svg)](https://phpackages.com/packages/mobirox-mobileproxy-sdk)
```

###  Alternatives

[php-curl-class/php-curl-class

PHP Curl Class makes it easy to send HTTP requests and integrate with web APIs.

3.3k9.8M372](/packages/php-curl-class-php-curl-class)[nette/http

🌐 Nette Http: abstraction for HTTP request, response and session. Provides careful data sanitization and utility for URL and cookies manipulation.

49019.6M575](/packages/nette-http)[jenssegers/proxy

Proxy library that forwards requests to the desired url and returns the response.

939491.5k4](/packages/jenssegers-proxy)[duzun/hquery

An extremely fast web scraper that parses megabytes of HTML in a blink of an eye. No dependencies. PHP5+

361159.6k5](/packages/duzun-hquery)[zounar/php-proxy

Forward your HTTP/HTTPS requests to another server.

1824.3k](/packages/zounar-php-proxy)[clue/http-proxy-react

Async HTTP proxy connector, tunnel any TCP/IP-based protocol through an HTTP CONNECT proxy server, built on top of ReactPHP

492.3M34](/packages/clue-http-proxy-react)

PHPackages © 2026

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