atsmacode/card-games

There is no license information available for the latest version (v2.0.12) of this package.

Base package to support any type of card based game

v2.0.12 2025-03-26 06:57 UTC

Requires

• atsmacode/framework: ^2.0
• laminas/laminas-servicemanager: ^3.20
• symfony/console: 5.4.* || ^6.0 || ^7.0

Requires (Dev)

• phpunit/phpunit: ^9.5

Unknown License

• Mark Ramage

README

This package contains resources that can in theory be used to build any traditional 52 deck card game.

It consists of:

• A migration to insert Cards, Ranks and Suits into a database
• Card constants with IDs mapped to the database rows to assist writing unit tests and logic
• A Dealer class based on the constants to shuffle and deal cards and hold a Deck array

Environment

PHP

8.1.3

MySQL

8.0.13

Commands

Linux

Run the unit test suite:

dev/phpunit

Drop, Create and Seed all tables. '-d true' is required to run this in test DB:

php dev/CardGamesApp.php app:build-card-games -d true

Windows

Run the unit test suite:

.\dev\runtests.bat

Drop, Create and Seed all tables. '-d true' is required to run this in test DB

php .\dev\CardGamesApp.php app:build-card-games -d true

Configs

You need to add card_games.php to configure your local DB credentials, like so:

<?php

return [
    'card_games' => [
        'db' => [
            'live' => [
                'servername' => 'localhost',
                'username'   => 'DB_USER',
                'password'   => 'DB_PASSWORD',
                'database'   => 'card_games',
                'driver'     => 'pdo_mysql',
            ],
            'test' => [
                'servername' => 'localhost',
                'username'   => 'DB_USER',
                'password'   => 'DB_PASSWORD',
                'database'   => 'card_games_test',
                'driver'     => 'pdo_mysql',
            ],
        ],
    ],
];