Il 15 marzo, Twitter ha presentato @Anywhere, un nuovo framework per realizzare applicazioni e widget per il proprio sito web con estrema semplicità.

Molte aziende proveranno in anteprima questo nuovo servizio: YouTube, eBay, Amazon, Digg sono solo alcuni dei 12 siti, la cui lista completa la trovate sul Twitter Blog.

Per favorire la creazione delle applicazioni @Anywhere, Twitter ha messo a punto la nuova sezione Developers. Da qualche giorno, infatti, è online il sito dev.twitter.com.

Tutto in JavaScript

La forza di @Anywhere è nella semplicità d’uso. Il linguaggio usato è JavaScript che è possbile implementare direttamente nelle pagine HTML tramite il tag <script>.

Non solo, per includere il framework, non bisogna scaricare alcun file, ma basta un semplice link ad una pagina JavaScript reperibile direttamente online. Una bella comodità.

Il Twitter Developers ci porta all’interno di questa piattaforma con alcuni esempi: linkare direttamente gli utenti mentre si scrive, visualizzare le Hovercards (vedi l’immagine sopra) o anche visualizzare un semplice pulsante per il follow… questi ed altri esempi sono disponibili nella pagina “Welcome to @Anywhere”.

La nuova sezione Twitter Developers

Twitter Developers racchiude in un unico spazio tutti gli strumenti per interfacciarsi con Twitter. La sezione API Wiki, uno spazio dedicato alla documentazione ufficiale delle API, e la Twitter Application Platform, per la creazione e gestione delle applicazioni OAuth, sono state entrambe spostate in quest’area per essere più facilmente accessibili.

Su Twitter Developers è possibile scoprire il mondo delle Twitter API, verificarne il funzionamento e registrare le proprie applicazioni con pochi clic.

Tra le novità più interessanti che questa sezione ha introdotto vi è la possibilità di vedere lo status delle API, descrivendo eventuali problemi di reperibilità delle funzioni più usate dagli sviluppatori (soprattutto la funzione search che non è mai al 100% up)

La Basic Authentication ormai è superata

L’introduzione delle applicazioni @Anywhere e l’accostamento di queste con il sistema OAuth rendono, di fatto, la Basic Authentication superflua. Proprio per questo motivo, il 30 giugno Twitter sospenderà questo metodo diventato con il passare degli anni obsoleto e sta chiedendo a tutti gli sviluppatori di passare ad un metodo più sicuro (OAuth o @Anywhere) prima di tale data, in modo da non rischiare “black-out”.

Questa scelta, comporterà la scomparsa della scritta “pubblicato via API” nei tweet e, sicuramente, comporterà non pochi problemi per coloro i quali devono affacciarsi per la prima volta nel mondo OAuth.

Per questo motivo pubblicherò nei prossimi giorni alcune guide utili per prepararsi al meglio a questo passaggio. Restate con noi

Questa sera mi sono imbattuto in un incubo per molti programmatori: c’è un problema, ma dov’è la causa?

In PHP c’è una funzione della quale non tutti sanno l’esistenza, ma che tutti dovrebbero usare: sto parlando di backup_backtrace che permette di ricostruire l’intero percorso di una chiamata.

Vediamo qualche esempio.

Un problema in una funzione

Un esempio concreto dell’utilizzo di backup_backtrace è in una funzione chiamata. Supponiamo di avere la seguente funzione PHP:

function query ($post_query) {
	mysql_query($post_query);
	if (strlen(mysql_error()) > 0) {
		$backtrace = debug_backtrace();
		$backtrace[0][file] = explode('\\', $backtrace[0][file]);
		echo 'Attenzione! Query non valida <i>'
			.$backtrace[0][file][count($backtrace[0][file]) - 1].':'.$backtrace[0][line]
			.'</i> '.$post_query.' (<i>'.mysql_error().'</i>)<br>';
		return 0;
	} else
		return 1;
}

In questo caso l’uso di debug_backtrace è lampante: se la query genera un errore, prende il nome del file senza il percorso (riga 5 e riga 7), la linea che ha generato la chiamata alla funzione query e li visualizza insieme ad un messaggio di errore (riga 6), alla query passata ed all’errore in dettaglio (riga 8).

Avendo, per esempio il seguente codice nel file test.php:

query ('UPDATE table SET t1 = s WHERE id = 1');

verrà visualizzato un messaggio di errore come il seguente:

Attenzione! Query non valida test.php:42 UPDATE table SET t1 = s WHERE id = 1 (You have an error in your MySql syntax)

o simile.

Un altro esempio per errori generici

Un altro esempio di problema potrebbe verificarsi durante l’esecuzione di uno script all’interno di una certa pagina. Qui possiamo aggiungere manualmente un richiamo alla nostra funzione e visualizzare i dettagli per il debug. Lo script che può tornarci utile è il seguente:

function getDebugBacktrace () {
	$NL = '<br />';
	$dbgTrace = debug_backtrace();
	$dbgMsg .= $NL."Inizio debug backtrace:$NL";
	foreach ($dbgTrace as $dbgIndex => $dbgInfo)
		$dbgMsg .= "\t livello ".$dbgIndex." @ ".$dbgInfo['file'].":".$dbgInfo['line']." -> ".$dbgInfo['function']."(".join(",",$dbgInfo['args']).")$NL";
	$dbgMsg .= "Fine debug backtrace".$NL;
	return $dbgMsg;
}

echo "Attenzione! Impossibile connettersi al database!";
echo getDebugBacktrace();

Con questo algoritmo verrà visualizzato il seguente output:

Attenzione! Impossibile connettersi al database!
Inizio debug backtrace:
livello 0 @ D:\Siti web\Senzatitolo-1.php:12 -> getDebugBacktrace()
Fine debug backtrace

Il tutto è molto utile per ricercare errori soprattutto in righe che producono uno stesso output.

La guida su php.net

Sempre disponibile c’è la guida della funzione online consultabile gratuitamente all’indirizzo www.php.net.

Avete altre idee di come utilizzare questa funzione? Scrivetele nei commenti

Alcuni servizi necessitano di funzioni e informazioni che, per essere completi, devono provenire da altri siti web. Se queste informazioni, poi, sono in continuo aggiornamento, le possibilità diventano 2: inserire le novità manualmente sul sito oppure realizzare un robot che aggiorna il tutto al posto nostro.

Entriamo nel dettaglio della seconda scelta.

Passi da seguire

Innanzitutto bisogna pensare che la realizzazione di un robot non è una cosa né immediata né tantomeno semplice. Possiamo dividere il nostro lavoro in 5 compiti:

• Individuazione delle pagine da acquisire
• Posizionamento del cursore all’interno della pagina
• Acquisizione dati e spostamento del cursore
• Operazioni finali sul codice
• Impostare il crontab

A seconda delle nostre esigenze, questi compiti possono essere più o meno complessi.

In questo articolo verrà dimostrato come realizzare un semplice robot che acquisisce tutte le headlines del sito Corriere.it

Individuazione delle pagine da acquisire

Precisiamo una cosa: realizzare un robot non è sempre possibile. In alcuni siti è espressamente vietato, mentre per altri bisogna tenere in considerazione i diritti d’autore. Quindi fate attenzione su cosa volete concentrarvi.

Il primo compito è l’individuazione delle pagine da acquisire. Nel nostro caso, ci focalizzeremo sulla home page e l’acquisiremo tramite il comando file_get_contents:

$content = file_get_contents("http://www.corriere.it/index.shtml");

oppure tramite una chiamata socket con fsockopen:

//connessione al sito:
$viart_xml = fsockopen("www.corriere.it", 80, $errno, $errstr, 12);
	// indicazione della pagina da chiamare:
	fputs($viart_xml, "GET /index.shtml HTTP/1.0\r\n");
	fputs($viart_xml, "Host: www. corriere.it\r\n");
	// referer da simulare, per alcuni siti è obbligatorio:
	fputs($viart_xml, "Referer: http://www.example.com\r\n");
	fputs($viart_xml, "User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)\r\n\r\n");
	if (!$viart_xml) {
		die("$errstr ($errno)<br />\n");
	} else {
	$content = "";
	while (!feof($viart_xml)) {
		$content .= fgets($viart_xml, 1000000);
	}
	fclose($viart_xml);
}

La nostra pagina sarà codificata in HTML e sarà assegnata per intero alla variabile content.

Posizionamento del cursore all’interno della pagina

Acquisita la pagina, sarà necessario spostarci all’interno di essa e qui entra in gioco una funzione che può esserci molto utile:

function strlimit($text, $text_init = "", $text_end = "", $pos_init = 0)
{
	if (strlen($text_end) > 0)
		return substr($text, strlen($text_init) > 0 ? $pos = strpos($text, $text_init, $pos_init) + strlen($text_init) : 0, strpos($text, $text_end, $pos) - $pos);
	else
		return substr($text, strlen($text_init) > 0 ? strpos($text, $text_init, $pos_init) + strlen($text_init) : 0);
}

La funzione strlimit, realizzata ad hoc, ci permette di selezionare un testo all’interno di una variabile delimitato da text_init e text_end facendo partire la scansione da pos_init. Ad esempio:

$var = '1234564567890';
echo strlimit($var, '3', '8');    //output: 4564567
echo strlimit($var, '5', '8');    //output: 674567
echo strlimit($var, '5', '8', 6);     //output: 67

La selezione del testo può avvenire in due modi: permanentemente e temporaneamente. Una selezione permanente ci permette di gestire una parte di codice più piccola che non presenterà ambiguità, mentre una temporanea ci permette di operare senza alterare la sorgente.

Nel nostro esempio possiamo vedere come applicare questa selezione, effettuando le seguenti operazioni:

// La variabile con tutto il contenuto della pagina ricordo che è $content
$content = strlimit($content, 'maincontent', 'vaschetta3');
// questa è una selezione permanente, in cui l’html viene limitato alla parte sinistra della pagina, da maincontent (la prima notizia) a vaschetta3 (le 3 immagini in fondo)
// analizzando il codice si può notare che ogni articolo inizia con un ‘homearticle-box’ e con la funzione explode siamo in grado di metterli in un array:
$articles = explode('homearticle-box', $content);

Acquisizione dati e spostamento del cursore

Ora che abbiamo tutti gli articoli, possiamo muoverci all’interno di essi per acquisirne i dettagli quali titolo, sottotitolo e occhiello. Qui entrano in gioco le selezioni temporanee che lasciano intatto il codice sorgente. Vediamo come (per semplificare ipotizzo che non ci siano news straordinarie):

for ($i = 0; $i < count($articles); $i++) {
	$subtitle = strlimit($articles[$i], '<p>', '</p>');
	$title = strlimit($articles[$i], '<h2>', '</h2>');
	$occh = strlimit($articles[$i], 'class="hour"', '</p>');
	// …
	// qui ora vengono effettuate tutte quelle operazioni di pulizia e sistemazione dei tre oggetti, quail rimozione link, tag ecc. . Al termine assegniamo il risultato ad una variabile risultato.
	$risultato[$i] = array(
		'sottotitolo' => $subtitle,
		'titolo' => $title,
		'occhiello' => $occh
	);
}

A questo punto avremo un array risultato con tutti gli articoli pronti per essere visualizzati o salvati in un database.

Operazioni finali

Ora sarà possibile gestire l’array per visualizzare a video le informazioni acquisite o salvarle in un database. Per quest’ultima operazione è consigliabile controllare che ogni articolo non sia già inserito per evitare doppioni facendo un controllo sul link (che rimane fisso una volta scritto).

Un esempio potrebbe essere la visualizzazione degli articoli:

for ($i = 0; $i < count ($risultato); $i++) {
	echo '<h3>'.$risultato[$i]['sottotitolo'].'</h3>'."\n";
	echo '<h1>'.$risultato[$i]['titolo'].'</h1>' ."\n";
	echo '<h2>'.$risultato[$i]['occhiello'].'</h2>' ."\n";
	echo '<hr>'."\n\n";
}

Impostare il crontab

Completata la realizzazione della pagina si passa all’impostazione del cron. Ogni piattaforma ha proprie opzioni per mettere a punto questo strumento.

Per eseguire lo script php, di norma, occorre impostare il task in modo che esegua l’azione:

cd /var/www/vhosts/example.com/httpdocs; php -q robot.php

oppure un’azione simile in base alle impostazioni del server.

Un’ottima referenza per gli orari dei task, invece, è la Wikipedia che spiega con molti esempi come impostarli.

Impostato il cron, è consigliabile effettuare dei test per vedere se il tutto funzionerà a dovere, semplicemente digitando nel proprio browser l’indirizzo del robot e verificando che il risultato sia quello previsto.

Questo è quanto, se avete suggerimenti o informazioni commentate.

(Immagine alta: Flicker, à voir etc…)