Pizza King

This is a possible implementation of mnapoli/pizza-king exercise.

The exercise

This is a raw translation of the exercise in english:

My name is Jean-Michel and I make pizzas in my pizzeria.

In my pizzeria, customers can compose pizzas.

And I need to digitize the composition of pizzas (necessarily).

The application will allow me to make sure that only valid pizzas are created,

and to calculate the price of a pizza.

Here are the rules for composing pizzas:

• a pizza must have a sauce: tomato or cream.
• a pizza must have a cheese: mozzarella or goat cheese.
• a pizza has 0, 1 or 2 meats: ham and/or pepperoni and/or nothing.

Here is the price of the ingredients:

• basic price of a pizza : 4 €.
• tomato sauce : 1 €
• cream sauce : 1 €.
• mozzarella : 3 €.
• goat : 2 €.
• ham : 2 €.
• pepperoni : 4 €.

It turns out that the pizzeria's customers are PHP developers. They will place an order via a PHP script, calling the necessary classes and/or functions. Pizzeria 2.0!

Constraints :

• you are not allowed to use a server database, like MySQL (because my cousin told me it's not web-scale)
• no need to do a web UI or CLI

Objective :

• use the maximum of PHP 8 unique features (my cousin told me it was better)

System Requirements

You need:

• PHP8+ but the latest stable version of PHP is recommended

Reference

The following PHP features are used:

PHP 8

• named parameters
• match expression
• constructor promotion
• union types

PHP 7.4

• type properties
• numeric literal separator
• arrow function

REST API

A simple REST API can be accessed by running

make rest

Get Ingredient by name

GET /ingredients/{name} 

example:

GET /ingredients/pepperoni

{
  "type": "meat",
  "name": "pepperoni",
  "price": {
    "currency": "EUR",
    "amount": "4.00"
  }
}

Get pizza by name

GET /pizzas/{name}

example:

GET /pizzas/reine

{
    "type": "pizza",
    "name": "reine",
    "basePrice": {
        "currency": "EUR",
        "amount": "4.00"
    },
    "ingredients": [
        {
            "type": "cheese",
            "name": "mozzarella",
            "price": {
                "currency": "EUR",
                "amount": "3.00"
            }
        },
        {
            "type": "sauce",
            "name": "tomato",
            "price": {
                "currency": "EUR",
                "amount": "1.00"
            }
        },
        {
            "type": "meat",
            "name": "jambon",
            "price": {
                "currency": "EUR",
                "amount": "2.00"
            }
        }
    ],
    "price": {
        "currency": "EUR",
        "amount": "10.00"
    }
}

Get pizza by ingredients

GET /pizzas{?sauce,cheese,meat*}

example:

GET /pizzas?sauce=creme&cheese=mozzarella&meat=pepperoni&meat=pepperoni

{
    "type": "pizza",
    "name": "custom pizza",
    "basePrice": {
        "currency": "EUR",
        "amount": "4.00"
    },
    "ingredients": [
        {
            "type": "cheese",
            "name": "mozzarella",
            "price": {
                "currency": "EUR",
                "amount": "3.00"
            }
        },
        {
            "type": "sauce",
            "name": "creme",
            "price": {
                "currency": "EUR",
                "amount": "1.00"
            }
        },
        {
            "type": "meat",
            "name": "pepperoni",
            "price": {
                "currency": "EUR",
                "amount": "4.00"
            }
        },
        {
            "type": "meat",
            "name": "pepperoni",
            "price": {
                "currency": "EUR",
                "amount": "4.00"
            }
        }
    ],
    "price": {
        "currency": "EUR",
        "amount": "16.00"
    }
}

Testing

bakame/pizza-king has:

• a PHPUnit test suite
• a code analysis compliance test suite using PHPStan.
• a code analysis compliance test suite using Psalm.
• a coding style compliance test suite using PHP CS Fixer.

To run the tests, run the following command from the project folder.

$ composer test