Mockery

A short talk about Mockery, how to start using it, what are it's different parts, some gotchas and real-life examples that are bit more complicated than what fits into the official documentation.

Presented at the phpnl15 uncon.

Transcript

1. Mockery
   ●
   @robertbasic
   ●
   https://github.com/robertbasic/
   ●
   http://robertbasic.com/
   

   View Slide

2. Problems with unit testing
   ●
   Code that uses 3rd party services and APIs
   ●
   Databases
   ●
   Parts of our code that are not relevant to the
   code we are testing
   

   View Slide

3. How do we fix it?
   ●
   Avoid calls to the database
   ●
   Avoid calls to 3rd party services and APIs
   ●
   Avoid calls to parts of our own code
   ●
   Mock out the moving bits
   

   View Slide

4. What to use?
   ●
   A mocking framework
   ●
   PHPUnit's built-in mock stuff
   ●
   FBMock
   ●
   Phake
   ●
   ...
   

   View Slide

5. Mockery!
   

   View Slide

6. What's Mockery?
   ●
   A framework to mock objects
   ●
   Easy to use with PHPUnit (and maybe other
   unit testing tools?)
   ●
   Makes mocking a lot saner than the built-in
   PHPUnit stuff
   ●
   Developed by @padraicb and lots of help from
   @davedevelopment
   

   View Slide

7. Installing
   ●
   composer require mockery/mockery
   ●
   https://github.com/padraic/mockery
   

   View Slide

8. Connect with PHPUnit
   ●
   Add the listener in phpunit.xml
   

   View Slide

9. Bootstrap
   ●
   Set up autoloading and stuff
   

   View Slide

10. A simple example
    ●
    Foo has a dependency on Bar
    ●
    Foo calls a method on Bar that returns
    something
    ●
    We don't want to call the real Bar's method,
    but a mock
    ●
    This gets more complicated in real life
    

    View Slide

11. A simple example
    

    View Slide

12. Expectations for method calls
    ●
    shouldReceive('methodName');
    ●
    once(), twice(), zeroOrMoreTimes(), times(n),
    never()
    ●
    If no expectation is set on the number of calls,
    it will surprise you.
    

    View Slide

13. Expectations for method calls
    

    View Slide

14. Argument validation
    ●
    with($param1, $param2);
    ●
    withAnyArgs();
    ●
    withNoArgs();
    ●
    with(m::type('\Foo\Bar'));
    ●
    with(m::on(closure));
    ●
    with($regex);
    

    View Slide

15. Return values
    ●
    andReturn($value);
    ●
    andReturn($firstRun, $secondRun, $thirdRun);
    ●
    andReturnUsing(function($x) { return $x * 2 });
    ●
    andThrow(Exception);
    

    View Slide

16. But you can also read all that in the
    documentation
    

    View Slide

17. Some REAL examples
    

    View Slide

18. Don't touch the database!
    

    View Slide

19. Don't call that service!
    

    View Slide

20. Don't call that code!
    

    View Slide

21. Mocking hard dependencies
    ●
    You know all those “new” statements in your
    legacy code?
    ●
    http://robertbasic.com/blog/mocking-hard-
    dependencies-with-mockery
    ●
    https://github.com/robertbasic/mockery-
    hard-dependency
    

    View Slide

22. Closure to validate arguments
    

    View Slide

23. Regex to validate arguments
    

    View Slide

24. Crazy bits
    ●
    Doesn't do a diff on method arguments that
    are arrays
    ●
    Reflection can go nuts with PHP classes
    ●
    __magic methods... yea, don't.
    

    View Slide

25. Thanks!
    ●
    Questions?
    ●
    @robertbasic
    ●
    https://github.com/padraic/mockery
    

    View Slide