PHPackages                             ahmard/queliwrap - 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. ahmard/queliwrap

ActiveLibrary[Utility & Helpers](/categories/utility)

ahmard/queliwrap
================

QueryList PHP web scrapper wrapper.

4.0.4(3y ago)61591[1 PRs](https://github.com/Ahmard/queliwrap/pulls)1MITPHPPHP ^8.1

Since May 4Pushed 3y ago1 watchersCompare

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

READMEChangelog (10)Dependencies (4)Versions (16)Used By (1)

Queliwrap.
==========

[](#queliwrap)

Queliwrap is a wrapper that provides easy helper functions around PHP popular web scrapper, [QueryList](https://github.com/jae-jae/QueryList) and [Guzwrap](https://github.com/ahmard/guzwrap).

**Notice:** ***Queliwrap\\Wrapper\\Queliwrap::exec()*** method has been replaced with ***execute()***. exec() now returns **psr-7** compliant object while execute() returns **QueryList** object.

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

[](#installation)

Make sure you have [Composer](http://getcomposer.org) installed.

```
composer require ahmard/queliwrap
```

After installation is done, require Composer's autoloader in your code:

```
require 'vendor/autoload.php';
```

Usage
-----

[](#usage)

**Queliwrap relies on [Guzwrap](https://github.com/ahmard/guzwrap), you might want to dig a little deeper in to it**.

```
use Queliwrap\Client;

Client::get('https://google.com')->execute()
    ->find('ul')->eq(0)
    ->find('li');
```

Handle errors

```
use Queliwrap\Client;

try {
    $text = Client::get('https://google.com')->execute()
        ->find('ul')->eq(0)
        ->find('li')
        ->text();

    echo $text;
}catch (Throwable $exception){
    echo $exception->getMessage();
}
```

### Submit Form

[](#submit-form)

```
use Guzwrap\Wrapper\Form;
use Queliwrap\Client;

Client::post(function(Form $form){
    $form->action('http://localhost:8080/rand/guzwrap.php');
    $form->field('name', 'Jane Doe');
    $form->file('image', 'C:\1.jpg');
});
```

### Cookies

[](#cookies)

Thanks to [Guzwrap](https://github.com/Ahmard/guzwrap) cookies can be preserved across multiple requests

```
use Guzwrap\Wrapper\Form;
use Queliwrap\Client;

//Login
Client::create()
    ->referer('http://localhost:8000')
    ->withSharedCookie()
    ->form(function (Form $form){
        $form->action('http://localhost:8000/login');
        $form->method('POST');
        $form->input('email', 'queliwrap@example.com');
        $form->input('password', 1234);
        $form->input('remember_me', 1);
    })->exec();

//View user profile
$queryList = Client::create()
    ->get('http://localhost:8000/users/view')
    ->query(['id' => 2])
    ->withSharedCookie()
    ->execute();

//Find user info
$firstName = $queryList->find('.profile')
    ->find('list-group-item')
    ->eq(0)
    ->text();

echo "First name: {$firstName}";
```

Documentations
--------------

[](#documentations)

- [QueryList](https://github.com/jae-jae/QueryList)
- [Guzwrap](http://github.com/ahmard/guzwrap)
- [Guzzle](http://guzzlephp.org/)

Licence
-------

[](#licence)

Queliwrap is **MIT** licenced.

###  Health Score

34

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 72.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 ~80 days

Recently: every ~173 days

Total

13

Last Release

1289d ago

Major Versions

v1.0.1 → 2.0.02020-07-06

2.0.1 → 3.0.02020-11-01

3.1.3 → 4.0.02021-01-25

PHP version history (4 changes)3.0.0PHP ^7.4

3.0.1PHP ^7.4|8.0

3.0.2PHP ^7.4 || ^8.0

4.0.4PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/2b69fe34bd6492697a19cd8f33bde7a381cab0b7f8c0a01dcc7505f482458887?d=identicon)[Ahmard](/maintainers/Ahmard)

---

Top Contributors

[![Ahmard](https://avatars.githubusercontent.com/u/44737217?v=4)](https://github.com/Ahmard "Ahmard (8 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")

---

Tags

phpquerylistwebcrawlerwebscraper

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ahmard-queliwrap/health.svg)

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

PHPackages © 2026

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