Con il rilascio della nuova API di Envato Marketplace, gli sviluppatori di terze parti ora hanno accesso a una vasta gamma di informazioni per creare tutti i tipi di applicazioni utili. Questo tutorial ti insegnerà come creare la tua app per iPhone utilizzando i dati della nuova API. Anche se non hai un iPhone, puoi ancora imparare le nozioni di base sull'utilizzo di PHP e JSON.
L'app che creeremo si basa sulla mia app per iPhone, Envato Marketplace Mobile. Mentre non verrà ricreata l'intera app, questo tutorial ti darà un'idea generale di come è stata creata. Questo tutorial è rivolto ai principianti di PHP e JSON e serve come base per la creazione di applicazioni PHP più avanzate.
Prima di poter iniziare a recuperare i dati utilizzando l'API, dobbiamo imparare come procedere per accedervi. L'API è divisa in 5 parti:
Per maggiori informazioni sull'API, clicca qui.
Ora che sappiamo cosa è richiesto per accedere all'API, siamo pronti a metterlo in pratica. Dal momento che vogliamo che gli altri usino la nostra fantastica app, dobbiamo ottenere un nome utente e una chiave API al volo; quindi recupereremo alcune variabili PHP dal browser.
if (isset ($ _ GET ['utente']) && $ _GET ['utente']! = "") $ userName = $ _GET ['utente']; if (isset ($ _ GET ['key']) && $ _GET ['key']! = "") $ apiKey = $ _GET ['chiave']; else echo 'Tasto Api non impostato!'; Uscita; else echo 'Nome utente non impostato!'; Uscita;
Il codice sopra controlla per vedere se le variabili utente e chiave sono stati impostati - ed esce se non l'hanno fatto. Controlla inoltre che la variabile globale non sia vuota.
Ora che abbiamo le informazioni richieste, possiamo andare avanti e usarlo per recuperare i nostri dati. Per fare ciò creeremo semplicemente un url usando il formato descritto nell'introduzione.
// Crea una stringa che verrà utilizzata per accedere all'API $ json_url = "http://marketplace.envato.com/api/edge/".$userName."/".$apiKey."/vitals+recent-sales .json ";
Si noti che stiamo usando la versione "edge" e stiamo usando le nostre variabili precedenti per username e api-key. Alla fine, recupereremo il organi vitali e vendite recenti set di dati nel formato JSON.
Ora che abbiamo creato il nostro url per accedere all'API, dobbiamo leggerne il contenuto in modo che possano essere passati alla funzione json_decode, che richiede un vero set di dati JSON, non solo un URL. Quindi, andiamo avanti e usiamo il file_get_contents () funzione per leggere il contenuto dell'URL.
// Ottieni il contenuto della stringa $ json_url $ json_contents = file_get_contents ($ json_url); // Un piccolo errore che verifica se (! $ Json_contents) echo "Errore: impossibile leggere il file JSON. Controlla il tuo nome utente e la chiave API."; Uscita;
Siamo finalmente pronti per convertire i dati JSON in un array in modo da poterli utilizzare nella nostra applicazione. Per realizzare questo compito useremo il json_decode () funzione che prenderà i dati dal nostro $ json_contents variabile e inviarlo a un array.
// Esporta i nostri dati in una matrice $ json_data = json_decode ($ json_contents, true);
Stiamo usando due parametri in questa funzione, il primo è la stringa che vogliamo decodificare, e il secondo indica alla funzione di generare i dati come una matrice. Questo è tutto! Ora siamo pronti a mostrare i nostri dati all'utente.
Abbiamo recuperato i nostri dati e ora è il momento di mostrarli all'utente. Per semplicità, aggiungeremo il nostro codice HTML di frontend nello stesso file del nostro codice PHP. Quindi vai avanti e aggiungi il codice del documento HTML standard sotto il tuo codice PHP.
App di My Nettuts per iPhone - App di My Nettuts per iPhone
Notare che nel
Andiamo avanti e aggiungiamo un semplice div che mostra il nome utente recuperato dall'API. Potremmo farlo usando la variabile $ userName come abbiamo usato nel titolo della pagina, tuttavia, usare JSON è più eccitante.
Che cosa fa il codice sopra è recuperare il nome utente dal organi vitali array, che è una matrice all'interno del nostro $ json_data array che è stato creato in precedenza. Ha senso?
Ecco la struttura della matrice utilizzata nell'esempio API: Array ([vitals] => Array ([username] => ryan [balance] => 32.75))
Successivamente, vogliamo mostrare all'utente il suo equilibrio. Questo è fatto allo stesso modo in cui abbiamo mostrato il nome utente. Questa volta, tuttavia, cambieremo semplicemente da "nome utente" a "saldo". Il resto è semplicemente per il layout e lo stile.
"; $ count = $ count + 1; else break;?>Saldo: $Vendite recenti:
Elenco vendite recenti
L'ultima cosa alla nostra agenda è mostrare le vendite più recenti per un utente. Questo è un po 'più complicato rispetto agli esempi precedenti, tuttavia, se hai mai lavorato con gli array dovresti essere in grado di gestirlo.
Venduto ". $ Valore ['articolo']." per $ "$ Value [ 'importo']."
C'è molto da digerire qui, quindi iniziamo con per ciascuno dichiarazione. Per prima cosa creiamo un $ salesArray dall'array delle vendite recenti all'interno di $ json_data. Questo non è necessario, ma penso che sia più pulito. L'istruzione foreach crea a $ value per ogni riga nel $ salesArray array e ci consente di estrarre informazioni da ogni riga. Quindi, in pratica si usa $ valore per ottenere i dati dalla riga mentre l'istruzione foreach scorre attraverso di essa.
Il prossimo è il codice che viene eseguito ogni volta che l'istruzione foreach passa attraverso una riga. Invece di mostrare tutte le vendite recenti, desidero solo elencare dieci, motivo per cui, se il numero di righe selezionate supera 10, interromperà il ciclo. Per cambiare il numero di righe che l'istruzione scorre, basta cambiare dieci al numero desiderato. In realtà la visualizzazione delle righe è abbastanza semplice, in quanto richiede solo l'eco di ogni riga all'interno di un div con una piccola icona. Noi usiamo il $ value per accedere alle informazioni di vendita dalla matrice. Tiriamo "articolo", che è il titolo dell'articolo e "quantità" che è l'importo che l'autore ha fatto sulla vendita. Finalmente "$ count + 1" aumenta solo il numero di righe che l'istruzione ha attraversato. Ora dovresti essere tutto pronto! Prova a caricare il file su un server di prova e verifica se funziona!
Se non si dispone di un account Envato Marketplace, è possibile utilizzare l'accesso di esempio:
Bene, la nostra nuova app funziona alla grande, ma sembra male - il che significa che è ora di tirare fuori alcuni CSS. Immagino che tu sappia abbastanza per capire il seguente codice, dato che non ci andrò dentro tranne alcune cose. #browser viene utilizzato da iPhone / Touch per assicurarsi che, se la pagina è troppo piccola, riempia lo schermo. body.lanscape #browser fa lo stesso, tuttavia, è per quando il browser è in modalità orizzontale.
body background: #efefef; margine: 0px; imbottitura: 0px; font-family: Helvetica; -webkit-touch-callout: none; -webkit-text-size-adjust: nessuno; larghezza: 100%; colore: # 2a2a2a; #browser / * assicurati di riempire sempre l'intero schermo * / 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; altezza: 30 px; colore: #fff; font-size: 22px; background: url (header_bg.jpg) repeat-x; #username font-size: 18px; font-weight: bold; text-transform: maiuscolo; imbottitura: 5px; / * WebKit supporta text-shadow ... quindi perché non farlo sembrare carino * / text-shadow: 0 1px 0 rgba (0, 0, 0, 0.5); colore: #fff; sfondo: # 498929; border-top: 1px solid # 85c952; border-bottom: 1px solid # 34661c; #content padding: 5px; padding-top: 10px; .icon vertical-align: text-top; margin-right: 5px; .line padding-bottom: 5px; border-bottom: 1px solid #cccccc; margin-bottom: 5px;
È ora di rendere la tua fantastica app finalmente compatibile con l'iPhone. Questo è veramente facile e comporta solo una riga di codice.
Basta aggiungere il codice sopra proprio sotto il
Bene ... abbiamo finito! Puoi vedere il prodotto finito qui sotto.
Sei arrivato alla fine. Spero che questa sia stata una buona introduzione per coloro che sono ancora nelle fasi iniziali dell'uso di PHP e JSON. Ora sei pronto per creare la tua app killer utilizzando l'API e JSON in generale.
Ora ricorda che questo tutorial è per principianti e per chi ha bisogno di un jump-start per l'utilizzo dell'API.