URL生成 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# URL生成 ## URL 生成用于生成URL鏈接地址，系統提供的助手函數為`url`。 **函數說明** ``` <pre class="calibre16">``` /** * Url生成 * @param string $url 路由地址 * @param array $vars 數組變量 * @param bool|string $suffix 生成的URL后綴，例如html，默認是html * @param bool|string $domain 域名 * @return UrlBuild */ function url(string $url = '', array $vars = [], $suffix = true, $domain = false): UrlBuild ``` ``` 模板使用方式 ``` <pre class="calibre16">``` {:url('/Index/demo')} ``` ``` ## 入口文件說明 url 生成跟入口文件配置掛鉤，這里為了兼容不支持偽靜態的默認是顯示入口文件的，如果你配置了偽靜態是可以選擇隱藏的，這樣生成的url地址不會帶入口文件。 ![](https://img.kancloud.cn/ee/29/ee29b530db8c768b4f7e9f1d62369812_652x395.png) ## 不使用路由方式生成 ### 1. 應用內訪問帶有參數形式生成，參數1的格式為：`url('控制器/操作方法')` ``` <pre class="calibre16">``` // url生成，默認是帶有html后綴的，url方法返回的是對象可方便額外的操作，使用(string)轉字符串 $url = (string) url('/index/demo',['aaa'=>1]); dd($url); // 輸出結果 ``` ``` 前臺入口文件隱藏后效果，如果未配置隱藏入口文件，則前面會有`/index.php/`，以下示例默認是配置了入口文件隱藏。 ``` <pre class="calibre16">``` /index/demo.html?aaa=1 ``` ``` 生成帶有域名的鏈接地址，第四個參數為`true`表示生成的鏈接地址加域名 ``` <pre class="calibre16">``` // 自動生成域名、加后綴 $url = (string)url('/demo/index',['aaa'=>1],'html',true); // 結果 http://xxx.cms.com/demo/index.html?aaa=1 ``` ``` 生成錨點示例，生成錨點注意前面不需要加`/`，如下 ``` <pre class="calibre16">``` // 錨點跟子域名同時存在時需要錨點在前，域名在后 $url = (string)url('index/demo#ddd',['aaa'=>1,'b'=>'sfsfs'],'',true); // 結果 http://xxx.cms.com:8080/index/demo?aaa=1&b=sfsfs#ddd ``` ``` ### 2. 訪問其他應用，域名綁定域名綁定配置在`config/app.php`中，目前有以下配置，這里配置好后記得在域名提供商做好解析。 ``` <pre class="calibre16">``` // 域名綁定 'domain_bind' => [ 'api' => 'api', '*' => 'index', ], ``` ``` 示例：生成錨點并綁定到`api`域名，通過生成后的鏈接即可訪問到`api`應用。提示：如果入口文件未配置隱藏，那么入口文件還是存在的。 ``` <pre class="calibre16">``` // 生成錨點，并綁定域名 $url = (string)url('index/demo#ddd@api',['aaa'=>1,'b'=>'sfsfs']); // 隱藏入口文件結果 http://api.cms.com/index/demo.html?aaa=1&b=sfsfs#ddd // 未隱藏結果 http://api.cms.com/index.php/index/demo.html?aaa=1&b=sfsfs#ddd ``` ``` 示例2：也可使用url方法的參數4來實現，如下 ``` <pre class="calibre16">``` // 指定子域名為api $url = (string)url('/index/demo',['aaa'=>1],'html','api'); // 也支持完整域名，如果不是80端口需要域名+端口 $url = (string)url('/index/demo',['aaa'=>1],'html','local.cms.com:8080'); ``` ``` ### 3. 訪問其他應用，入口文件如果不通過域名解析按入口文件來訪問，需要生成其他應用鏈接時可以通過以下寫法實現 ``` <pre class="calibre16">``` $url = (string)url('api:/index/demo',['aaa'=>1,'b'=>'sfsfs'],'',true); ``` ``` 生成結果 ``` <pre class="calibre16">``` http://local.cms.com/api.php/index/demo?aaa=1&b=sfsfs ``` ``` ## 使用路由方式生成了解這里前先了解路由定義，假設`index`應用配置了以下路由 ``` <pre class="calibre16">``` Route::rule('/demo','/index/demo'); ``` ``` 根據路由生成地址寫法如下，參數1的地址需要跟上面的參數2保持一致。 ``` <pre class="calibre16">``` $url = (string)url('/index/demo',['aaa'=>1]); ``` ``` 結果 ``` <pre class="calibre16">``` /demo.html?aaa=1 ``` ``` 使用域名 ``` <pre class="calibre20">``` $url = (string)url('/index/demo',['aaa'=>1],'',true); ``` ```