Начало работы v1.0.0
WebShare Proxy PHP Wrapper: обзор, конфигурация и первые запросы.
PHP-библиотека для WebShare Proxy API: типизированные запросы, фильтры, итерация страниц, кэш GET-ответов и повтор при 429 / 5xx.
Пакет: devcraftclub/webshare-io-api-wrapper.
Возможности
- PHP 8.3+, строгая типизация
- Фасад
Appили явная работа черезClient/ Request-классы QueryBuilderс операторамиEQUAL,IN,GT,LT,CONTAINSPageIterator/iterate()с лимитом страниц- Кэш успешных GET и инвалидация по тегам
X-SubuserчерезmasqueradeAs()
Разделы документации
Установка
Composer и конфигурация API_KEY
Прокси
List, iterate, download, connection strings
Auth и токены
Profile, IP auth, ApiKey, DownloadToken
SubUser
CRUD и masqueradeAs
Stats и config
ProxyStats, ProxyConfig, кэш, ошибки
Справочник
Все классы пакета
English
Full English documentation
Быстрый пример
<?php
require_once 'vendor/autoload.php';
use Devcraft\Webshare\Classes\App;
use Devcraft\Webshare\Enums\FilterOperator;
App::init();
/** @var \Devcraft\Webshare\Requests\ProxyRequest $proxies */
$proxies = App::Requests('Proxy');
$proxies->query()
->withFilter('mode', 'direct')
->withPageSize(25)
->withFilter('country_code', ['US', 'DE'], FilterOperator::IN);
$list = $proxies->getList();
foreach ($proxies->iterate() as $proxy) {
echo $proxy->getConnectionString(backbone: true), "\n";
}Поверхность Requests
| App::Requests key | Coverage |
|---|---|
Proxy | list, iterate, download, refresh |
Profile | profile + preferences |
Notification | list/retrieve/dismiss/restore |
ProxyReplacement | list/retrieve/create (v3) |
ReplacedProxy | list/download |
ProxyConfig | config/status/listStats/update (v3) |
IpAuthorization | list/iterate/CRUD + whatsMyIp |
ProxyStats | list/aggregate/activities/download |
DownloadToken | get/reset token by scope |
ApiKey | list/iterate/CRUD |
SubUser | list/iterate/CRUD/refresh + masqueradeAs() |
Глоссарий
| Термин | Значение |
|---|---|
| Proxy | Один endpoint из списка прокси |
| ProxyList | Пагинированная коллекция Proxy |
| ProxyConfig | Plan-level конфигурация прокси |
| IpAuthorization | Allowlisted source IP |
| SubUser | Дочерний аккаунт под родительским планом |
| X-Subuser | Заголовок маскировки под SubUser |
| DownloadToken | Временный ключ скачивания |
| PageIterator | Обход страниц до next == null |
| BackboneConnection / DirectConnection | Режимы getConnectionString() |