Jos luet aiempia viestejäni etätiedostojen noutamisesta, tiedät, että vanhat tavat kuolevat, koska käytän file_get_contentsusein wp_remote_get.
Joten, kuten blogia kirjoittaessa, ajattelin, että olisi hyödyllistä jakaa yksinkertainen esimerkki siitä, kuinka sitä käytetään wp_remote_getpäivittäisessä työssäsi.
Alla oleva viesti on vain pätkä sen käytöstä. Eli se ei näytä, miten suunnitellaan esimerkiksi luokka sen ympärille tai käyttöliittymä, jonka avulla käyttäjät voivat ladata tiedoston. Mutta tämän pitäisi riittää asioiden aloittamiseen.
Ja aion sisällyttää siihen, kuinka API-dokumentaatio otetaan sen ympärille ja miten sitä voidaan hyödyntää käytettäessä tällaista toimintoa.
Miksi käyttää wp_remote_get?
Vaikka en aina käytä WordPress-sovellusliittymää (mikä johtuu yleensä siitä, että vanhat tavat jatkuvat edelleen tai koska en ole tietoinen toiminnosta), yritän.
Ja uskon vakaasti, että jos työskentelet sovelluksen tietyssä ympäristössä ja kyseinen sovellus tarjoaa API jollekin, sinun tulee käyttää sitä.
Dokumenttien lukeminen
Jos tiedät dokumentaation hyödyntämisen, voit ohittaa tämän osion.
Kun tämä sanotaan, seuraava dokumentaatio wp_remote_getsanoo:
Hae raaka vastaus HTTP-pyynnöstä GET – menetelmällä. Tulokset sisältävät HTTP-otsikot ja sisällön.
Voit lukea lisää sekä tältä sivulta Codexista että tältä sivulta kehittäjäresursseista. Mutta ennen kuin käytät funktiota, on tärkeää ymmärtää, mitä se hyväksyy ja mitä se palauttaa.
Ja funktio hyväksyy kaksi parametria:
- URL-osoite, johon pyyntö lähetetään,
- pyynnössä vaadittavat argumentit (joka ei kuulu tämän viestin piiriin).
Ja wp_remote_get palauttaa sekalaisia tuloksia pyynnön tuloksen perusteella. Kehittäjäresurssien mukaan:
(WP_Error|array) Vastaus tai WP_Error epäonnistuessa.
Tässä vaiheessa tiedämme, mitä funktio tekee, mitä se hyväksyy ja mitä se palauttaa. Meillä on siis tarpeeksi jatkettavaa yksinkertaisen esimerkin laatimisessa.
Käyttämällä wp_remote_get
Kun kaikki edellä mainitut asiat ovat paikoillaan, tässä on yksinkertainen esimerkki tiedoston noutamisesta tietystä URL-osoitteesta. Oletan, että URL-osoite on paikallisella palvelimellasi (koska en halua tässä viestissä pyytää tietoja muilta palvelimilta), minkä vuoksi verkkotunnus on dot-localin TLD.
Kommenttien pitäisi selittää, mitä tapahtuu, mutta esitän sen jälkeen muutaman ajatuksen lisää.
Tärkeimmät huomioitavat asiat ovat seuraavat:
- Tarkista otsikot varmistaaksesi, että ne on asetettu. Jos ei, tiedoston runkoon tarttumista ei tarvitse jatkaa.
- Jos on virhe, meidän on käsiteltävä se sulavasti.
- Jos kaikki muu on kunnossa, olemme valmiita kirjoittamaan tiedoston levylle. Käytän PHP:n tiedostotoimintoja tähän. Se on hieman viestin soveltamisalan ulkopuolella, mutta sen pitäisi olla helppo ymmärtää, jos tutkit alla olevia linkkejä.
Loppujen lopuksi käyttö wp_remote_gettarjoaa sinulle paljon toimintoja käärittynä helppokäyttöiseen toimintoon.