天天看點

Php url生成,URL生成 · ThinkPHP6.0完全開發手冊 · 看雲

ThinkPHP支援路由URL位址的統一生成,并且支援所有的路由方式,以及完美解決了路由位址的反轉解析,無需再為路由定義和變化而改變URL生成。

>[danger] 如果你開啟了路由延遲解析,需要生成路由映射緩存才能支援全部的路由位址的反轉解析。

URL生成使用 `\think\facade\Route::buildUrl()` 方法即可。該方法會傳回一個`think\route\Url`對象執行個體,因為使用了`__toString`方法,是以可以直接輸出路由位址。

```

echo \think\facade\Route::buildUrl();

```

如果是通過資料傳回用戶端,你可以先強制轉換為字元串類型後再傳回。

```

$url = (string) \think\facade\Route::buildUrl();

```

## 使用路由辨別

對使用不同的路由位址方式,位址表達式的定義有所差別。參數單獨通過第二個參數傳入,假設我們定義了一個路由規則如下:

~~~

Route::rule('blog/:id','blog/read');

~~~

在沒有指定路由辨別的情況下,可以直接使用路由位址來生成URL位址:

~~~

Route::buildUrl('blog/read', ['id' => 5, 'name' => 'thinkphp']);

~~~

如果我們在注冊路由的時候指定了路由辨別

~~~

Route::rule('blog/:id','blog/read')->name('blog_read');

~~~

那麼必須使用路由辨別來生成URL位址

~~~

Route::buildUrl('blog_read', ['id' => 5, 'name' => 'thinkphp']);

~~~

以上方法都會生成下面的URL位址:

~~~

/index.php/blog/5/name/thinkphp.html

~~~

如果你的環境支援REWRITE,那麼生成的URL位址會變為:

~~~

/blog/5/name/thinkphp.html

~~~

如果你配置了:

~~~

'url_common_param'=>true

~~~

那麼生成的URL位址變為:

~~~

/index.php/blog/5.html?name=thinkphp

~~~

不在路由規則裡面的變量會直接使用普通URL參數的方式。

> 需要注意的是,URL位址生成不會檢測路由的有效性,隻是按照給定的路由位址和參數生成符合條件的路由規則。

## 使用路由位址

我們也可以直接使用路由位址來生成URL,例如:

我們定義了路由規則如下:

~~~

Route::get('blog/:id' , 'blog/read');

~~~

可以使用下面的方式直接使用路由規則生成URL位址:

~~~

Route::buildUrl('/blog/5');

~~~

那麼自動生成的URL位址變為:

~~~

/index.php/blog/5.html

~~~

## URL字尾

預設情況下,系統會自動讀取`url_html_suffix`配置參數作為URL字尾(預設為html),如果我們設定了:

~~~

'url_html_suffix' => 'shtml'

~~~

那麼自動生成的URL位址變為:

~~~

/index.php/blog/5.shtml

~~~

如果我們設定了多個URL字尾支援

~~~

'url_html_suffix' => 'html|shtml'

~~~

則會取第一個字尾來生成URL位址,是以自動生成的URL位址還是:

~~~

/index.php/blog/5.html

~~~

如果你希望指定URL字尾生成,則可以使用:

~~~

Route::buildUrl('blog/read', ['id'=>5])->suffix('shtml');

~~~

## 域名生成

預設生成的URL位址是不帶域名的,如果你采用了多域名部署或者希望生成帶有域名的URL位址的話,就需要傳入第四個參數,該參數有兩種用法:

### 自動生成域名

~~~

Route::buildUrl('index/blog/read', ['id'=>5])

->suffix('shtml')

->domain(true);

~~~

第四個參數傳入`true`的話,表示自動生成域名,如果你開啟了`url_domain_deploy`還會自動識别比對目前URL規則的域名。

例如,我們注冊了域名路由資訊如下:

~~~

Route::domain('blog','index/blog');

~~~

那麼上面的URL位址生成為:

~~~

http://blog.thinkphp.cn/read/id/5.shtml

~~~

### 指定域名

你也可以顯式傳入需要生成位址的域名,例如:

~~~

Route::buildUrl('blog/read', ['id'=>5])->domain('blog');

~~~

或者傳入完整的域名

~~~

Route::buildUrl('index/blog/read', ['id'=>5])->domain('blog.thinkphp.cn');

~~~

生成的URL位址為:

~~~

http://blog.thinkphp.cn/read/id/5.shtml

~~~

也可以直接在第一個參數裡面傳入域名,例如:

~~~

Route::buildUrl('index/blog/[email protected]', ['id'=>5]);

Route::buildUrl('index/blog/[email protected]', ['id'=>5]);

~~~

## 生成錨點

支援生成URL的錨點,可以直接在URL位址參數中使用:

~~~

Route::buildUrl('index/blog/read#[email protected]', ['id'=>5]);

~~~

> 錨點和域名一起使用的時候,注意錨點在前面,域名在後面。

生成的URL位址為:

~~~

http://blog.thinkphp.cn/read/id/5.html#anchor

~~~

## 加上入口檔案

有時候我們生成的URL位址可能需要加上`index.php`或者去掉`index.php`,大多數時候系統會自動判斷,如果發現自動生成的位址有問題,可以使用下面的方法:

~~~

Route::buildUrl('index/blog/read', ['id'=>5])->root('/index.php');

~~~

## 助手函數

系統提供了一個`url`助手函數用于完成相同的功能,例如:

~~~

url('index/blog/read', ['id'=>5])

->suffix('html')

->domain(true)

->root('/index.php');

~~~