Add a deprecation warning helper.

This will make adding framework deprecation warnings we plan to add in
3.6.x simpler as they will be easier to write.

src/Core/functions.php

@@ -248,3 +248,16 @@ function env($key, $default = null)
     }
 
 }
+
+if (!function_exists('deprecationWarning')) {
+    /**
+     * Helper method for outputting deprecation warnings
+     *
+     * @param string $message The message to output as a deprecation warning.
+     * @return void
+     */
+    function deprecationWarning($message)
+    {
+        trigger_error($message, E_USER_DEPRECATED);
+    }
+}

tests/TestCase/Core/FunctionsTest.php

@@ -42,4 +42,13 @@ public function testEnv()
         $this->assertEquals('0', env('ZERO'));
         $this->assertEquals('0', env('ZERO', '1'));
     }
+
+    /**
+     * @expectedException PHPUnit\Framework\Error\Deprecated
+     * @expectedExceptionMessage This is going away
+     */
+    public function testDeprecationWarning()
+    {
+        deprecationWarning('This is going away');
+    }
 }