{"id":696,"date":"2018-08-21T21:05:07","date_gmt":"2018-08-21T20:05:07","guid":{"rendered":"http:\/\/louis.hatier.me\/blog\/?p=696"},"modified":"2018-08-31T12:36:34","modified_gmt":"2018-08-31T11:36:34","slug":"behat-bdd-php-symfony-selenium-jenkins","status":"publish","type":"post","link":"https:\/\/louis.hatier.me\/blog\/behat-bdd-php-symfony-selenium-jenkins\/","title":{"rendered":"Behat : BDD avec PHP, Symfony, Selenium et Jenkins"},"content":{"rendered":"

\"Logo<\/a>Behat<\/a> est un framework de test Behavior-Driven Development<\/a> pour PHP.<\/p>\n

Les tests \u00e9crits avec Gherkin<\/a> permettent une meilleure communication entre les d\u00e9veloppeurs et le business, et une meilleure fiabilit\u00e9 de l\u2019application.<\/p>\n

Behat est d\u00e9velopp\u00e9 en utilisant une grande partie des composants Symfony 2.<\/p>\n

<\/p>\n

If you are a stakeholder, this is your proof that developers understand exactly how you want this feature to work. If you are a developer, this is your proof that the stakeholder expects you to implement this feature exactly in the way you\u2019re planning to implement it.<\/p><\/blockquote>\n

Les sc\u00e9narios des tests s\u2019\u00e9crivent dans ce qui s\u2019appelle des features<\/em>.
\nUne feature = un fichier xxxxx.feature<\/code>
\nUn sc\u00e9nario contient habituellement les \u00e9tapes suivantes : Given \/ When \/ Then \/ And (alias de Then)<\/p>\n

Une traduction des mots clefs est disponible en fran\u00e7ais mais il pr\u00e9f\u00e9rable de s’en tenir \u00e0 l’anglais (des soucis peuvent survenir avec certains caract\u00e8res), si besoin :<\/p>\n

sudo apt install cucumber\r\ncucumber --i18n fr\r\n<\/code><\/pre>\n
<\/h2>\n
Exemple de feature<\/h2>\n
Feature: Product basket\r\n  In order to buy products\r\n  As a customer\r\n  I need to be able to put interesting products into a basket\r\n \r\n  Scenario: Buying a single product under 10\u20ac\r\n    Given there is a \"Sith Lord Lightsaber\", which costs 5\u20ac\r\n    When I add the \"Sith Lord Lightsaber\" to the basket\r\n    Then I should have 1 product in the basket\r\n    And the overall basket price should be 9\u20ac\r\n<\/code><\/pre>\n
Il est possible d’utiliser des table-like ou paragraphe en utilisant les PyString \"\"\"<\/code>.
\nExemple avec un tableau :<\/p>\n
Feature: Get users\r\n    In order to check users\r\n    As an admin\r\n    I must have a list of all of them\r\n \r\n    Scenario: List users\r\n        Given there are users:\r\n        | username      | password | email           |\r\n        | foo           | 123456   | foo@bar.com     |\r\n        | bar           | 22@222   | bar@foo.com     |\r\n        When I search the user \"foo\"\r\n        Then I should find it and get the email \"foo@bar.com\"\r\n<\/code><\/pre>\n
<\/h2>\n
Tags<\/h2>\n
Il est possible de renseigner un tag au niveau de la feature, cela permet de pr\u00e9ciser des contextes seulement pour certains tags, de lancer les tests sur une liste de tags etc.<\/p>\n
@backoffice\r\nFeature: Get users\r\n    In order to check users\r\n    ...\r\n<\/code><\/pre>\n
<\/h2>\n
Installation<\/h2>\n
composer require --dev behat\/behat\r\nvendor\/bin\/behat --init\r\n<\/code><\/pre>\n
La deuxi\u00e8me commande cr\u00e9er les fichiers d’init de Behat.<\/p>\n
<\/h2>\n
Coloration<\/h2>\n
Behat est nativement support\u00e9 par PHPStorm<\/a>, pour\u00a0Sublime Text<\/a>\u00a0il existe un package<\/a>\u00a0afin d’avoir la coloration syntaxique.
\n\"Behat<\/a>
\nLes valeurs en jaunes sont r\u00e9cup\u00e9r\u00e9es dans le code afin d’\u00eatre test\u00e9es.<\/p>\n
<\/h2>\n
Lancer les tests<\/h2>\n
Une fois les features cr\u00e9\u00e9es dans le dossier features\/<\/code>, on peut lancer les tests :<\/p>\n
vendor\/bin\/behat # toutes les features\r\nvendor\/bin\/behat features\/basket.feature # une feature en particulier\r\nvendor\/bin\/behat --tags backoffice # toutes les features qui ont le tag backoffice\r\n<\/code><\/pre>\n
Pour le moment pas grand chose \u00e0 tester, afin de cr\u00e9er automatiquement les fonctions et leurs arguments, voici la commande magique propos\u00e9e :<\/p>\n
vendor\/bin\/behat --dry-run --append-snippets\r\n<\/code><\/pre>\n
Behat cr\u00e9er les fonctions comme ceci :<\/p>\n
\/**\r\n * @Given there is a :arg1, which costs :arg2\u20ac\r\n *\/\r\npublic function thereIsAWhichCostsEur($arg1, $arg2)\r\n{\r\n    \r\n}\r\n\r\n\/**\r\n * @When I add the :arg1 to the basket\r\n *\/\r\npublic function iAddTheToTheBasket($arg1)\r\n{\r\n    \r\n}\r\n\r\n\/**\r\n * @Then I should have :arg1 product in the basket\r\n *\/\r\npublic function iShouldHaveProductInTheBasket($arg1)\r\n{\r\n    \r\n}\r\n\r\n\/**\r\n * @Then the overall basket price should be :arg1\u20ac\r\n *\/\r\npublic function theOverallBasketPriceShouldBeEur($arg1)\r\n{\r\n    \r\n}\r\n<\/code><\/pre>\n
Il ne reste plus qu\u2019\u00e0 remplir le contenu des fonctions avec du code m\u00e9tier, et d\u2019y ajouter quelques assertions PHPUnit.<\/p>\n
Exemple simple :<\/p>\n
use Behat\\Behat\\Context\\Context;\r\nuse PHPUnit\\Framework\\Assert;\r\n\r\nclass BasketContext implements Context\r\n{\r\n    const COST_SHIPPING = 4;\r\n\r\n    private $products = [];\r\n    private $basket = [];\r\n\r\n    public function __construct()\r\n    {\r\n    }\r\n\r\n    \/**\r\n     * @Given there is a :arg1, which costs :arg2\u20ac\r\n     *\/\r\n    public function thereIsAWhichCostsEur($arg1, $arg2)\r\n    {\r\n        $product = new \\stdClass();\r\n        $product->name = $arg1;\r\n        $product->price = $arg2;\r\n        $this->products[$product->name] = $product;\r\n    }\r\n\r\n    \/**\r\n     * @When I add the :arg1 to the basket\r\n     *\/\r\n    public function iAddTheToTheBasket($arg1)\r\n    {\r\n        if (\\array_key_exists($arg1, $this->products)) {\r\n            $this->basket[] = $this->products[$arg1];\r\n        }\r\n    }\r\n\r\n    \/**\r\n     * @Then I should have :arg1 product in the basket\r\n     *\/\r\n    public function iShouldHaveProductInTheBasket($arg1)\r\n    {\r\n        Assert::assertGreaterThan(0, \\count($this->basket));\r\n    }\r\n\r\n    \/**\r\n     * @Then the overall basket price should be :arg1\u20ac\r\n     *\/\r\n    public function theOverallBasketPriceShouldBeEur($arg1)\r\n    {\r\n        $amount = self::COST_SHIPPING;\r\n        foreach ($this->basket as $product) {\r\n            $amount += $product->price;\r\n        }\r\n\r\n        Assert::assertEquals($arg1, $amount);\r\n    }\r\n}\r\n<\/code><\/pre>\n