giovedì 28 marzo 2013

NetBeans e ApiGen: Documentare il codice PHP (Parte 2/2)

Ora che tutto è installato e configurato, come spiegato nella parte 1 di questo tutorial, come fare per ottenere la documentazione API del nostro software scritto in PHP.

ApiGen, come altri sistemi automatici per la produzione della documentazione dei sorgenti software, fa uso dei commenti inseriti nel codice sorgente per compilare la documentazione.

martedì 26 marzo 2013

NetBeans e ApiGen: Documentare il codice PHP (Parte 1/2)

Fra le tante schede presenti fra le opzioni di NetBeans dedicate al PHP, c'è una dedicata ad ApiGen. ApiGen è un tool per la produzione di documentazione relativa ai progetti PHP partendo dall'analisi dei sorgenti. La sua integrazione in NetBeans lo rende uno strumento comodo e di semplice utilizzo per la generazione automatica della documentazione API.

giovedì 21 marzo 2013

Generare dinamicamnte i Feed RSS con PHP (Parte 2/2)

Ora che abbiamo visto nella parte uno di questo tutorial cosa è, e cosa contiene un file XML utile ad essere interpretato dai Feeds RSS Reader, non resta che utilizzare PHP per produrre al volo tale semplice file di testo affichè possano essere diffusi i contenuti.

Per prima cosa occorre informare il browser web di predisporsi a ricevere non un file HTML, ma un file XML indicando altresì il charset utilizzato. Personalmente utilizzo sempre e per ogni elemento il charset UTF-8, ognuno si senta però libero di utilizzare il charset che ritiene più appropriato. Quindi  scriveremo:

domenica 3 marzo 2013

Generare dinamicamnte i Feed RSS con PHP (Parte 1/2)

Really Simple Syndication 2.0, o semplicemente RSS, è un metodo per diffusione di contenuti aggiornati tramite file conforme alle specifiche xml 1.0.

Tramite tale file gli RSS reader, come molti browser che lo integrano o Microsoft Outlook, presentano all'utente i contenuti più recenti sotto forma di mail (una per ogni contenuto diffuso). In tal modo l'utente può prendere visione subito, in toto o in parte del contenuto ed eventualmente decidere di andare sul sito di riferimento.