İstek Nesnesi
İstek nesnesi: Get, POST, Env, files vs gibi metotlarla gönderilen verileri almak, REQUEST globali gibi süper globallerden istekleri almak için kullanılan nesnedir.
Bu nesneden alınan post ve diğer metotlardan alınan veriler ile PHPnin kendi $POST gibi globallerinden alınan veriler aynı değildir. İstek nesnesinden alınan tüm veriler güvenlik ve kontrol fonksiyonlarından geçirilmektedir.
Bu nesne herhangi bir sabite sahip değildir.
Nesne Özellikleri (Metotlar)
İstek nesnesi toplam 11 adet metoda sahiptir. Tüm metotlar static olarak tanımlanmıştır.
1. requestUri
İstekde bulunulan url adresi almaya yarayan metottur. Geriye String veri döndürür. Url adresini parse ederek geri döndürür.
Yönetim panelinde anasayfasında bu metot çağırıldığında örnek kod:
echo Request::requestUri(); // Çıktı: /dashboard
2. requestFullUri
İstekte bulunan tam url adresini almaya yarayan metottur. Geriye String veri döndürür. Yukarıda metottan farklı olarak tanımlı url adresini istek adresine ekler.
Yukarıdaki örneğin aynısı için bu metot çağırıldığında örnek kod:
echo Request::requestFullUri(); // Çıktı: https://localhost/dashboard
3. post
Formdan POST methoduyla gönderilen verileri almaya ve parametreye değer atamaya yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini, bulunmaması durumunda False değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $key | Post parametresinin adını(key) belirtir. | String | Evet |
| $value | Post parametresinin yeni değerini belirtir. | Mixed | Hayır |
Formdan name adında bir değer gönderildiğini ve name değerinin test olduğunu düşünelim. Bunun için örnek kod:
echo Request::post("name"); // Çıktı: test
Bu metot sayesinde var olan bir post parametresinin değeri de değiştirilebilmektedir. Örnek kod:
Request::post("name", "yenideğer");
echo Request::post("name"); // Çıktı: yenideğer
Yukarıdaki kod bloğundan anlaşıldığı gibi metota ikinci bir parametreyi göndermemiz durumunda, birinci parametrenin değerini ikinci parametre ile değiştirmektedir.
Request::post("name"); // Post değerini alır.
Request::post("name", "test"); // Post değerini günceller.
4. get
Formdan GET methoduyla gönderilen verileri almaya ve parametreye değer atamaya yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini, bulunmaması durumunda False değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $key | Get parametresinin adını(key) belirtir. | String | Evet |
| $value | Get parametresinin yeni değerini belirtir. | Mixed | Hayır |
Yukarıdaki post metoduyla kullanımı aynıdır. Örnek kod:
Request::get("name"); // Get değerini alır.
Request::get("name", "test"); // Get değerini günceller.
5. env
Formdan ENV methoduyla gönderilen verileri almaya ve parametreye değer atamaya yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini, bulunmaması durumunda False değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $key | Env parametresinin adını(key) belirtir. | String | Evet |
| $value | Env parametresinin yeni değerini belirtir. | Mixed | Hayır |
Yukarıdaki post ve get metotlarıyla kullanımı aynıdır. Örnek kod:
Request::env("name"); // Env değerini alır.
Request::env("name", "test"); // Env değerini günceller.
6. server
SERVER globalinden değer almaya ve değeri değiştirmeye yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini, bulunmaması durumunda False değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $key | Server parametresinin adını(key) belirtir. | String | Evet |
| $value | Server parametresinin yeni değerini belirtir. | Mixed | Hayır |
SERVER metodu parametrelerinin büyük harfle gönderilmesine gerek yoktur.
Örnek kod:
echo Request::server("http_host"); // Çıktı: localhost
echo $_SERVER["HTTP_HOST"]; // Bu kodla eş değerdir.
7. request
REQUEST globalinden değer almaya ve değeri değiştirmeye yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini, bulunmaması durumunda False değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $key | Request parametresinin adını(key) belirtir. | String | Evet |
| $value | Request parametresinin yeni değerini belirtir. | Mixed | Hayır |
REQUEST metodu parametrelerinin büyük harfle gönderilmesine gerek yoktur.
Örnek kod:
echo Request::request("name"); // Çıktı: test
8. files
Formdan FILES methoduyla gönderilen dosyaları almaya yarayan metottur. Erişilmeye çalışılan parametre bulunması durumunda parametrenin değerini değerini döndürür. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $name | Files parametresinin adını(key) belirtir. | String | Evet |
| $type | Dosyanın hangi bilgisinin alınacağını belirtir. (name, size vs.) | String | Hayır |
Yukarıdaki post,get ve env metotlarıyla kullanımı aynıdır.
Formdan avatar adından bir dosya gönderildiğini varsayarsak bu dosyayı alabilmek için örnek kod:
Request::files("avatar");
Request::files("avatar", "size"); // Dosya boyutunu alır.
9. delete
Değer silmeye yarayan metottur. Geriye herhangi bir değer döndürmez. Metodun aldığı parametreler aşağıda listelenmiştir.
| Name | Info | Type | Constrait |
|---|---|---|---|
| $input | Hangi metotdan gelen parametrenin silineceğini belirtir. | String | Evet |
| $key | Silinecek parametreyi belirtir. | String | Evet |
Örnek kod:
Request::delete("post", "name"); // Post metoduyla gönderilen name değerini siler.
Request::delete("get", "name"); // Get metoduyla gönderilen name değerini siler.
Request::delete("env", "name"); // Env metoduyla gönderilen name değerini siler.
Request::delete("server", "http_host"); // Server globalinden gelen http_host değerini siler.
10. isAjax
Gönderilen isteğin bir ajax işlemi olup olmadığını bildiren metottur. Geriye Boolean veri döndürür.
echo Request::isAjax();
11. isCurl
Gönderilen isteğin bir CURL işlemi olup olmadığını bildiren metottur. Geriye Boolean veri döndürür.
echo Request::isCurl();