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

ActiveLibrary

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 6d 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 43% 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

1928d 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

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k21](/packages/neuron-core-neuron-ai)[inovector/mixpost

Self-hosted social media management software.

3.0k5.2k2](/packages/inovector-mixpost)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)[eveseat/web

SeAT Web Interface

2723.2k135](/packages/eveseat-web)

PHPackages © 2026

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