在Joomla中构建URL,您可以使用字符串拼接:
$url = $domain.'/index.php?option='.$option.'&view='.$view.'¶m1='.$value1;
这种方法对于简单的URL适用,但参数过多或需要URL标准化时,就会变得繁琐且易出错。例如,路径片段可能包含多余的斜杠,导致URL错误。
为了解决这个问题,Joomla提供了JoomlaUriUri
类(在Joomla 1.6及更早版本中称为JURI
)。该类遵循RFC 3986标准,简化了URL的解析和构建。它确保UTF-8安全操作,尤其适用于包含西里尔字母的域名。相比之下,原生PHP函数parse_url
在处理UTF-8方面存在不足。
示例:从URL中获取参数
use JoomlaUriUri;
$url = 'https://web-tolk.ru/dev/biblioteki?param=value';
$uri = new Uri($url);
echo $uri->getVar('param'); // 输出 'value'
在Joomla代码中构建URL
use JoomlaUriUri;
$uri = new Uri;
$uri->setHost('web-tolk.ru');
$uri->setScheme('https');
$uri->setPath('/dev/biblioteki'); // setPath() 自动添加前导斜杠
$vars = [
'param1' => 'value1',
'param2' => 'value2',
'param3' => 'value3',
];
$uri->setQuery($vars);
echo $uri->toString();
JoomlaUriUri
类的设计遵循清晰的层次结构:AbstractUri
类包含getter方法,Uri
类包含setter方法。 您可以查看libraries/vendor/joomla/uri/src/uri.php
和libraries/vendor/joomla/uri/src/abstracturi.php
文件了解详细信息。PhpStorm对Joomla有良好的支持,可以方便地查看类的方法和属性。
旧版本的文档仍然部分适用,但需要根据新的命名空间进行调整。
URL结构:
foo://example.com:8042/over/there?name=ferret#nose
_/ ______________/_________/ _________/ __/
| | | | |
scheme authority path query fragment
Joomla社区资源: