URL Yardımcı Programı

Url, UrlImmutable ve UrlScript sınıfları URL'leri yönetmeyi, ayrıştırmayı ve değiştirmeyi kolaylaştırır.

→ Kurulum ve gereksinimler

Url

Nette\Http\Url sınıfı, URL ve bu diyagramda ana hatlarıyla belirtilen bileşenleriyle çalışmayı kolaylaştırır:

scheme  user  password  host   port    path        query  fragment
  |      |      |        |      |       |            |       |
/--\   /--\ /------\ /-------\ /--\/----------\ /--------\ /----\
http://john:xyz%2A12@nette.org:8080/en/download?name=param#footer
\______\__________________________/
    |               |
 hostUrl        authority

URL oluşturma sezgiseldir:

use Nette\Http\Url;

$url = new Url;
$url->setScheme('https')
	->setHost('localhost')
	->setPath('/edit')
	->setQueryParameter('foo', 'bar');

echo $url; // 'https://localhost/edit?foo=bar'

Ayrıca URL'yi ayrıştırabilir ve ardından değiştirebilirsiniz:

$url = new Url(
	'http://john:xyz%2A12@nette.org:8080/en/download?name=param#footer',
);

Url sınıfı, JsonSerializable arayüzünü uygular ve __toString() yöntemini sağlayarak nesneyi yazdırmayı veya json_encode() ile kullanmayı mümkün kılar.

echo $url;
echo json_encode([$url]);

URL Components

Tek tek URL bileşenlerini almak veya değiştirmek için aşağıdaki yöntemler kullanılabilir:

Uyarı: Bir HTTP isteğinden elde edilen bir URL ile çalışırken, tarayıcı bunu sunucuya göndermediği için parçayı içermeyeceğini unutmayın.

Ayrıca tek tek sorgu parametreleri ile de işlem yapabiliriz:

getDomain (int $level = 2): string

Ana bilgisayarın sağ veya sol kısmını döndürür. Ana bilgisayar www.nette.org ise şu şekilde çalışır:

isEqual (string|Url $anotherUrl): bool

İki URL'nin aynı olup olmadığını kontrol eder.

$url->isEqual('https://nette.org');

Url::isAbsolute (string $url): bool

Bir URL'nin mutlak olup olmadığını kontrol eder. Bir URL, bir şema (örn. http, https, ftp) ve ardından iki nokta üst üste ile başlıyorsa mutlak olarak kabul edilir.

Url::isAbsolute('https://nette.org');    // true
Url::isAbsolute('//nette.org');          // false

Url::removeDotSegments (string $path): string

. ve .. özel segmentlerini kaldırarak bir URL yolunu normalleştirir. Bu yöntem, tarayıcıların yaptığı gibi gereksiz yol öğelerini kaldırır.

Url::removeDotSegments('/path/../subtree/./file.txt');  // '/subtree/file.txt'
Url::removeDotSegments('/../foo/./bar');                // '/foo/bar'
Url::removeDotSegments('./today/../file.txt');          // 'file.txt'

UrlImmutable

Nette\Http\UrlImmutable sınıfı Url sınıfına değişmez bir alternatiftir (PHP'de DateTimeImmutable 'in DateTime 'ye değişmez bir alternatif olmasına benzer şekilde). Setter'lar yerine, nesneyi değiştirmeyen ancak değiştirilen değerle yeni örnekler döndüren wither'lara sahiptir:

use Nette\Http\UrlImmutable;

$url = new UrlImmutable(
	'http://john:xyz%2A12@nette.org:8080/en/download?name=param#footer',
);

$newUrl = $url
	->withUser('')
	->withPassword('')
	->withPath('/en/');

echo $newUrl; // 'http://nette.org:8080/en/?name=param#footer'

UrlImmutable sınıfı, JsonSerializable arayüzünü uygular ve nesneyi yazdırmanıza veya json_encode() ile kullanmanıza olanak tanıyan __toString() yöntemini sağlar.

echo $url;
echo json_encode([$url]);

URL Components

Tek tek URL bileşenlerini almak veya değiştirmek için aşağıdaki yöntemler kullanılabilir:

withoutUserInfo() yöntemi user ve password adreslerini kaldırır.

Ayrıca kullanarak tek tek sorgu parametreleri ile de işlem yapabiliriz:

getDomain (int $level = 2): string

Ana bilgisayarın sağ veya sol kısmını döndürür. Ana bilgisayar www.nette.org ise şu şekilde çalışır:

resolve (string $reference): UrlImmutable

Mutlak bir URL'yi, bir tarayıcının HTML sayfasındaki bağlantıları işlediği şekilde çözümler:

• Bağlantı mutlak bir URL ise (bir şema içeriyorsa), değiştirilmeden kullanılır.
• Bağlantı // ile başlıyorsa, yalnızca geçerli URL'deki şema uygulanır.
• Bağlantı / ile başlıyorsa, etki alanı kökünden mutlak bir yol oluşturulur.
• Diğer durumlarda, URL geçerli yola göre oluşturulur.

$url = new UrlImmutable('https://example.com/path/page');
echo $url->resolve('../foo');           // 'https://example.com/foo'
echo $url->resolve('/bar');             // 'https://example.com/bar'
echo $url->resolve('sub/page.html');    // 'https://example.com/path/sub/page.html'

isEqual (string|Url $anotherUrl): bool

İki URL'nin aynı olup olmadığını kontrol eder.

$url->isEqual('https://nette.org');

UrlScript

Nette\Http\UrlScript sınıfı UrlImmutable sınıfının soyundan gelir ve onu projenin kök dizini vb. gibi ek sanal URL bileşenleriyle genişletir. Ana sınıfı gibi, değişmez bir nesnedir.

Aşağıdaki şemada UrlScript'in tanıdığı bileşenler gösterilmektedir:

     baseUrl    basePath  relativePath  relativeUrl
        |          |        |               |
/---------------/-----\/--------\---------------------------\
http://nette.org/admin/script.php/pathinfo/?name=param#footer
                \_______________/\________/
                       |              |
                  scriptPath       pathInfo

• baseUrl alan adı ve uygulamanın kök dizinine giden yolun bir kısmını içeren uygulamanın temel URL'sidir
• basePath uygulamanın kök dizinine giden yolun bir parçasıdır
• scriptPath geçerli betiğin yoludur
• relativePath basePath'e göre kod adıdır (ve muhtemelen ek yol segmentleridir)
• relativeUrl, sorgu dizesi ve parça dahil olmak üzere URL'nin baseUrl'den sonraki tüm kısmıdır.
• pathInfo, URL'nin komut dosyası adından sonra artık nadiren kullanılan bir parçasıdır

Bu parçaları almak için aşağıdaki yöntemler kullanılabilir:

Doğrudan UrlScript nesnesi oluşturmuyoruz, ancak Nette\Http\Request::getUrl() yöntemi bunu döndürüyor.