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:
Käännä JavaScript-sovelluksesi valmiiksi tuotantoversioksi (build).
Siirrä käännetty
index.htmlja sen vaatimat resurssit (JavaScript- ja CSS-tiedostot) sivuston juurihakemistoon/data/wordpress/htdocs/.Tämän jälkeen kävijät, jotka saapuvat sivuston etusivulle, näkevät automaattisesti JavaScript-sovelluksesi.
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.fitaiapi.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 polutindex.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: MISStaiBYPASSstaattisen sisällön kyselyille, välimuisti ei toimi. Yleisin syy tähän onPOST-metodin käyttö tietojen hakemiseen. Vaihda pyynnötGET-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].
