Avec la sortie de la nouvelle API Envato Marketplace, les développeurs tiers ont désormais accès à une mine d'informations pour créer toutes sortes d'applications utiles. Ce tutoriel vous apprendra comment créer votre propre application pour iPhone en utilisant les données de la nouvelle API. Même si vous n'avez pas d'iPhone, vous pouvez toujours apprendre les bases sur l'utilisation de PHP et JSON..
L'application que nous allons créer est basée sur mon application iPhone, Envato Marketplace Mobile. Bien que nous ne recréions pas l'intégralité de l'application, ce tutoriel vous donnera une idée générale de la création de celle-ci. Ce tutoriel est destiné aux débutants PHP et JSON et sert de base à la création d'applications PHP plus avancées..
Avant de pouvoir récupérer des données à l’aide de l’API, nous devons savoir comment y accéder. L'API est divisé en 5 parties:
Pour plus d'informations sur l'API, cliquez ici..
Maintenant que nous savons ce qu'il faut pour accéder à l'API, nous sommes prêts à le mettre en pratique. Puisque nous voulons que les autres utilisent notre application géniale, nous devons obtenir un nom d'utilisateur et une clé d'API à la volée; nous allons donc récupérer des variables PHP depuis le navigateur.
if (isset ($ _GET ['utilisateur']) && $ _GET ['utilisateur']! = "") $ nomutilisateur = $ _GET ['utilisateur']; if (isset ($ _GET ['clé']) && $ _GET ['clé']! = "") $ apiKey = $ _GET ['clé']; else echo 'La clé Api n'est pas définie!'; sortie; else echo 'Le nom d'utilisateur n'est pas défini!'; sortie;
Le code ci-dessus vérifie si les variables utilisateur et clé ont été définis - et quitte s'ils ne l'ont pas. Il vérifie également que la variable globale n'est pas vide.
Maintenant que nous avons les informations requises, nous pouvons continuer et les utiliser pour récupérer nos données. Pour ce faire, nous allons simplement créer une URL en utilisant le format indiqué dans l'introduction..
// Crée une chaîne qui sera utilisée pour accéder à l'API $ json_url = "http://marketplace.envato.com/api/edge/".$userName."/".$apiKey."/vitals+recent-sales .json ";
Notez que nous utilisons la version "edge" et utilisons nos variables précédentes pour le nom d'utilisateur et la clé-api. Enfin, nous allons récupérer le les signes vitaux et ventes récentes ensembles de données au format JSON.
Maintenant que nous avons créé notre URL pour accéder à l'API, nous devons en lire le contenu afin de pouvoir le transmettre à la fonction json_decode, qui nécessite un ensemble de données JSON réel, et pas seulement une URL. Alors, allons-y et utilisons le file_get_contents () fonction pour lire le contenu de l'URL.
// Récupère le contenu de la chaîne $ json_url $ json_contents = fichier_get_contents ($ json_url); // Une petite erreur vérifie si (! $ Json_contents) echo "Erreur: Impossible de lire le fichier JSON. Veuillez vérifier votre nom d'utilisateur et votre clé api."; sortie;
Nous sommes enfin prêts à convertir les données JSON en un tableau afin de pouvoir l’utiliser dans notre application. Pour accomplir cette tâche, nous utiliserons le json_decode () fonction qui prendra les données de notre $ json_contents variable et sortie dans un tableau.
// Affiche nos données dans un tableau $ json_data = json_decode ($ json_contents, true);
Nous utilisons deux paramètres dans cette fonction, le premier est la chaîne que nous souhaitons décoder, et le second indique à la fonction de sortir les données sous forme de tableau. C'est tout! Nous sommes maintenant prêts à montrer nos données à l'utilisateur.
Nous avons récupéré nos données et il est maintenant temps de les montrer à l'utilisateur. Par souci de simplicité, nous allons ajouter notre code HTML frontal dans le même fichier que notre code PHP. Alors allez-y et ajoutez le code de document HTML standard sous votre code PHP.
Application iPhone de mes Nettuts - Application iPhone de mes Nettuts
Notez que dans le
Continuons et ajoutons un simple div qui affiche le nom d'utilisateur extrait de l'API. Nous pourrions faire cela en utilisant la variable $ userName comme celle que nous avons utilisée dans le titre de la page, cependant, utiliser JSON est plus excitant.
Ce que le code ci-dessus fait, c'est récupérer le Nom d'utilisateur du les signes vitaux tableau, qui est un tableau au sein de notre $ json_data tableau qui a été créé plus tôt. logique?
Voici la structure du tableau utilisé dans l'exemple de l'API: Array ([vitals] => Array ([username] => ryan [balance] => 32.75))
Ensuite, nous voulons montrer à l'utilisateur son solde. Ceci est fait de la même manière que nous avons affiché le nom d'utilisateur. Cette fois, cependant, nous passerons simplement de "nom d'utilisateur" à "solde". Le reste est simplement pour la mise en page et le style.
"; $ count = $ count + 1; else pause;?>Solde: $Ventes récentes:
Liste des ventes récentes
La dernière chose à l'ordre du jour est d'afficher les ventes les plus récentes pour un utilisateur. Ceci est un peu plus compliqué que les exemples précédents, cependant, si vous avez déjà travaillé avec des tableaux, vous devriez pouvoir le gérer..
Vendu ". $ Value ['item']." pour $ ". $ valeur ['montant']."
Il y a beaucoup à digérer ici, alors commençons par le pour chaque déclaration. Premièrement, nous créons un tableau $ salesArray à partir du tableau recent-sales dans $ json_data. Ce n'est pas nécessaire, mais je pense que cela a l'air plus propre. La déclaration foreach crée un $ valeur pour chaque rangée du $ salesArray tableau et nous permet d'extraire des informations de chaque ligne. Donc, en gros, vous utilisez $ value pour obtenir des données à partir de la ligne lorsque l'instruction foreach parcourt celle-ci..
La prochaine étape est le code qui est exécuté chaque fois que l'instruction foreach passe par une ligne. Au lieu de montrer toutes les ventes récentes, je ne veux en énumérer que dix, ce qui explique pourquoi, si le nombre de lignes vérifiées dépasse dix, la boucle sera rompue. Pour changer le nombre de lignes que l’instruction parcourt, il suffit de changer dix par le nombre souhaité. En fait, afficher les lignes est assez simple, car il suffit de rappeler chaque ligne à l’intérieur d’une div avec une petite icône. Nous utilisons le $ valeur pour accéder aux informations de vente à partir du tableau. Nous tirons "article", qui est le titre de l'article et "montant" quel est le montant que l'auteur a fait sur la vente. finalement "$ count + 1" augmente simplement le nombre de lignes que l'instruction a parcourues. Vous devriez maintenant être tous ensemble! Essayez de charger le fichier sur un serveur de test et voyez si cela fonctionne!
Si vous ne possédez pas de compte Envato Marketplace, vous pouvez utiliser l'exemple de connexion:
Eh bien, notre nouvelle application fonctionne très bien, mais elle a l'air mal - ce qui signifie qu'il est temps de sortir un peu de CSS. Je suppose que vous en savez assez pour comprendre le code suivant, car je n'y entrerai pas, à part quelques petites choses.. #navigateur est utilisé par l'iPhone / Touch pour s'assurer que si la page est trop petite, elle remplira l'écran. body.lanscape #browser fait de même, cependant, est pour quand le navigateur est en mode paysage.
body background: #efefef; marge: 0px; remplissage: 0px; famille de polices: Helvetica; -webkit-touch-callout: aucun; -webkit-text-size-ajuster: aucun; largeur: 100%; couleur: # 2a2a2a; #browser / * assure que nous remplissons toujours tout l'écran * / min-height: 416px; body.landscape #browser min-height: 268px; h3 margin-bottom: 5px; p margin: 0 0 5px 0; / * Layout * / #header padding: 10px 5px 5px; hauteur: 30px; couleur: #fff; taille de police: 22px; fond: url (header_bg.jpg) repeat-x; #nom_utilisateur font-size: 18px; poids de police: gras; text-transform: majuscule; rembourrage: 5px; / * WebKit supporte text-shadow… alors pourquoi ne pas le rendre joli * / text-shadow: 0 1px 0 rgba (0, 0, 0, 0.5); couleur: #fff; arrière-plan: # 498929; bordure supérieure: solide 1px # 85c952; fond de bordure: solide 1px # 34661c; #content padding: 5px; rembourrage en haut: 10px; .icon vertical-align: text-top; marge droite: 5px; .line padding-bottom: 5px; border-bottom: 1px solid #cccccc; margin-bottom: 5px;
Il est temps de rendre votre superbe application enfin compatible avec l'iPhone. C’est vraiment très facile et ne nécessite qu’une seule ligne de code.
Ajoutez simplement le code ci-dessus juste en dessous de la
Eh bien… nous avons tous fini! Vous pouvez voir le produit fini ci-dessous.
Vous avez atteint la fin. J'espère que c'était une bonne introduction pour ceux qui en sont encore aux débuts de l'utilisation de PHP et JSON. Vous êtes maintenant prêt à créer votre propre application tueur à l'aide de l'API et de JSON en général..
Maintenant, rappelez-vous, ce tutoriel est destiné aux débutants et à ceux qui ont besoin d'un démarrage rapide pour utiliser l'API..