HOWTO · PHP

Ottieni l'URL completo corrente in PHP

Questo tutorial introduce come ottenere l'URL corrente in PHP

In questa pagina

Per esaminare o comporre l’URL della richiesta corrente di PHP, combina schema, host e URI della richiesta. Può essere utile quando si renderizza una pagina in base ai parametri della query o si registra l’indirizzo richiesto. Un URL composto è solo un dato: per usarlo in un reindirizzamento occorre comunque stabilire quali destinazioni sono consentite.

Comporre l’URL corrente dai dati della richiesta

PHP non fornisce un unico valore $_SERVER che corrisponda sempre all’intero URL corrente. Il server espone singoli dati della richiesta e l’applicazione combina quelli necessari. In una normale richiesta web, lo schema è http oppure https, l’host può includere una porta e l’URI della richiesta contiene il percorso e la stringa di query.

Leggere schema, host e URI della richiesta da $_SERVER

$_SERVER è un array superglobale popolato dal server web e dal runtime. $_SERVER['HTTP_HOST'] fornisce l’host richiesto, mentre $_SERVER['REQUEST_URI'] contiene di solito il percorso e la stringa di query. Nessuno dei due valori, da solo, costituisce un URL completo. L’host deriva dalla richiesta in ingresso, quindi va trattato come input non attendibile: convalidalo rispetto agli host conosciuti prima di usarlo in output sensibili per la sicurezza, come un reindirizzamento o un link assoluto in un’e-mail.

Gestire HTTPS e le richieste dietro un proxy

Quando PHP riceve direttamente la richiesta tramite TLS, $_SERVER['HTTPS'] è comunemente impostato su un valore non vuoto, per esempio on. Controlla questo valore prima di scegliere lo schema e non presumere che tutti i server lo impostino allo stesso modo. Potrebbe essere disponibile anche $_SERVER['REQUEST_SCHEME'], ma la sua disponibilità e il suo significato dipendono dalla configurazione del server.

In una configurazione con reverse proxy, il browser può connettersi tramite HTTPS mentre il proxy si connette a PHP tramite HTTP. In tal caso, il valore HTTPS diretto può descrivere solo la connessione dal proxy a PHP. Un’intestazione che indica lo schema inoltrato può essere utile solo se l’applicazione si trova dietro un proxy fidato e configurato appositamente, che rimuove o sostituisce i valori inviati dal client. Non fidarti delle intestazioni inoltrate provenienti da richieste qualsiasi. Configura questa fiducia sia nel proxy sia nell’applicazione, oppure usa lo schema fornito in modo affidabile dal server.

Includere il percorso e la stringa di query

$_SERVER['REQUEST_URI'] contiene spesso un valore come /products.php?category=books&page=2; aggiungerlo conserva sia il percorso sia la stringa di query. Non include lo schema né l’host. La stringa di query può contenere dati privati o sensibili: valuta se inserirla nei log, nell’output della pagina o in un URL inviato per e-mail. Non considerare l’URI della richiesta un URL canonico senza tenere conto del routing dell’applicazione e della configurazione di distribuzione.

Scegliere un metodo e verificare il risultato

Per una normale richiesta gestita direttamente dal server web, combina esplicitamente i valori forniti dal server. Questo esempio autonomo usa valori rappresentativi della richiesta per rendere chiaro come comporre l’URL. Non è stato eseguito in questa fase di scrittura:

Il codice e le etichette o gli output visibili in questa sezione restano in inglese.

<?php
$_SERVER = [
    'HTTPS' => 'on',
    'HTTP_HOST' => 'shop.example.test',
    'REQUEST_URI' => '/products.php?category=books&page=2',
];

$isHttps = isset($_SERVER['HTTPS'])
    && $_SERVER['HTTPS'] !== ''
    && strtolower((string) $_SERVER['HTTPS']) !== 'off';
$scheme = $isHttps ? 'https' : 'http';
$host = $_SERVER['HTTP_HOST'];
$requestUri = $_SERVER['REQUEST_URI'];
$currentUrl = $scheme . '://' . $host . $requestUri;

echo $currentUrl, PHP_EOL;

La stringa risultante combina schema, host e URI della richiesta. Nell’applicazione, usa i valori effettivi della richiesta e verifica come vengono popolati dal server web e da eventuali proxy fidati. Convalida l’host prima di usare il risultato in un reindirizzamento: comporre l’URL corrente non rende sicura una destinazione di reindirizzamento arbitraria.