PHPackages                             juzaweb/proxies - 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. [Utility & Helpers](/categories/utility)
4. /
5. juzaweb/proxies

ActiveJuzaweb-module[Utility & Helpers](/categories/utility)

juzaweb/proxies
===============

Craw and management proxies

1.0.1(2y ago)13.8kMITPHPCI passing

Since Jan 29Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/juzaweb/proxies)[ Packagist](https://packagist.org/packages/juzaweb/proxies)[ RSS](/packages/juzaweb-proxies/feed)WikiDiscussions master Synced today

READMEChangelog (2)DependenciesVersions (16)Used By (0)

Juzaweb Proxies Module
======================

[](#juzaweb-proxies-module)

The Juzaweb Proxies Module is a comprehensive solution for managing, crawling, and testing proxies within your Juzaweb CMS application. It provides tools to maintain a pool of active proxies, verify their connectivity, and seamlessly integrate them into your application logic.

Features
--------

[](#features)

- **Proxy Management**: Store and manage proxy details including IP, port, protocol, and authentication credentials.
- **Automated Testing**: Schedule regular checks to ensure proxies are active and responsive.
- **On-Demand Testing**: Manually test specific proxies via Artisan commands.
- **Proxy Allocation**: Retrieve available ("free") proxies for use in your application, with concurrency handling.
- **Admin Interface**: Configure settings and view proxy status directly from the Juzaweb Admin Panel.

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

[](#installation)

You can install the package via composer:

```
composer require juzaweb/proxies
```

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

[](#configuration)

### Database Settings

[](#database-settings)

The module uses the following settings keys which can be configured via the Juzaweb Admin Panel (Settings -> Proxies) or directly in the database:

- `proxy_test_url`: The URL used to verify proxy connectivity (Default: `https://translate.google.com`).
- `proxy_test_timeout`: The timeout duration in seconds for proxy connection tests (Default: `20`).
- `proxy_auto_test_enable`: Enable automatic hourly testing of proxies (Set to `1` to enable).

### Scheduler

[](#scheduler)

To enable the automatic proxy checker, ensure your application's scheduler is running. If `proxy_auto_test_enable` is set to `1`, the module will register a scheduled command to check proxies hourly.

```
php artisan schedule:run
```

Usage
-----

[](#usage)

### Artisan Commands

[](#artisan-commands)

The module provides several Artisan commands for managing proxies from the command line.

#### Check Proxies

[](#check-proxies)

Run a check on all available (free) proxies in the database.

```
php artisan proxy:check
```

You can also check a specific proxy by providing its address:

```
php artisan proxy:check --proxy=192.168.1.1:8080
```

#### Test Connectivity

[](#test-connectivity)

Test the connectivity of a specific proxy configuration.

```
php artisan proxy:test   [protocol]
```

Example:

```
php artisan proxy:test 127.0.0.1 8080 https
```

### Programmatic Usage

[](#programmatic-usage)

You can use the `Juzaweb\Modules\Proxies\Contracts\ProxyManager` contract to interact with proxies in your code.

#### Retrieve a Random Active Proxy

[](#retrieve-a-random-active-proxy)

To get a random proxy that is currently active:

```
use Juzaweb\Modules\Proxies\Contracts\ProxyManager;

$proxyManager = app(ProxyManager::class);
$proxy = $proxyManager->random();

if ($proxy) {
    // Use the proxy
    echo $proxy->ip . ':' . $proxy->port;
}
```

#### Retrieve and Reserve an Available Proxy

[](#retrieve-and-reserve-an-available-proxy)

To get an available ("free") proxy and mark it as in-use (setting `is_free` to `false`):

```
use Juzaweb\Modules\Proxies\Contracts\ProxyManager;

$proxyManager = app(ProxyManager::class);
$proxy = $proxyManager->free();

if ($proxy) {
    // The proxy is now marked as not free.
    // Use the proxy...
}
```

### Helper Functions

[](#helper-functions)

The module provides global helper functions for working with proxy strings:

- `is_proxy_format(string $proxy): bool` - Validates if a string is in the format `IP:PORT`.
- `parse_proxy_string_to_array(string $proxy): array` - Parses a proxy string into an array with keys `ip`, `port`, `protocol`, `created_at`, and `updated_at`.

License
-------

[](#license)

This project is licensed under the GPL-2.0 License.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance52

Moderate activity, may be stable

Popularity18

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.7% 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 ~10 days

Total

3

Last Release

866d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3169e8a8781068840e9300a57785089da521287dbe0279fc9cc7e8de1c1d95a9?d=identicon)[juzaweb](/maintainers/juzaweb)

---

Top Contributors

[![juzaweb](https://avatars.githubusercontent.com/u/47020363?v=4)](https://github.com/juzaweb "juzaweb (38 commits)")[![google-labs-jules[bot]](https://avatars.githubusercontent.com/in/842251?v=4)](https://github.com/google-labs-jules[bot] "google-labs-jules[bot] (15 commits)")

---

Tags

http-proxyjuzaweblaravellaravel-cmslaravel-frameworkproxy

### Embed Badge

![Health badge](/badges/juzaweb-proxies/health.svg)

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

###  Alternatives

[codewithdennis/filament-simple-map

This package offers a straightforward and easy-to-use map action component for your Filament application.

368.2k](/packages/codewithdennis-filament-simple-map)

PHPackages © 2026

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