PHPackages                             chipslays/cracker - 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. chipslays/cracker

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

chipslays/cracker
=================

Crack, crack aaand crack it!

1.0.5(5y ago)01911MITPHP

Since Dec 30Pushed 5y ago1 watchersCompare

[ Source](https://github.com/chipslays/cracker)[ Packagist](https://packagist.org/packages/chipslays/cracker)[ RSS](/packages/chipslays-cracker/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (7)Dependencies (3)Versions (8)Used By (1)

🍪 Cracker
=========

[](#-cracker)

Автоматическое распознавание капчи в игровом сервисе Steam.

Проблема
--------

[](#проблема)

При написании библиотеки [Steam Client](https://github.com/chipslays/steam-client), я сталкивался с вводом капчи. В какой-то момент постоянный ввод капчи стал надоедать, поэтому было принято решение сделать распознование капчи.

Решение
-------

[](#решение)

Для распознования используется [Tesseract OCR](https://github.com/tesseract-ocr/tesseract) + отдельно обученная модель (языковой файл) на основе 5000 разных капч.

Обучение модели сделано на основе [этого](https://github.com/guiem/train-tesseract) репозитория.

**Процесс распознования следующий:** каждый раз ссылка на картинку с капчей генерирует один и тот же текст в течении некоторого времени, а потом умирает. Но текст на картинке всегда будет один и тот же, меняется только хаотичность букв и шума. Поэтому на основе этого, задается количество итераций распознования, например 10 итераций, после окончания цикла, выбираются те символы которые встречались чаще всего.

Зависимости
-----------

[](#зависимости)

Imagick

Tesseract OCR

Trained model (for better recognition)

Установка
---------

[](#установка)

```
$ composer require chipslays/cracker
```

Использование
-------------

[](#использование)

```
use Cracker\Crack;

require 'vendor/autoload.php';

/**
 * Можно передать файл или ссылку.
 * Например:
 *      https://steamcommunity.com/public/captcha.php?gid=387475048XXXXXXXXXXXXXXXX
 *      images/captcha.png
 */
$cracked = (new Crack('https://raw.githubusercontent.com/chipslays/cracker/master/.github/captcha.png'))
    ->temp(__DIR__ . '/storage') // папка для временных файлов
    ->tessdata(__DIR__) // указываем путь где храняться модели
    ->model('steam') // используем свою модель
    ->iterations(1) // количество итераций
    ->resolve(true); // true - вернуть массив

print_r($cracked);

/** output */
Array
(
    [sortedChars] => Array
        (
            [0] => Array
                (
                    [M] => 1
                )

            [1] => Array
                (
                    [J] => 1
                )

            [2] => Array
                (
                    [X] => 1
                )

            [3] => Array
                (
                    [N] => 1
                )

            [4] => Array
                (
                    [P] => 1
                )

            [5] => Array
                (
                    [9] => 1
                )

        )

    [mostUsedChars] => Array
        (
            [0] => M
            [1] => J
            [2] => X
            [3] => N
            [4] => P
            [5] => 9
        )

    [captcha] => MJXNP9
    [time] => 0.9768
)
```

**Капча:** [![MJXNP9](https://raw.githubusercontent.com/chipslays/cracker/master/.github/captcha.png)](https://raw.githubusercontent.com/chipslays/cracker/master/.github/captcha.png)

Как видно из результата, в `sortedChars` все 3 итерации распознали одни и те же символы.

Время выполнение (ключ `time`) заняло 0.9 сек, чем больше итераций, тем больше времени занимает распознование.

В примере указана обученная модель, ей достаточно 1 итерации для корректного распознования, но так как изображение модифицируется, в некоторых случаях бывают артефакты, когда буква залита или наоборот ее не видно, либо видно только маленький кусок, в таких случаях конечно есть погрешности.

> **Внимание!** Этот репозиторий не содержит обученную модель, поэтому вам необходимо самостоятельно собрать данные и обучить ее. Я лишь показал, что это возможно сделать. Информация по обучению находится [здесь](https://tesseract-ocr.github.io/tessdoc/TrainingTesseract-4.00.html).

Можно попробовать использовать стандартную модель `eng`:

```
$cracked = (new Crack($fileOrUrl))
    ->temp(__DIR__ . '/storage')
    ->model('eng')
    ->iterations(10)
    ->resolve(true);
```

Для модели `eng` нужно больше итераций и времени, но качество распознавания в любом случае оставляет желать лучшего.

TODO
----

[](#todo)

- Рефакторинг кода
- Возможность модифицировать изображение

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 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

Every ~6 days

Total

7

Last Release

1974d ago

Major Versions

0.0.1 → 1.0.02020-12-31

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19103498?v=4)[chipslays](/maintainers/chipslays)[@chipslays](https://github.com/chipslays)

---

Top Contributors

[![chipslays](https://avatars.githubusercontent.com/u/19103498?v=4)](https://github.com/chipslays "chipslays (36 commits)")

### Embed Badge

![Health badge](/badges/chipslays-cracker/health.svg)

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

###  Alternatives

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[oat-sa/tao-core

TAO core extension

66143.7k122](/packages/oat-sa-tao-core)[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1235.9k20](/packages/fleetbase-core-api)[symfony/ux-cropperjs

Cropper.js integration for Symfony

19346.6k3](/packages/symfony-ux-cropperjs)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)

PHPackages © 2026

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