Библиотека для работы с путями и url.
Перерожденный репозиторий vinogradsoft/compass. Все проекты этого аккаунта использующие эту библиотеку будут обновлены для работы с
vinogradsoft/compass.
PHP >=8.0
Предпочтительный способ установки - через composer.
Запустите команду
php composer require vinogradsoft/path "2.1.0"
или добавьте в composer.json
"vinogradsoft/path": "^2.1.0"
<?php
use Vinograd\Path\Path;
require_once dirname(__DIR__, 1) . '/vendor/autoload.php';
$path = new Path('/__NAME__/__NAME__Scanner/__NAME2__Driver');
$path->replaceAll([
'__NAME__' => 'User',
'__NAME2__' => 'Filesystem',
]);
$path->updateSource();
echo '<br>', $path;
$path->setAll(['path','to','file.txt']);
$path->updateSource();
echo '<br>', $path;Результат:
/User/UserScanner/FilesystemDriver
path/to/file.txt
Поддержка рассчитана на генерацию url в различных билдерах. Схема показывает какие данные можно получать и модифицировать.
|---------------------------------------absolute url---------------------------------|
| |
|-----------------base url----------------|------------------relative url------------|
| | |
| authority | path query fragment|
| /‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\|/‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾\ /‾‾‾‾‾‾‾‾\ /‾‾‾‾‾‾\|
|https://grigor:[email protected]:8080/path/to/resource.json?query=value#fragment|
\__/ \___/ \_____/ \___________/ \__/ \___/
scheme user password host port suffix
<?php
require_once dirname(__DIR__, 1) . '/vendor/autoload.php';
use \Vinograd\Path\Url;
$url = Url::createBlank();
$url->setScheme('https')
->setUser('grigor')
->setPassword('pass@word')
->setHost('host.ru')
->setPort('8088')
->setPath('/user/index')
->setSuffix('.php')
->setArrayQuery([
'key1' => 'value1',
'key2' => 'value2'
])->setFragment('fragment');
$url->updateSource();
printUrl($url);
echo '<br><br>####################################';
$url = new Url('https://grigor:pass%[email protected]:8088/user/index?key1=value1&key2=value2#fragment');
$url->setSuffix('.php');
$url->updateSource();
printUrl($url);
function printUrl($url)
{
echo '<br><b>Authority:</b> ', $url->getAuthority();
echo '<br><b>BaseUrl:</b> ', $url->getBaseUrl();
echo '<br><b>RelativeUrl:</b> ', $url->getRelativeUrl();
echo '<br><b>AbsoluteUrl:</b> ', $url; //$url->getSource();
echo '<br>';
echo '<br><b>getScheme:</b> ', $url->getScheme();
echo '<br><b>getUser:</b> ', $url->getUser();
echo '<br><b>getPassword:</b> ', $url->getPassword();
echo '<br><b>getHost:</b> ', $url->getHost();
echo '<br><b>getPort:</b> ', $url->getPort();
echo '<br><b>getPath:</b> ', $url->getPath();
echo '<br><b>getSuffix:</b> ', $url->getSuffix();
echo '<br><b>getQuery:</b> ', $url->getQuery();
echo '<br><b>getFragment:</b> ', $url->getFragment();
}Результат:
Authority: grigor:pass%[email protected]:8088
BaseUrl: https://grigor:pass%[email protected]:8088
RelativeUrl: /user/index.php?key1=value1&key2=value2#fragment
AbsoluteUrl: https://grigor:pass%[email protected]:8088/user/index.php?key1=value1&key2=value2#fragment
getScheme: https
getUser: grigor
getPassword: pass@word
getHost: host.ru
getPort: 8088
getPath: /user/index.php
getSuffix: .php
getQuery: key1=value1&key2=value2
getFragment: fragment
####################################
Authority: grigor:pass%[email protected]:8088
BaseUrl: https://grigor:pass%[email protected]:8088
RelativeUrl: /user/index.php?key1=value1&key2=value2#fragment
AbsoluteUrl: https://grigor:pass%[email protected]:8088/user/index.php?key1=value1&key2=value2#fragment
getScheme: https
getUser: grigor
getPassword: pass@word
getHost: host.ru
getPort: 8088
getPath: /user/index.php
getSuffix: .php
getQuery: key1=value1&key2=value2
getFragment: fragment
По умолчанию созданный url ни как не кодируется. Такое поведение можно изменить написав свою стратегию создания url, реализовав интерфейс \Vinograd\Path\UrlStrategy. По умолчанию используется \Vinograd\Path\DefaultUrlStrategy, для передачи на постобработку созданного url внешним системам - шаблонизаторам с возможностью кодирования и/или другим системам.