Siirry pääsisältöön

Headless WordPress Seravon ympäristössä

Opi kuinka headless WordPress -arkkitehtuuri toimii Seravolla, miten hyödynnät staattisia React/Vue-sovelluksia ja miksi GET-pyynnöt ovat tärkeitä REST- ja GraphQL-rajapinnoissa.

Headless WordPress -arkkitehtuurissa WordPressiä käytetään ainoastaan sisällönhallintajärjestelmänä (taustajärjestelmänä eli backendina), ja sivuston julkinen näkymä (frontend) on toteutettu erillisellä JavaScript-kehyksellä, kuten Reactilla, Vuella tai Next.js:llä.

Kävijälle näytettävä käyttöliittymä kommunikoi WordPressin kanssa joko WP REST API:n tai WPGraphQL:n välityksellä hakeakseen sisällön dynaamisesti.

Seravon ympäristö tukee headless-arkkitehtuuria erinomaisesti, mutta on tärkeää ymmärtää palvelimen toimintamalli staattisen ja palvelinpuolella renderöidyn (SSR) JavaScriptin välillä.

Staattiset Headless-sovellukset (SPA)

Jos frontend-toteutuksesi on staattinen yksisivuinen sovellus (Single-Page Application, esim. puhdas React, Vue tai staattisesti käännetty Gatsby/Next.js), voit ajaa sekä frontendin että WordPressin samalla Seravon palvelimella.

Seravon palvelimen nginx-asetuksissa index.html on määritelty ensisijaiseksi hakemistoindeksiksi ennen WordPressin index.php-tiedostoa.

Käyttöönotto:

  1. Käännä JavaScript-sovelluksesi valmiiksi tuotantoversioksi (build).

  2. Siirrä käännetty index.html ja sen vaatimat resurssit (JavaScript- ja CSS-tiedostot) sivuston juurihakemistoon /data/wordpress/htdocs/.

  3. Tämän jälkeen kävijät, jotka saapuvat sivuston etusivulle, näkevät automaattisesti JavaScript-sovelluksesi.

  4. WordPressin hallintapaneeli toimii edelleen täysin normaalisti osoitteessa /wp-admin/.

Huom: Koska Seravo-ympäristö sisältää tarvittavat Node.js-työkalut (npm, webpack, gulp jne.), voit myös kääntää staattisen frontendin suoraan palvelimella SSH-yhteyden yli asennusvaiheessa tai automatisoituna osana CI/CD-putkea.

Palvelinpuolella renderöidyt sovellukset (SSR)

Seravon palvelinympäristö on optimoitu raskaaseen PHP-suoritukseen (WordPress/WooCommerce) sekä aggressiiviseen HTTP-välimuistitukseen. Seravolla ei ole mahdollista ajaa suoraan pitkäkestoisia, portteja kuuntelevia Node.js-palvelinprosesseja (kuten palvelinpuolella renderöivää Next.js- tai Express-palvelinta).

Jos projektisi vaatii SSR-frontendin:

  • Aja JavaScript-sovellus (frontend) siihen erikoistuneessa ympäristössä (esim. Vercel tai Netlify).

  • Käytä Seravon palvelinta pelkkänä WordPress-backendina (esim. osoitteessa admin.esimerkki.fi tai api.esimerkki.fi), josta frontend hakee sisältönsä.

Rajapinnat, välimuisti ja suorituskyky

Headless-sivustoilla WordPressin suorituskyky nojaa täysin rajapintojen (API) nopeuteen.

1. Suosi GET-pyyntöjä REST API:ssa ja GraphQL:ssä

Seravon HTTP-välimuisti tallentaa oletuksena GET- ja HEAD-pyyntöjen vastaukset, mutta ohittaa aina välimuistin POST-pyyntöjen kohdalla.

Jos käytät WPGraphQL-lisäosaa, varmista, että asiakassovelluksesi tekee GET-pyyntöjä kyselyille (Queries) aina kun mahdollista. Jos frontend tekee kaiken datanhaun POST-pyynnöillä, Seravon HTTP-välimuisti ohitetaan, PHP joutuu käsittelemään jokaisen pyynnön, ja sivuston suorituskyky heikkenee merkittävästi suurilla liikennemäärillä.

2. Automatisoi välimuistin tyhjennys webhookeilla

Kun frontend on erillään, Seravon tavalliset WordPress-välimuistin tyhjennykset (esim. julkaisun tallentamisen yhteydessä) eivät automaattisesti päivitä erillisen palvelimen tai selainpään välimuistia. Varmista tarvittaessa webhookeilla (esim. Jamstack-toteutuksissa), että frontend käännetään tai sen välimuisti nollataan, kun WordPressissä julkaistaan uutta sisältöä.

Yleisimmät virhetilanteet

  • Sivuston osoite näyttää tyhjää valkoista sivua staattisen asennuksen jälkeen: Varmista, että kääntämäsi React/Vue-sovelluksen .js- ja .css-resurssien polut index.html-tiedostossa ovat oikein suhteessa verkkotunnuksen juureen, eikä tiedostoja yritetä hakea väärästä alihakemistosta.

  • CORS-virhe (Cross-Origin Resource Sharing): Jos frontend pyörii eri verkkotunnuksella (esim. Vercelissä) kuin Seravolla oleva WordPress-backend, selain voi estää rajapintakutsut. Varmista, että WordPress on määritetty sallimaan pyynnöt frontend-verkkotunnuksesta (esim. asettamalla oikeat CORS-otsakkeet functions.php-tiedostossa tai käyttämällä tähän tarkoitettua CORS-lisäosaa).

  • Headless-sivusto on hidas: Avaa selaimesi kehittäjätyökalut (Network-välilehti) ja tarkista rajapintakutsujen HTTP-otsakkeet. Jos Seravon palvelimen vastaus sisältää otsakkeen X-Cache: MISS tai BYPASS staattisen sisällön kyselyille, välimuisti ei toimi. Yleisin syy tähän on POST-metodin käyttö tietojen hakemiseen. Vaihda pyynnöt GET-metodiin.

Katso myös

Huolellisesti suunniteltu headless-arkkitehtuuri yhdistää modernin JavaScript-käyttöliittymän ja WordPressin joustavan sisällönhallinnan tinkimättä suorituskyvystä. Mikäli tarvitset apua rajapintojen välimuistituksen optimoinnissa tai ympäristön konfiguroinnissa headless-käyttöön, asiakaspalvelumme auttaa osoitteessa [email protected].

Vastasiko tämä kysymykseesi?