Gestion de paquetage facile pour CodeIgniter avec Sparks

Maintenant que l'étincelle sait où trouver des données, il est temps d'aller récupérer certains flux. Pour ce faire, nous devrons créer une bibliothèque: appelez-la. pigeonnier.php-et enregistrez-le dans le les bibliothèques annuaire:

ci = & get_instance ();  public function retrieve () // construire l'URL de la demande twitter $ twitterURL = sprintf ($ this-> option ('twitterURL'), $ this-> option ('twitter')); // récupère les données RSS $ tweets = $ this-> ci-> atomizer-> loadURL ($ twitterURL); $ feed = $ this-> ci-> atomizer-> loadURL ($ this-> option ('feedURL')); // définit les informations sur le canal pour le nouveau flux $ info = array ('title' => 'Flux convolved'); // mélange les deux flux $ this-> timeline = $ feed-> convolve ($ tweets, $ info); retourne $ this-> timeline;  fonction publique publish () header ('content-type: application / rss + xml'); echo $ this-> timeline-> save ();  // récupère une option ($ key) à partir d'une option de fonction protégée par des fichiers de configuration ($ key) return $ this-> ci-> config-> item ($ key); ?>

Cette bibliothèque fournit des fonctions d’aide permettant de récupérer des options de notre fichier de configuration et de publier un flux RSS, mais l’essentiel est: récupérer(). Cette fonction récupère les données RSS des fournisseurs décrits dans le fichier de configuration du pigeonnier en plusieurs étapes:

• Tout d'abord, l'adresse du flux RSS Twitter est générée. Config décrit un nom d'utilisateur (gazouillement) et un point final (twitterURL) maintenant, les deux sont combinés en utilisant sprintf.
• Ensuite, les données RSS de chaque flux sont récupérées à l’aide du bouton loadURL fonctionner le atomiseur bibliothèque. Cette fonction retourne un "AtomizerFeed"objet qui fournit des fonctions utiles pour manipuler des données RSS.
• finalement, AtomizerFeedde convolver Cette opération permet de combiner les éléments des deux flux en un seul flux, qui est renvoyé..

À ce stade, nous sommes presque prêts à lancer le pigeonnier dans une application en direct. Nous devons juste vérifier que notre application inclut toutes les dépendances du pigeonnier et que l'étincelle se charge correctement..

---

Étape 4: dépendances

Quand nous avons écrit spark.info, rappelons la ligne où nous avons décrit les dépendances du pigeonnier:

Dépendances: Atomizer: 0.0.1

Cela signifie que le pigeonnier repose sur une autre fonction, Atomizer-to. Une fois que les étincelles sont validées dans le référentiel getsparks.org, l'utilitaire de gestion télécharge automatiquement les dépendances. Bien que nous restions dans le développement local, cependant, nous devrons le faire nous-mêmes..

Si vous utilisez le gestionnaire d'étincelles, vous pouvez installer Atomizer en accédant à votre répertoire CodeIgniter et en appelant le gestionnaire. installer une fonction:

outils php / spark install -v0.0.2 atomiseur

Remarque: Si vous êtes sous Windows, vous devrez invoquer outils php \ spark install -v0.0.2 atomiseur au lieu.

Si vous n'utilisez pas le gestionnaire, ou si l'installation ne s'est pas terminée correctement, vous pouvez télécharger Atomizer à partir de Github et l'extraire dans le dossier de votre application. des étincelles répertoire à côté du dossier contenant le pigeonnier.

Étape 5: Chargement automatique

Avant que le pigeonnier ne soit disponible pour d'autres parties de l'application, nous devrons nous assurer qu'il se chargera correctement. Revenez dans le dossier config de votre répertoire spark et collez le texte suivant dans un nouveau fichier appelé autoload.php.

Chaque fois que CodeIgniter charge une étincelle, il tente de charger toutes les ressources énumérées dans autoload.php ainsi que. Cela permet aux auteurs d’étincelles de définir les ressources auxquelles les utilisateurs doivent avoir un accès immédiat chaque fois qu’ils chargent l’étincelle. Parce que le colombier bibliothèque est spécifiée ici, par exemple, nous aurons un accès immédiat à la récupérer fonctionner dès que l'étincelle est chargée.

Il convient de mentionner que les ressources décrites dans autoload.php ne doit pas nécessairement résider dans le répertoire spark. Tant qu'ils sont situés quelque part dans le chemin de recherche de CodeIgniter, l'application doit pouvoir les trouver. Remarquer atomiseur est en cours de chargement dans l'exemple ci-dessus; il ne serait pas très utile d'énumérer les dépendances d'une étincelle, mais de ne pas pouvoir les charger!

Enregistrez le fichier de chargement automatique et chargeons-le. Dans le contrôleur de bienvenue de votre application principale (/application/controllers/welcome.php), ajoutez ce qui suit:

fonction publique dovecote () $ this-> load-> spark ('pigeonnier / 0.0.1'); $ this-> dovecote-> retrieve (); $ this-> pigeonnier-> publier (); 

Passons en revue cela:

1. Nous demandons à CodeIgniter de charger le pigeonnier, sachant que toutes les ressources demandées dans config / autoload.php sera chargé ainsi
2. pigeonnier récupérer Cette fonction est utilisée pour obtenir des copies des flux RSS décrits dans config / dovecote.php
3. La chronologie combinée produite par récupérer est servi comme un flux RSS en utilisant pigeonnier publier une fonction

Le voir en action

Naviguez vers bienvenue / pigeonnier dans votre navigateur, et vous devriez recevoir un flux RSS relatant les tweets et les articles rassemblés par le pigeonnier..

Étape 6: Construire sur l'étincelle

Rendons le pigeonnier un peu plus utile. Tout d'abord, nous allons créer un modèle de vue de base pour afficher le titre de chaque article dans notre chronologie:

 
Événements récents:
 
  
Titre; ?>
  

Ensuite, nous allons rendre la vue accessible en fournissant une fonction d'assistance que d'autres parties de l'application peuvent utiliser pour afficher le scénario en HTML..

pigeonnier-> récupérer (); $ data = array ('items' => $ feed-> items ()); $ ci-> load-> view ('dovecote_timeline', $ data); ?>

le dovecote_timeline fonction et sa vue éponyme peuvent maintenant être utilisés pour rendre la timeline n'importe où dans notre application. Mais, conformément à la philosophie «CodeIgniter», nous ne le rendrons pas automatiquement disponible via autoload.php. Au lieu de cela, nous devrons charger l’assistant manuellement chaque fois que cela est nécessaire. Retournez au contrôleur de bienvenue de votre application et mettez à jour le colombier fonction pour générer une version HTML du flux:

fonction publique dovecote () $ this-> load-> spark ('pigeonnier / 0.0.1'); $ this-> load-> helper ('pigeonnier'); $ this-> dovecote-> retrieve (); // appelle la fonction d'assistance echo dovecote_timeline (); 

Actualisez votre navigateur et vous devriez maintenant voir une liste de tous les éléments de la timeline du pigeonnier.

Emballer

Toutes nos félicitations! Vous êtes maintenant le propriétaire d'une étincelle très simple, mais il y a beaucoup plus qui peut être fait. Avant d’envoyer le pigeonnier à l’action, vous pouvez envisager d’écrire des fonctions supplémentaires. Les détails dépendent de vous, mais certaines fonctionnalités utiles pourraient inclure:

• mise en cache des réponses de l'API
• vues pour embellir les données récupérées
• persistance des données pour sauvegarder des éléments de chronologie plus anciens (vérifiez d'abord la licence de flux!)

Ce didacticiel présente les grandes lignes de ce qui peut être fait avec les étincelles et présente les avantages que ces étincelles peuvent offrir en réduisant les répétitions et en accélérant le développement..

Travailler sur une étincelle? Vous avez des problèmes pour vous lancer? Partagez un peu plus dans les commentaires ci-dessous et merci beaucoup pour la lecture!