PHPackages                             staticnur/hangman - 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. staticnur/hangman

ActiveProject

staticnur/hangman
=================

Implementation of the game "Hangman"

v1.3(1y ago)019MITPHP

Since Oct 11Pushed 1y ago1 watchersCompare

[ Source](https://github.com/StaticNur/hangman)[ Packagist](https://packagist.org/packages/staticnur/hangman)[ RSS](/packages/staticnur-hangman/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (2)Versions (5)Used By (0)

Проект "Виселица" (Hangman)
===========================

[](#проект-виселица-hangman)

Описание проекта
----------------

[](#описание-проекта)

Проект включает разработку игры "Виселица" (Hangman) с использованием реляционной базы данных для сохранения результатов игр. Игра реализована на языке PHP с использованием базы данных SQLite. Пользователям предоставляется возможность просматривать историю игр и воспроизводить ранее сыгранные партии.

Цель игры - угадать загаданное компьютером слово из шести букв. Игрок пытается угадать буквы, а затем и все слово целиком. Если игрок правильно угадывает букву, компьютер вписывает ее в соответствующую клетку. Если ошибается, то рисует одну из частей тела повешенного человека (используется псевдографика). Чтобы победить, игрок должен угадать все буквы в слове до того, как повешенный человечек будет полностью нарисован.

### Правила игры

[](#правила-игры)

- Компьютер загадывает слово из шести букв.
- Игрок пытается угадать буквы, вводя их по одной.
- Если буква угадана верно, она отображается в соответствующей клетке.
- Если буква не угадана, рисуется одна из частей тела повешенного человека.
- Игра заканчивается победой, если игрок угадывает все буквы в слове до того, как повешенный человечек будет полностью нарисован.
- Игра заканчивается поражением, если повешенный человечек будет полностью нарисован до угадывания всех букв.

### Требования

[](#требования)

- **Список слов**: Заранее сгенерированный список слов из шести букв, сохраненный в базе данных.
- **Сохранение данных**: Вся информация об играх и ходах сохраняется в базе данных SQLite.
- **Хранение данных**:
    - Дата игры
    - Имя игрока
    - Загаданное компьютером слово
    - Исход игры
    - Запись ходов в формате: `номер попытки | предложенная буква | результат (угадал/не угадал)`
- **Режимы игры**:
    - Новая игра
    - Просмотр списка сохраненных игр
    - Повтор сохраненной партии (воспроизведение ходов)

---

Окружение и требования для запуска
----------------------------------

[](#окружение-и-требования-для-запуска)

1. **PHP**:

    - Версия: 7.4 или выше.
    - Настройки в `php.ini`:
        - Включите SQLite (`extension=sqlite3`).
        - Включите SQLite (`extension=pdo_sqlite`).
        - Убедитесь, что настройки отображения ошибок (`display_errors`) включены в режиме разработки.
2. **SQLite**:

    - Версия: 3.x.
    - Проверьте наличие прав записи в каталоге, где находятся файлы баз данных.
3. **Composer**:

    - Composer должен быть установлен глобально.
    - Используйте команду `composer` для управления зависимостями.
    - Для установки Composer следуйте [официальной документации](https://getcomposer.org/doc/00-intro.md).

---

Установка и запуск проекта
--------------------------

[](#установка-и-запуск-проекта)

1. **Склонируйте репозиторий**:

    ```
    git clone https://github.com/StaticNur/hangman
    ```
2. **Перейдите в каталог проекта**:

    ```
    cd C:\...\hangman
    ```
3. **Установите зависимости через Composer**:

    ```
    composer install
    ```
4. **Запуск игры: Выполните команду для запуска игры**:

    ```
    php bin/hangman.php
    ```

    - Или если ваш пакет опубликован на Packagist, установите его глобально:

    ```
    composer global require staticnur/hangman
    ```

    - И затем выполните команду:

    ```
    hangman
    ```

Игровой процесс
---------------

[](#игровой-процесс)

***Команды***

1. `--new` (краткий параметр `-n`). Новая игра. Этот же режим используется по умолчанию, если программа запускается без параметров.
2. `--list` (`-l`). Вывод списка всех сохраненных игр.
3. `--statistics` (`-s`). Вывод статистики за все игры.
4. `--replay id` (`-r id`). Повтор игры с идентификатором id.
5. `--help` (`-h`). Вывод краткой информации о приложении и доступных ключах для запуска в разных режимах.

1. Начало игры:

- При запуске игры пользователю необходимо ввести свое имя.
- После авторизации предлагается ввести букву или слово целиком.
- Если пользователь вводит букву, она проверяется на наличие в загаданном слове.
- Если пользователь вводит слово целиком, оно проверяется на совпадение с загаданным словом.

2. Ввод данных:

- Введите букву или слово целиком.
- Если введено несколько букв, они будут рассматриваться как попытка угадать слово целиком.
- Если введена одна буква, она будет проверяться на наличие в загаданном слове.

3. Результаты:

- Если буква угадана верно, она отображается в соответствующей клетке.
- Если буква не угадана, рисуется одна из частей тела повешенного человека.
- Игра заканчивается победой, если игрок угадывает все буквы в слове до того, как повешенный человечек будет полностью нарисован.
- Игра заканчивается поражением, если повешенный человечек будет полностью нарисован до угадывания всех букв.

4. Конец игры:

- После завершения игры будет выведено сообщение о результате игры.
- Будет отображено правильно загаданное слово.

Структура Базы данных
---------------------

[](#структура-базы-данных)

### `games`

[](#games)

КолонкаТипКомментарийidIDУникальный идентификатор игры, первичный ключ AUTO\_INCREMENTdateTEXTДата игрыplayer\_nameTEXTИмя игрокаword\_idINTЗагаданное компьютером слово (id ссылка на другую таблицу)attemptsINTКоличество ошибочных попытокwonBOOLEANИсход игры (угадал/не угадал)### `moves`

[](#moves)

КолонкаТипКомментарийidIDУникальный идентификатор попытки, первичный ключ AUTO\_INCREMENTgame\_idINTId игры, ссылка на другую таблицуmove\_numberINTНомер попыткиletterTEXTПредложенная букваresultBOOLEANРезультат### `words`

[](#words)

КолонкаТипКомментарийidIDУникальный идентификатор слово, первичный ключ AUTO\_INCREMENTwordTEXTСлова, которые нужно отгадывать#### `words` по умолчанию заполнен "apple", "banana", "cherry", "orange", "grape", "lemon"

[](#words-по-умолчанию-заполнен-apple-banana-cherry-orange-grape-lemon)

Примечания
----------

[](#примечания)

- Проверьте права на запись в каталог с базой данных SQLite.
- Дополнительную информацию можно найти в документации PHP, SQLite и Composer:
- [SQLite Documentation](https://www.sqlite.org/docs.html)
- [PHP Documentation](https://www.php.net/docs.php)
- [Composer Documentation](https://getcomposer.org/doc/)

Ссылки на пакеты
----------------

[](#ссылки-на-пакеты)

- [Packagist пакет Hangman](https://packagist.org/packages/StaticNur/hangman#dev-main1)

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance38

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

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 ~10 days

Total

4

Last Release

553d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/48967ee3349248ef1464fb24ccd8c27a16a263b9a992fdcf49954c5432522206?d=identicon)[StaticNur](/maintainers/StaticNur)

---

Top Contributors

[![StaticNur](https://avatars.githubusercontent.com/u/116446405?v=4)](https://github.com/StaticNur "StaticNur (7 commits)")

### Embed Badge

![Health badge](/badges/staticnur-hangman/health.svg)

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

PHPackages © 2026

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