Added Path::normalize()

Author: webmozart

CHANGELOG.md

@@ -1,6 +1,10 @@
 Changelog
 =========
 
+* 2.2.0 (2015-08-14)
+
+ * added `Path::normalize()`
+
 * 2.1.0 (2015-07-14)
 
  * `Path::canonicalize()` now turns `~` into the user's home directory on

src/Path.php

@@ -139,6 +139,30 @@ public static function canonicalize($path)
         return $canonicalPath;
     }
 
+    /**
+     * Normalizes the given path.
+     *
+     * During normalization, all slashes are replaced by forward slashes ("/").
+     * Contrary to {@link canonicalize()}, this method does not remove invalid
+     * or dot path segments. Consequently, it is much more efficient and should
+     * be used whenever the given path is known to be a valid, absolute system
+     * path.
+     *
+     * This method is able to deal with both UNIX and Windows paths.
+     *
+     * @param string $path A path string.
+     *
+     * @return string The normalized path.
+     *
+     * @since 2.2 Added method.
+     */
+    public static function normalize($path)
+    {
+        Assert::string($path, 'The path must be a string. Got: %s');
+
+        return str_replace('\\', '/', $path);
+    }
+
     /**
      * Returns the directory part of the path.
      *

tests/PathTest.php

@@ -1287,4 +1287,17 @@ public function testGetHomeDirectoryForWindows()
 
         $this->assertEquals('C:/users/webmozart', Path::getHomeDirectory());
     }
+
+    public function testNormalize()
+    {
+        $this->assertSame('C:/Foo/Bar/test', Path::normalize('C:\\Foo\\Bar/test'));
+    }
+
+    /**
+     * @expectedException \InvalidArgumentException
+     */
+    public function testNormalizeFailsIfNoString()
+    {
+        Path::normalize(true);
+    }
 }