README

Проект представляет собой консольную игру "Сапёр" (Minesweeper) на PHP. Игрок открывает клетки на квадратном поле, избегая мин. Цель — открыть все безопасные клетки. Если открыта клетка с миной, игра заканчивается поражением.

Игра поддерживает интерактивный ввод координат для открытия клеток и установки флагов, а также вывод справки по ключу запуска.

Правила и управление

Правила игры

• Игрок открывает клетки, избегая мин.
• Если мины нет, клетка показывает количество соседних мин (по 8 направлениям).
• Если рядом с открытой клеткой нет мин (0), автоматически раскрывается область пустых клеток до ближайших чисел.
• Можно ставить и убирать флаги на подозрительных клетках.

Команды во время игры

• row col — открыть клетку по координатам (row, col)
• M row col — установить или убрать флаг на клетке (row, col)

Подсказка: индексация строк и столбцов начинается с 0 и отображается в заголовках поля.

Ограничения

• Размер поля не меньше 2.
• Количество мин от 1 до (size * size) - 1.
• Если количество мин не указано, используется значение по умолчанию ≈ 15% от числа клеток (зажатое в допустимый диапазон).
• Координаты ячеек должны быть в пределах поля.

Требования

1. PHP: 7.4 или выше
2. Composer: для установки зависимостей — https://getcomposer.org/doc/

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

Вариант 1: Установка через Packagist (глобально)

• Пакет на Packagist: https://packagist.org/packages/artyo/minesweeper

1. Установите пакет глобально через Composer:

composer global require artyo/minesweeper

Убедитесь, что глобальная папка Composer (~/.composer/vendor/bin или ~/.config/composer/vendor/bin) добавлена в переменную окружения PATH.

1. Запустите игру из любого места:

minesweeper

При запуске без параметров откроется главное меню с выбором действий.

Для справки по ключам запуска:

minesweeper --help

Вариант 2: Установка из исходников (GitHub)

1. Клонируйте репозиторий:

git clone https://github.com/artyo/minesweeper

1. Перейдите в каталог проекта и установите зависимости:

cd minesweeper
composer install

1. Запустите игру:

php bin/minesweeper

При запуске без параметров откроется главное меню с выбором действий.

Справка по ключам запуска:

php bin/minesweeper --help

Главное меню

При запуске игры без параметров открывается интерактивное главное меню:

=== ГЛАВНОЕ МЕНЮ САПЁРА ===
Выберите действие:
1. Новая игра
2. Список сохранённых партий
3. Повтор игры
4. Справка
0. Выход
Введите номер (0-4):

Доступные действия:

• 1. Новая игра - начать новую партию с настройкой параметров
• 2. Список сохранённых партий - просмотр истории всех игр
• 3. Повтор игры - пошаговое воспроизведение любой сохранённой партии
• 4. Справка - подробная информация о правилах и командах
• 0. Выход - завершение программы

Пример игрового процесса

• При запуске укажите размер поля (по умолчанию 10, минимум 2).
• Затем будет показан допустимый диапазон мин и значение по умолчанию (≈ 15% клеток).
• Введите row col для открытия клетки или M row col для установки/снятия флага.
• Победа — когда открыты все безопасные клетки.

Функционал базы данных

Игра поддерживает сохранение и воспроизведение партий в базе данных SQLite.

Возможности

• Автоматическое сохранение: Все завершённые игры автоматически сохраняются в базу данных
• Просмотр истории: Просмотр списка всех сохранённых партий с деталями
• Повтор игры: Полное воспроизведение любой сохранённой партии пошагово

Сохраняемая информация

Для каждой игры в базе сохраняется:

• Дата и время игры
• Имя игрока
• Размер поля и количество мин
• Точные позиции всех мин
• Результат игры (победа/поражение)
• Полная запись всех ходов с результатами

Команды для работы с базой данных

Все функции базы данных доступны как через главное меню, так и через командную строку:

Просмотр списка игр

minesweeper --list

или

minesweeper -l

Показывает таблицу всех сохранённых игр с:

• ID игры
• Имя игрока
• Дата игры
• Размер поля
• Количество мин
• Результат
• Общее количество ходов

Повтор сохранённой игры

minesweeper --replay <ID>

или

minesweeper -r <ID>

Где <ID> — номер игры из списка.

Как работает повтор:

• Восстанавливается точное расположение мин
• Показывается поле в начальном состоянии
• По нажатию Enter выполняется следующий ход
• Отображается состояние поля после каждого хода
• Показывается описание каждого хода (открытие клетки/установка флага)
• Можно прервать повтор командой q или quit

База данных

• Файл базы данных: data/minesweeper.db
• Автоматически создаётся при первом запуске
• Использует SQLite для простоты и портабельности

Используемые библиотеки

• wp-cli/php-cli-tools — вспомогательные утилиты для CLI
• gabordemooij/redbean — ORM-библиотека RedBeanPHP для работы с базой данных