Bygg kortspel i PHP och Symfony enligt MVC

Du skall skapa ett kortspel i PHP med objektorienterade konstruktioner. Applikationen bygger du i Symfony.

#Förkunskaper

Du har god kunskap i hur man skapar en klass i PHP och hur arv och komposition fungerar.

Du kan bygga webbsidor via kontroller och templatefiler i Symfony.

Du vet hur man använder GET, POST och SESSION i Symfony.

#Introduktion och förberedelse

Läs och förbered dig.

#Välj ett kortspel att implementera

Du skall implementera ett kortspel som en applikation. Du kan välja ett godtyckligt kortspel men standardrekommendationen är att välja spelet 21.

Implementera kortspelet 21 så att det går att spela i din webbplats.

Återanvänd de klasser du redan har. Om du modifierar klasserna så kan du behöva tänka på att du inte förstör något som redan fungerar.

Spelets idé är att med två eller flera kort försöka uppnå det sammanlagda värdet 21, eller komma så nära som möjligt utan att överskrida 21. Ess är värt 1 eller 14.

En spelrunda kan se ut så här när en spelare spelar mot banken.

• Spelet leder till en landningssida där man kan läsa spelregler och se dokumentation om spelet samt påbörja ett spel.
• Spelplanen visas och spelaren och banken har inte tagit några kort.
• Spelaren tar ett kort. Kortet visas.
• Spelaren kan bestämma att stanna eller ta ytterligare ett kort.
  • Om spelaren får över 21 vinner banken.
• När spelaren stannar så är det bankens tur.
• Banken är inte medveten om spelarens korthand.
• Banken plockar kort tills den stannar eller har över 21.
  • Banken vinner vid lika eller om banken har mer än spelaren.
  • Spelaren vinner om banken får över 21.
• Därefter kan man påbörja en ny omgång.

Standardrekommendationen är att göra enligt ovan. Det är dock fritt fram att hitta på en egen variant av hur man spelar spelet.

Förslaget är att du börjar med enklaste möjliga variant av spelet. Använd principen KISS och “Keep it simple stupid”. Det kan vara en utmaning i uppgiften att verkligen försöka hålla det enkelt och avgränsat. Glöm inte bort det.

#Alternativa kortspel

Ett alternativt kortspel kan vara Black Jack som kan ses som en variant på kortspelet 21.

Känner du dig mogen att försöka med ett lite mer avancerat spel så kan du prova att spela en pokerhand med 5 eller 7 kort. Men räkna med att det kan kräva lite mer tid att implementera. Läs mer om poker och Texas hold’em.

Ett patiensspel som kan lämpa sig för denna uppgift är “Poker squares” där man lägger upp 5 x 5 kort och räknar ut vilka pokerhander man får i alla riktningar. Ju högre poäng destor bättre. Om man väljer detta kan det bli en intressant uppgift att försöka få datorspelaren att spela smart.

#Krav

Kraven är uppdelade i sektioner.

#Landningssida och intro

1. Skapa en landdningssida för spelet game/ där du samlar information om spelet och kan starta spelet. Placera länken i webbplatsens navbar.

2. I din landningssida, inled med en kort beskrivning av ditt kortspel och reglerna för hur det fungerar.

3. Placera en knapp eller länk som leder till att spelet börjar.

#Problemlösning

Du skall problemlösa det spelet du valt med flödesschema och pseudokod. Gör din problemlösning innan du påbörjar att implementera spelet.

1. Samla all din dokumentation i en webbsida under routen game/doc och länka till dokumentationssidan från din landningssida.

2. Skapa ett flödesschema som representerar hur du tänker lösa grunderna i spelet. Resultatet kan du placera som en bild i webbsidan för dokumentationen. Det behöver inte vara en komplett lösning, en dellösning räcker bra.

3. Skapa psuedokod som visar hur du tänker lösa delar av spelet. Du kan spara resultatet som text eller bild men visa upp det i webbsidan för dokumentationen. Det behöver inte vara en komplett lösning, en dellösning räcker bra.

4. Fundera igenom vilka klasser du behöver för att implementera spelet. Beskriv klasserna i text med klassens namn och en mening som beskriver vad klassens syfte är. Håll det kort och enkelt.

Följande krav är optionella och du gör dem om du har tid och lust.

1. Rita ett UML klass diagram som du också visar i webbsidan för dokumentationen.

#Kortspel

Bygg ditt kortspel i Symfony med objektorienterade konstruktioner i PHP och försök tänka till så att du får “snygg kod”.

1. All applikationskod placerar du i klasser som din kontroller använder. Se till att du har så lite kod som möjligt i din kontroller. Om du har mycket kod där så flyttar du den till en egen klass. Tänk att kontrollern skall vara tunn (lite kod) och modellerna (applikationens klasser) kan vara tjocka (mycket kod).

2. Använd templatefiler för att rendera webbsidorna.

3. Bygg spelet så att det fungerar minst enligt de regler som visas i introduktionen ovan.

4. Banken behöver inte vara speciellt intelligent i sitt kortspel. Det räcker att den kan utföra sin uppgift och spela spelet. En enkel variant är att banken alltid plockar kort tills den har 17 eller mer, sedan stannar den.

#Kortspel valfritt

Följande krav är optionella och du gör dem om du har tid och lust.

1. Gör så att spelaren kan satsa pengar. Man kan satsa en viss summa vid varje spel. Håll koll på hur mycket pengar som spelaren och banken har.

2. Låt banken och spelaren börja med 100 pengar var. När någon har 0 pengar har den spelaren förlorat.

3. Korträkning med sannolikhet att få högt/lågt kort. Låt bli att blanda kortleken inför varje ny runda och spela tills kortleken är slut. Visa statistik som berättar sannolikheten för att få ett visst kort. Visa statistiken så att spelaren kan ha hjälp av den. Tex om spelaren har 15, visa sannolikheten för att spelaren inte skall bli tjock om nytt kort tas.

4. Bygg en smartare bank som spelar på ett “intelligent sätt”. Låt banken ta hjälp av statistiken.

5. Låt spelaren välja om den spelar mot den “dumma” eller den “smarta” banken.

6. Förklara taktiken för den “dumma” och den “smarta” banken på dokumentationssidan.

#Kortspel JSON

1. I din landningssida för api/ lägger du till routen api/game som visar upp den aktuella ställningen för spelet i en JSON struktur.

#Kodvalidering

1. Fixa till din kod enligt den kodstil du kör genom att köra composer csfix.

2. Kolla din kod hur den matchar dina linters genom att köra composer lint. Får du fel så kollar du vad det är och rättar de sakerna du anser rimliga. Försök få en ren och tom rapport, utan valideringsfel.

#Publicera

1. Committa alla filer och lägg till en tagg 3.0.0. Om du gör uppdateringar så ökar du taggen till 3.0.1, 3.0.2, 3.1.0 eller liknande.

2. Kör dbwebb test kmom03 för att kolla att du inte har några uppenbara fel.

3. Pusha upp repot till GitHub, inklusive taggarna.

4. Gör en dbwebb publishpure report och kontrollera att att det fungerar på studentservern.

#Tips från coachen

Lycka till och hojta till i chatt och forum om du behöver hjälp!

#Revision history