Molti di voi conosceranno cURL, anch’esso un HTTP Client disponibile per PHP.
Sebbene sia molto diffuso, non tutte le configurazioni di PHP prevedono questa libreria di default ed alcune impostazioni, come safe mode, potrebbero limitarne l’uso. Inoltre, è opinione diffusa che il suo utilizzo non sia troppo “elegante”.

Zend_Http_Client supporta quasi tutte le funzionalità di cURL e molti altri client HTTP: autenticazione, Cookie, CookieJar, redirect ed offre un completo set di metodi per analizzare la risposta HTTP ed il suo contenuto, il tutto con una sintassi object oriented.
Zend_Http_Client fa largo uso del componente Zend_Uri, in particolare della sua sottoclasse specifica Zend_Uri_Http, per manipolare le URL.

Nell’esempio seguente vediamo come recuperare un semplice contenuto di una pagina tramite una richiesta HTTP GET, stamparne gli header ed il contenuto se la risposta va a buon fine.
Per complicare leggermente lo script, l’URL viene recuperato da una form e validato sfruttando uno degli approcci già descritti nell’articolo Validare un URL in PHP con Zend_Uri.

<?php

// includi la libreria
require_once 'Zend/Http/Client.php';

if (isset($_GET['url'])) {
    try {
        // esegui il parsing dell'URL
        $uri = Zend_Uri::factory(trim($_GET['url']));

        // useragent personalizzata
        $useragent = 'TestClient/1.0';

        // crea un nuovo client HTTP ed imposta le configurazioni
        $httpClient = new Zend_Http_Client();
        $httpClient->setConfig(array('useragent' => $useragent));
        $httpClient->setUri($uri);

        // invia la richiesta HTTP
        $response = $httpClient->request();

        // controlla la risposta
        if (!$response->isSuccessful()) {
            // genera un'eccezione in caso di status HTTP non valido
            throw new Zend_Http_Client_Exception('HTTP ' . $response->getStatus() . ' - ' . $response->getMessage());
        }

        echo "<h1>" . $uri . "</h1>";
        echo "<h2>Headers:</h2>";
        echo "<pre>";
        foreach($response->getHeaders() as $name => $value) {
            echo "$name: $value\n";
        }
        echo "</pre>";

        // stampa il contenuto della pagina in una textaread
        echo "<h2>Content:</h2>";
        echo "<textarea cols=\"80\" rows=\"80\">" . $response->getBody() . "</textarea>";

    } catch(Zend_Exception $e) {
        echo "<h1>Error: " . $e->getMessage() . "</h1>";
    }
}

?>
<form>
<p>
<input type="text" name="url" value="http://" />
<input type="submit" name="submit" value="fetch!" />
</p>
</form>

Lo script è molto essenziale e non è stato sviluppato tenendo in cosiderazione alcun principio alla base del design pattern MVC.
L’implementazione di un progetto MVC è, al momento, oltre lo scopo di questo semplice script.

Il codice è commentato a sufficienza, tuttavia ci sono alcuni aspetti che può essere utile commentare insieme.

Uso delle eccezioni in un codice procedurale

Innanzi tutto da notare l’uso di un unico blocco try...catch per gestire a monte qualsiasi eccezione generata dai componenti di Zend.
Sfruttando le eccezioni di PHP 5 è possibile evitare noiosi e ripetitivi controlli e rendere il codice più fluido, anche se scritto in modo procedurale.
Inoltre, possiamo sfruttare il blocco per lanciare noi stessi un’eccezione in caso sia necessario interrompere l’elaborazione (nel nostro caso se una risposta contiene uno status HTTP diverso da 200 o 304).

Le seguenti esecuzioni parte dello Zend Framework possono generare un’eccezione:

1. Zend_Uri::factory(trim($_GET['url'])) in caso l’URL fornito non sia valido
2. $response = $httpClient->request(); in caso la richiesta HTTP non vada a buon fine, ad esempio se la connessione internet non è disponibile

Poiché qualsiasi eccezione lanciata da un componente dello Zend Framework estende Zend_Exception, è sufficiente indicare a PHP di catturare una qualsiasi eccezione figlia di questa classe.

Impostazioni personalizzate

Zend_Client_Http consente di inviare intestazioni (header) personalizzate.
Tra gli header, quello senz’altro più famoso è la stringa User Agent che spesso indica univocamente il tipo di client in uso: browser come Mozilla Firefox o Internet Explorer, crawler come Yahoo! Slurp o Googlebot…

Nel nostro caso abbiamo scelto di identificare il nostro client con la stringa 'TestClient/1.0'.
Nei log del server le nostre richieste figureranno quindi associate a questa user agent.

Non è MVC!

Sebbene Zend Framework sia un framework MVC, come già anticipato, questo argomento è oltre allo scopo di questo script e si è adottata una soluzione procedurale per rendere il tutorial più sintetico ed immediato.

Non sempre l’architettura MVC riflette al meglio le esigenze di chi sviluppa… questo era uno di quei casi!

Attualmente, la distribuzione di Zend_Uri contenuta nella versione 1.0.3 dello Zend Framework supporta esclusivamente gli schemi HTTP e HTTPS, ma questo è più che sufficiente per il nostro scopo: validare il formato di un URL utilizzando PHP.

Vediamo un esempio concreto.

<?php

// includi la libreria
require_once 'Zend/Uri.php';

// valida l'URL
$valid = Zend_Uri::check('http://www.zend-framework.it/page.php');

if ($valid) {
  echo 'Valido';
} else {
  echo 'Invalido';
}

Questa è senz’altro la soluzione più comoda.
Grazie al metodo statico Zend_Uri::check() è possibile validare un URI. Nel caso l’URI passato non sia valido, $valid assumerà valore FALSE.

Nel caso in cui si desideri manipolare l’URL in seguito può essere utile utilizzare tentare di costruire un nuovo oggetto URI e catturare l’eccezione restituita dal metodo Zend_Uri::factory().

<?php

// includi la libreria
require_once 'Zend/Uri.php';

// costruisci un nuovo URI
try {
  $uri = Zend_Uri::factory('http://www.zend-framework.it/page.php');
} catch(Zend_Uri_Exception $e) {
  echo "URI invalido: " . $e->getMessage();
}

Nel caso in cui l’URI fornito sia valido, $uri conterrà una nuova istanza di un oggetto Zend_Uri specifico, ad esempio nel nostro caso Zend_Uri_Http.
Ecco l’output prodotto dal comando print_r($uri):

Zend_Uri_Http Object
(
  [_username:protected] =>
  [_password:protected] =>
  [_host:protected] => www.zend-framework.it
  [_port:protected] =>
  [_path:protected] => /page.php
  [_query:protected] =>
  [_fragment:protected] =>
  [_regex:protected] => Array
  (
    [alphanum] => [^\W_]
    [escaped] => (?:%[\da-fA-F]{2})
    [mark] => [-_.!~*'()\[\]]
    [reserved] => [;\/?:@&=+$,]
    [unreserved] => (?:[^\W_]|[-_.!~*'()\[\]])
    [segment] => (?:(?:(?:[^\W_]|[-_.!~*'()\[\]])|(?:%[\da-fA-F]{2})|[:@&=+$,;])*)
    [path] => (?:\/(?:(?:(?:[^\W_]|[-_.!~*'()\[\]])|(?:%[\da-fA-F]{2})|[:@&=+$,;])*)?)+
    [uric] => (?:[;\/?:@&=+$,]|(?:[^\W_]|[-_.!~*'()\[\]])|(?:%[\da-fA-F]{2}))
  )
  [_scheme:protected] => http
)