PHPSpec

What is PHPSpec?

PHPSpec is a development tool, designed to help you achieve clean and working PHP code by using a technique derived from test-first development called (spec) behaviour driven development, or SpecBDD.

Development Cycle

Quality

• External – what matters most for the customer.
• Internal – the maintainability of the source code.

Refactoring

The process of restructuring existing code without changing external behavior.

TDD vs SpecBDD

The difference is the language!

PHPUnit vs PHPSpec

$this->assertEquals(0, $result); // PHPUnit

$result->shoulBe(0);             // PHPSpec

Do not over test spec your code!

Matchers

• Identity
• Comparison
• Throw
• Type
• ObjectState
• Count
• Scalar
• Inline

Identity

$this->getRating()->shouldBe(5);
$this->getTitle()->shouldBeEqualTo("Star Wars");
$this->getReleaseDate()->shouldReturn(233366400);

===

Comparison

$this->getRating()->shouldBeLike('5');

==

Throw

$this->shouldThrow('\InvalidArgumentException')->duringSetRating(-3);
$this->shouldThrow('\InvalidArgumentException')->during('setRating', array(-3));
$this->shouldThrow(new \InvalidArgumentException("Invalid rating"))->during('setRating', array(-3));

Type

$this->shouldHaveType('Movie');
$this->shouldReturnAnInstanceOf('Movie');
$this->shouldBeAnInstanceOf('Movie');
$this->shouldImplement('Movie');

Object State

$this->shouldBeAvailableOnCinemas();
$this->shouldHaveSoundtrack();

Count

$this->getItems()->shouldHaveCount(3);

Scalar

$this->getTitle()->shouldBeString();
$this->getPrice()->shouldBeFloat();
$this->getItems()->shouldBeArray();

Inline

class MovieSpec extends ObjectBehavior
{
    function it_should_have_some_specific_options_by_default()
    {
        $this->getOptions()->shouldHaveKey('username');
        $this->getOptions()->shouldHaveValue('diegoholiveira');
    }

    public function getMatchers()
    {
        return [
            'haveKey' => function($subject, $key) {
                return array_key_exists($key, $subject);
            },
            'haveValue' => function($subject, $value) {
                return in_array($value, $subject);
            },
        ];
    }
}

Formatters

• progress
• html
• pretty
• junit
• dot

Stubs

$converter
    ->convert(80, 'USD')
    ->willReturn(106.54621543)
;

Mocks

$converter
    ->convert(80, 'USD')
    ->shouldBeCalled()
;

Templates

• specification
• class
• method

Templates

1. {project_directory}/.phpspec/{template_name}.tpl
2. {home_directory}/.phpspec/{template_name}.tpl
3. Use the default template

Templates

• %filepath% the file path of the class
• %name% the class name
• %namespace% the class namespace
• %namespace_block% the formatted class namespace

Templates

<?php

/**
 * This file is part of the PHP Summer Camp workshop.
 *
 * @author PHPSpec developers
 */

namespace %namespace%;

class %name%
{
}

.phpspec/class.tpl

Configuration

phpspec.yml

Extensions

extensions:
  - Cjm\PhpSpec\Extension\TypeHintedMethodsExtension