Αίτημα HTTP
***********

.[perex]
Η Nette ενθυλακώνει το αίτημα HTTP σε αντικείμενα με κατανοητό API παρέχοντας παράλληλα ένα φίλτρο εξυγίανσης.

Ένα αίτημα HTTP είναι ένα αντικείμενο [api:Nette\Http\Request], το οποίο λαμβάνετε περνώντας το με τη χρήση [dependency injection |dependency-injection:passing-dependencies]. Σε παρουσιαστές απλά καλείτε το `$httpRequest = $this->getHttpRequest()`.

Αυτό που είναι σημαντικό είναι ότι η Nette κατά τη [δημιουργία |#RequestFactory] αυτού του αντικειμένου, καθαρίζει όλες τις παραμέτρους εισόδου GET, POST και COOKIE καθώς και τα URLs από χαρακτήρες ελέγχου και άκυρες ακολουθίες UTF-8. Έτσι μπορείτε να συνεχίσετε με ασφάλεια να εργάζεστε με τα δεδομένα. Τα καθαρισμένα δεδομένα χρησιμοποιούνται στη συνέχεια σε παρουσιαστές και φόρμες.

→ [Εγκατάσταση και απαιτήσεις |@home#Installation]


Nette\Http\Request .[#toc-nette-http-request]
=============================================

Αυτό το αντικείμενο είναι αμετάβλητο. Δεν έχει setters, έχει μόνο ένα λεγόμενο wither `withUrl()`, το οποίο δεν αλλάζει το αντικείμενο, αλλά επιστρέφει ένα νέο instance με τροποποιημένη τιμή.


withUrl(Nette\Http\UrlScript $url): Nette\Http\Request .[method]
----------------------------------------------------------------
Επιστρέφει έναν κλώνο με διαφορετική διεύθυνση URL.


getUrl(): Nette\Http\UrlScript .[method]
----------------------------------------
Επιστρέφει τη διεύθυνση URL της αίτησης ως αντικείμενο [UrlScript |urls#UrlScript].

```php
$url = $httpRequest->getUrl();
echo $url; // https://nette.org/en/documentation?action=edit
echo $url->getHost(); // nette.org
```

Οι φυλλομετρητές δεν στέλνουν ένα τμήμα στον διακομιστή, οπότε το `$url->getFragment()` θα επιστρέψει ένα κενό αλφαριθμητικό.


getQuery(string $key=null): string|array|null .[method]
-------------------------------------------------------
Επιστρέφει τις παραμέτρους της αίτησης GET:

```php
$all = $httpRequest->getQuery();    // συστοιχία όλων των παραμέτρων URL
$id = $httpRequest->getQuery('id'); // επιστρέφει την παράμετρο GET 'id' (ή null)
```


getPost(string $key=null): string|array|null .[method]
------------------------------------------------------
Επιστρέφει παραμέτρους αίτησης POST:

```php
$all = $httpRequest->getPost();     // πίνακας όλων των παραμέτρων POST
$id = $httpRequest->getPost('id');  // επιστρέφει την παράμετρο POST 'id' (ή null)
```


getFile(string|string[] $key): Nette\Http\FileUpload|array|null .[method]
-------------------------------------------------------------------------
Επιστρέφει το [upload |#Uploaded Files] ως αντικείμενο [api:Nette\Http\FileUpload]:

```php
$file = $httpRequest->getFile('avatar');
if ($file->hasFile()) { // Ανέβηκε κάποιο αρχείο;
	$file->getUntrustedName(); // όνομα του αρχείου που έστειλε ο χρήστης
	$file->getSanitizedName(); // το όνομα χωρίς επικίνδυνους χαρακτήρες
}
```

Καθορίστε έναν πίνακα κλειδιών για την πρόσβαση στη δομή του υποδέντρου.

```php
//<input type="file" name="my-form[details][avatar]" multiple>
$file = $request->getFile(['my-form', 'details', 'avatar']);
```

Επειδή δεν μπορείτε να εμπιστευτείτε δεδομένα από το εξωτερικό και επομένως δεν βασίζεστε στη μορφή της δομής, αυτή η μέθοδος είναι ασφαλέστερη από την `$request->getFiles()['my-form']['details']['avatar']`, η οποία μπορεί να αποτύχει.


getFiles(): array .[method]
---------------------------
Επιστρέφει δέντρο [αρχείων μεταφόρτωσης |#Uploaded Files] σε κανονικοποιημένη δομή, με κάθε φύλλο μια περίπτωση του [api:Nette\Http\FileUpload]:

```php
$files = $httpRequest->getFiles();
```


getCookie(string $key): string|array|null .[method]
---------------------------------------------------
Επιστρέφει ένα cookie ή το `null` εάν δεν υπάρχει.

```php
$sessId = $httpRequest->getCookie('sess_id');
```


getCookies(): array .[method]
-----------------------------
Επιστρέφει όλα τα cookies:

```php
$cookies = $httpRequest->getCookies();
```


getMethod(): string .[method]
-----------------------------
Επιστρέφει τη μέθοδο HTTP με την οποία έγινε η αίτηση.

```php
echo $httpRequest->getMethod(); // GET, POST, HEAD, PUT
```


isMethod(string $method): bool .[method]
----------------------------------------
Ελέγχει τη μέθοδο HTTP με την οποία έγινε η αίτηση. Η παράμετρος δεν λαμβάνει υπόψη την πεζότητα.

```php
if ($httpRequest->isMethod('GET')) // ...
```


getHeader(string $header): ?string .[method]
--------------------------------------------
Επιστρέφει μια επικεφαλίδα HTTP ή το `null` εάν δεν υπάρχει. Η παράμετρος δεν λαμβάνει υπόψη την πεζότητα:

```php
$userAgent = $httpRequest->getHeader('User-Agent');
```


getHeaders(): array .[method]
-----------------------------
Επιστρέφει όλες τις επικεφαλίδες HTTP ως συσχετιστικό πίνακα:

```php
$headers = $httpRequest->getHeaders();
echo $headers['Content-Type'];
```


isSecured(): bool .[method]
---------------------------
Είναι η σύνδεση κρυπτογραφημένη (HTTPS); Ενδέχεται να χρειαστεί να [ρυθμίσετε έναν διακομιστή μεσολάβησης |configuration#HTTP proxy] για τη σωστή λειτουργία.


isSameSite(): bool .[method]
----------------------------
Το αίτημα προέρχεται από τον ίδιο (υπο)τομέα και ξεκινάει με κλικ σε έναν σύνδεσμο; Η Nette χρησιμοποιεί το cookie `_nss` (πρώην `nette-samesite`) για να το εντοπίσει.


isAjax(): bool .[method]
------------------------
Πρόκειται για αίτηση AJAX;


getRemoteAddress(): ?string .[method]
-------------------------------------
Επιστρέφει τη διεύθυνση IP του χρήστη. Ίσως χρειαστεί να [ρυθμίσετε έναν διακομιστή μεσολάβησης |configuration#HTTP proxy] για σωστή λειτουργία.


getRemoteHost(): ?string .[method deprecated]
---------------------------------------------
Επιστρέφει τη μετάφραση DNS της διεύθυνσης IP του χρήστη. Μπορεί να χρειαστεί να [ρυθμίσετε έναν μεσάζοντα |configuration#HTTP proxy] για τη σωστή λειτουργία.


getBasicCredentials(): ?string .[method]
----------------------------------------
Επιστρέφει τα διαπιστευτήρια [ελέγχου ταυτότητας Basic HTTP |https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication].

```php
[$user, $password] = $httpRequest->getBasicCredentials();
```


getRawBody(): ?string .[method]
-------------------------------
Επιστρέφει το σώμα της αίτησης HTTP:

```php
$body = $httpRequest->getRawBody();
```


detectLanguage(array $langs): ?string .[method]
-----------------------------------------------
Ανιχνεύει τη γλώσσα. Ως παράμετρος `$lang`, περνάμε έναν πίνακα με τις γλώσσες που υποστηρίζει η εφαρμογή και επιστρέφει αυτή που προτιμά ο φυλλομετρητής. Δεν είναι μαγικό, η μέθοδος απλώς χρησιμοποιεί την επικεφαλίδα `Accept-Language`. Εάν δεν επιτευχθεί καμία αντιστοιχία, επιστρέφει `null`.

```php
// Κεφαλίδα που αποστέλλεται από το πρόγραμμα περιήγησης: el-us;q=0.8,en;q=0.5,sl;q=0.3

$langs = ['hu', 'pl', 'en']; // Γλώσσες που υποστηρίζονται στην εφαρμογή
echo $httpRequest->detectLanguage($langs); // en
```


RequestFactory .[#toc-requestfactory]
=====================================

Το αντικείμενο της τρέχουσας αίτησης HTTP δημιουργείται από το [api:Nette\Http\RequestFactory]. Εάν γράφετε μια εφαρμογή που δεν χρησιμοποιεί DI container, δημιουργείτε ένα αίτημα ως εξής:

```php
$factory = new Nette\Http\RequestFactory;
$httpRequest = $factory->fromGlobals();
```

Το RequestFactory μπορεί να ρυθμιστεί πριν από την κλήση του `fromGlobals()`. Μπορούμε να απενεργοποιήσουμε όλη την εξυγίανση των παραμέτρων εισόδου από μη έγκυρες ακολουθίες UTF-8 χρησιμοποιώντας το `$factory->setBinary()`. Και επίσης να ρυθμίσουμε έναν διακομιστή μεσολάβησης, ο οποίος είναι σημαντικός για τη σωστή ανίχνευση της διεύθυνσης IP του χρήστη χρησιμοποιώντας το `$factory->setProxy(...)`.

Είναι δυνατό να καθαρίσουμε τις διευθύνσεις URL από χαρακτήρες που μπορεί να εισέλθουν σε αυτές λόγω κακώς υλοποιημένων συστημάτων σχολιασμού σε διάφορους άλλους ιστότοπους χρησιμοποιώντας φίλτρα:

```php
// αφαίρεση κενών από τη διαδρομή
$requestFactory->urlFilters['path']['%20'] = '';

// αφαίρεση τελείας, κόμματος ή δεξιάς παρένθεσης από το τέλος της διεύθυνσης URL
$requestFactory->urlFilters['url']['[.,)]$'] = '';

// καθαρίζει τη διαδρομή από διπλές κάθετες (προεπιλεγμένο φίλτρο)
$requestFactory->urlFilters['path']['/{2,}'] = '/';
```


Uploaded Files .[#toc-uploaded-files]
=====================================

Η μέθοδος `Nette\Http\Request::getFiles()` επιστρέφει ένα δέντρο από αρχεία upload σε μια κανονικοποιημένη δομή, με κάθε φύλλο μια περίπτωση του [api:Nette\Http\FileUpload]. Αυτά τα αντικείμενα ενθυλακώνουν τα δεδομένα που υποβάλλονται από τον `<input type=file>` στοιχείο της φόρμας.

Η δομή αντικατοπτρίζει την ονομασία των στοιχείων στην HTML. Στο απλούστερο παράδειγμα, αυτό μπορεί να είναι ένα μόνο ονομασμένο στοιχείο φόρμας που υποβάλλεται ως:

```latte
<input type="file" name="avatar">
```

Σε αυτή την περίπτωση, το `$request->getFiles()` επιστρέφει πίνακα:

```php
[
	'avatar' => /* FileUpload instance */
]
```

Το αντικείμενο `FileUpload` δημιουργείται ακόμη και αν ο χρήστης δεν ανέβασε κανένα αρχείο ή αν το ανέβασμα απέτυχε. Η μέθοδος `hasFile()` επιστρέφει true αν έχει σταλεί ένα αρχείο:

```php
$request->getFile('avatar')->hasFile();
```

Στην περίπτωση μιας εισόδου που χρησιμοποιεί σημειογραφία πίνακα για το όνομα:

```latte
<input type="file" name="my-form[details][avatar]">
```

Το επιστρεφόμενο δέντρο καταλήγει να μοιάζει ως εξής:

```php
[
	'my-form' => [
		'details' => [
			'avatar' => /* FileUpload instance */
		],
	],
]
```

Μπορείτε επίσης να δημιουργήσετε πίνακες αρχείων:

```latte
<input type="file" name="my-form[details][avatars][] multiple">
```

Σε μια τέτοια περίπτωση η δομή μοιάζει με:

```php
[
	'my-form' => [
		'details' => [
			'avatars' => [
				0 => /* FileUpload instance */,
				1 => /* FileUpload instance */,
				2 => /* FileUpload instance */,
			],
		],
	],
]
```

Ο καλύτερος τρόπος πρόσβασης στο δείκτη 1 ενός ένθετου πίνακα είναι ο εξής:

```php
$file = $request->getFile(['my-form', 'details', 'avatars', 1]);
if ($file instanceof FileUpload) {
	// ...
}
```

Επειδή δεν μπορείτε να εμπιστευτείτε δεδομένα από το εξωτερικό και επομένως δεν βασίζεστε στη μορφή της δομής, αυτή η μέθοδος είναι ασφαλέστερη από την `$request->getFiles()['my-form']['details']['avatars'][1]`, η οποία μπορεί να αποτύχει.


Επισκόπηση των μεθόδων `FileUpload` .{toc: FileUpload}
------------------------------------------------------


hasFile(): bool .[method]
-------------------------
Επιστρέφει `true` αν ο χρήστης έχει ανεβάσει ένα αρχείο.


isOk(): bool .[method]
----------------------
Επιστρέφει `true` αν το αρχείο μεταφορτώθηκε με επιτυχία.


getError(): int .[method]
-------------------------
Επιστρέφει τον κωδικό σφάλματος που σχετίζεται με το αρχείο που μεταφορτώθηκε. Είναι μία από τις σταθερές [UPLOAD_ERR_XXX |http://php.net/manual/en/features.file-upload.errors.php]. Εάν το αρχείο μεταφορτώθηκε με επιτυχία, επιστρέφει `UPLOAD_ERR_OK`.


move(string $dest) .[method]
----------------------------
Μετακινεί ένα αρχείο που έχει μεταφορτωθεί σε μια νέα θέση. Εάν το αρχείο προορισμού υπάρχει ήδη, θα αντικατασταθεί.

```php
$file->move('/path/to/files/name.ext');
```


getContents(): ?string .[method]
--------------------------------
Επιστρέφει τα περιεχόμενα του αρχείου που μεταφορτώθηκε. Εάν η μεταφόρτωση δεν ήταν επιτυχής, επιστρέφει `null`.


getContentType(): ?string .[method]
-----------------------------------
Ανιχνεύει τον τύπο περιεχομένου MIME του αρχείου που μεταφορτώθηκε με βάση την υπογραφή του. Εάν η μεταφόρτωση δεν ήταν επιτυχής ή η ανίχνευση απέτυχε, επιστρέφει `null`.

.[caution]
Απαιτεί την επέκταση PHP `fileinfo`.


getUntrustedName(): string .[method]
------------------------------------
Επιστρέφει το αρχικό όνομα του αρχείου, όπως αυτό υποβλήθηκε από το πρόγραμμα περιήγησης.

.[caution]
Μην εμπιστεύεστε την τιμή που επιστρέφει αυτή η μέθοδος. Ένας πελάτης θα μπορούσε να στείλει ένα κακόβουλο όνομα αρχείου με σκοπό να καταστρέψει ή να παραβιάσει την εφαρμογή σας.


getSanitizedName(): string .[method]
------------------------------------
Επιστρέφει το καθαρισμένο όνομα αρχείου. Περιέχει μόνο χαρακτήρες ASCII `[a-zA-Z0-9.-]`. Εάν το όνομα δεν περιέχει τέτοιους χαρακτήρες, επιστρέφει 'unknown'. Εάν το αρχείο είναι εικόνα JPEG, PNG, GIF ή WebP, επιστρέφει τη σωστή επέκταση αρχείου.

.[caution]
Απαιτεί την επέκταση PHP `fileinfo`.


getSuggestedExtension(): ?string .[method]{data-version:3.2.4}
--------------------------------------------------------------
Επιστρέφει την κατάλληλη επέκταση αρχείου (χωρίς την τελεία) που αντιστοιχεί στον τύπο MIME που εντοπίστηκε.

.[caution]
Απαιτεί την επέκταση PHP `fileinfo`.


getUntrustedFullPath(): string .[method]
----------------------------------------
Επιστρέφει την αρχική πλήρη διαδρομή όπως υποβλήθηκε από το πρόγραμμα περιήγησης κατά τη μεταφόρτωση καταλόγου. Η πλήρης διαδρομή είναι διαθέσιμη μόνο στην PHP 8.1 και άνω. Σε προηγούμενες εκδόσεις, αυτή η μέθοδος επιστρέφει το μη αξιόπιστο όνομα αρχείου.

.[caution]
Μην εμπιστεύεστε την τιμή που επιστρέφει αυτή η μέθοδος. Ένας πελάτης θα μπορούσε να στείλει ένα κακόβουλο όνομα αρχείου με σκοπό να καταστρέψει ή να παραβιάσει την εφαρμογή σας.


getSize(): int .[method]
------------------------
Επιστρέφει το μέγεθος του ανεβασμένου αρχείου. Εάν η μεταφόρτωση δεν ήταν επιτυχής, επιστρέφει `0`.


getTemporaryFile(): string .[method]
------------------------------------
Επιστρέφει τη διαδρομή της προσωρινής τοποθεσίας του αρχείου που μεταφορτώθηκε. Εάν η μεταφόρτωση δεν ήταν επιτυχής, επιστρέφει `''`.


isImage(): bool .[method]
-------------------------
Επιστρέφει `true` εάν το αρχείο που μεταφορτώθηκε είναι εικόνα JPEG, PNG, GIF ή WebP. Η ανίχνευση βασίζεται στην υπογραφή της. Η ακεραιότητα ολόκληρου του αρχείου δεν ελέγχεται. Μπορείτε να διαπιστώσετε αν μια εικόνα δεν είναι κατεστραμμένη, για παράδειγμα, προσπαθώντας να [τη φορτώσετε |#toImage].

.[caution]
Απαιτεί την επέκταση PHP `fileinfo`.


getImageSize(): ?array .[method]
--------------------------------
Επιστρέφει ένα ζεύγος `[width, height]` με τις διαστάσεις της μεταφορτωμένης εικόνας. Εάν η μεταφόρτωση δεν ήταν επιτυχής ή δεν είναι έγκυρη εικόνα, επιστρέφει `null`.


toImage(): Nette\Utils\Image .[method]
--------------------------------------
Φορτώνει μια εικόνα ως αντικείμενο [Image |utils:images]. Εάν η φόρτωση δεν ήταν επιτυχής ή δεν είναι έγκυρη εικόνα, πετάει μια εξαίρεση `Nette\Utils\ImageException`.