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