added PHPMockery::define()

Author: malkusch

README.md

@@ -33,6 +33,21 @@ assert (3 == time());
 \Mockery::close();
 ```
 
+## Restrictions
+
+This library comes with the same restrictions as the underlying
+[`php-mock`](https://github.com/php-mock/php-mock#requirements-and-restrictions):
+
+* Only *unqualified* function calls in a namespace context can be mocked.
+  E.g. a call for `time()` in the namespace `foo` is mockable,
+  a call for `\time()` is not.
+
+* The mock has to be defined before the first call to the unqualified function
+  in the tested class. This is documented in [Bug #68541](https://bugs.php.net/bug.php?id=68541).
+  In most cases you can ignore this restriction. But if you happen to run into
+  this issue you can call [`PHPMockery::define()`](http://php-mock.github.io/php-mock-mockery/api/class-phpmock.mockery.PHPMockery.html#_define)
+  before that first call. This would define a side effectless namespaced function.
+
 # License and authors
 
 This project is free and under the WTFPL.

classes/PHPMockery.php

@@ -61,4 +61,33 @@ public static function mock($namespace, $name)
 
         return $expectation;
     }
+    
+    /**
+     * Defines the mocked function in the given namespace.
+     *
+     * In most cases you don't have to call this method. {@link mock()}
+     * is doing this for you. But if the mock is defined after the first call in the
+     * tested class, the tested class doesn't resolve to the mock. This is
+     * documented in Bug #68541. You therefore have to define the namespaced
+     * function before the first call.
+     *
+     * Defining the function has no side effects. If the function was
+     * already defined this method does nothing.
+     *
+     * @see mock()
+     * @link https://bugs.php.net/bug.php?id=68541 Bug #68541
+     *
+     * @param string $namespace The function namespace.
+     * @param string $name      The function name.
+     */
+    public static function define($namespace, $name)
+    {
+        $builder = new MockBuilder();
+        $builder->setNamespace($namespace)
+                ->setName($name)
+                ->setFunction(function () {
+                })
+                ->build()
+                ->define();
+    }
 }

tests/PHPMockeryTest.php

@@ -21,6 +21,11 @@ protected function disableMocks()
     {
         Mockery::close();
     }
+    
+    protected function defineFunction($namespace, $functionName)
+    {
+        PHPMockery::define($namespace, $functionName);
+    }
 
     protected function mockFunction($namespace, $functionName, callable $function)
     {