Merge pull request yiisoft#2501 from yiisoft/unify-urls

Fixes yiisoft#2426: Changed URL creation method signatures to be consistent

url.md

@@ -21,8 +21,8 @@ Creating URLs
 The most important rule for creating URLs in your site is to always do so using the URL manager. The URL manager is a built-in application component named `urlManager`. This component is accessible from both web and console applications via
 `\Yii::$app->urlManager`. The component makes availabe the two following URL creation methods:
 
-- `createUrl($route, $params = [])`
-- `createAbsoluteUrl($route, $params = [])`
+- `createUrl($params)`
+- `createAbsoluteUrl($params, $schema = null)`
 
 The `createUrl` method creates an URL relative to the application root, such as `/index.php/site/index/`.
 The `createAbsoluteUrl` method creates an URL prefixed with the proper protocol and hostname:
@@ -33,9 +33,9 @@ generating RSS feeds etc.
 Some examples:
 
 ```php
-echo \Yii::$app->urlManager->createUrl('site/page', ['id' => 'about']);
+echo \Yii::$app->urlManager->createUrl(['site/page', 'id' => 'about']);
 // /index.php/site/page/id/about/
-echo \Yii::$app->urlManager->createUrl('date-time/fast-forward', ['id' => 105])
+echo \Yii::$app->urlManager->createUrl(['date-time/fast-forward', 'id' => 105])
 // /index.php?r=date-time/fast-forward&id=105
 echo \Yii::$app->urlManager->createAbsoluteUrl('blog/post/index');
 // http://www.example.com/index.php/blog/post/index/
@@ -56,15 +56,15 @@ Inside a web application controller, you can use the controller's `createUrl` sh
 
 ```php
 echo $this->createUrl(''); // currently active route
-echo $this->createUrl('view', ['id' => 'contact']); // same controller, different action
+echo $this->createUrl(['view', 'id' => 'contact']); // same controller, different action
 echo $this->createUrl('post/index'); // same module, different controller and action
 echo $this->createUrl('/site/index'); // absolute route no matter what controller is making this call
 echo $this->createurl('hi-tech'); // url for the case sensitive action `actionHiTech` of the current controller
-echo $this->createurl('/date-time/fast-forward', ['id' => 105]); // url for action the case sensitive controller, `DateTimeController::actionFastForward`
+echo $this->createurl(['/date-time/fast-forward', 'id' => 105]); // url for action the case sensitive controller, `DateTimeController::actionFastForward`
 ```
 
 > **Tip**: In order to generate URL with a hashtag, for example `/index.php?r=site/page&id=100#title`, you need to
-  specify the parameter named `#` using `$this->createUrl('post/read', ['id' => 100, '#' => 'title'])`.
+  specify the parameter named `#` using `$this->createUrl(['post/read', 'id' => 100, '#' => 'title'])`.
 
 Customizing URLs
 ----------------
@@ -115,8 +115,8 @@ Let's use some examples to explain how URL rules work. We assume that our rule s
 ```
 
 - Calling `$this->createUrl('post/list')` generates `/index.php/posts`. The first rule is applied.
-- Calling `$this->createUrl('post/read', ['id' => 100])` generates `/index.php/post/100`. The second rule is applied.
-- Calling `$this->createUrl('post/read', ['year' => 2008, 'title' => 'a sample post'])` generates
+- Calling `$this->createUrl(['post/read', 'id' => 100])` generates `/index.php/post/100`. The second rule is applied.
+- Calling `$this->createUrl(['post/read', 'year' => 2008, 'title' => 'a sample post'])` generates
   `/index.php/post/2008/a%20sample%20post`. The third rule is applied.
 - Calling `$this->createUrl('post/read')` generates `/index.php/post/read`. None of the rules is applied, convention is used
   instead.