Lokaali kehitys mahdollistaa WordPress-sivuston koodin, teemojen ja lisäosien kehittämisen ja testaamisen turvallisesti omalla tietokoneellasi ilman, että muutokset vaikuttavat tuotantosivustoon.
Suosittelemme paikalliseen kehitykseen Seravon valmista Docker-pohjaista kehitysympäristöä, joka jäljittelee Seravon tuotantopalvelimia. Tuotantoa vastaava ympäristö varmistaa yhteensopivuuden ja nopeuttaa julkaisua, sillä paikallisesti testattu koodi toimii sellaisenaan myös tuotannossa.
Miten kehitysympäristö toimii?
Seravon paikallinen ympäristö rakentuu kevyen Docker-kontin ympärille, joka luo eristetyn ja tuotantoa vastaavan palvelinympäristön suoraan omalle työasemallesi. Toisin kuin raskas virtuaalikone, Docker-kontti käynnistyy nopeasti ja kuluttaa vain vähän järjestelmäresursseja.
WordPressin ja PHP/nginx/MariaDB-palvelinohjelmistojen lisäksi kontti sisältää valmiina samat Seravon omat ylläpitokomennot (wp-pull-production-*, wp-watch, wp-test) sekä vianmääritys- ja profilointityökalut kuin tuotantoympäristökin.
Koska kaikki Seravon projektit noudattavat yhtenäistä hakemistorakennetta (Seravo/wordpress-projektipohja), voit noutaa kopion olemassa olevasta tuotantosivustostasi paikalliselle koneellesi muutamalla komennolla.
Näin pääset alkuun
Voit ottaa paikallisen kehitysympäristön käyttöön seuraavassa järjestyksessä:
Asenna Docker ja projektipohja: Seuraa artikkelia Lokaali kehitys Dockerin avulla asentaaksesi Dockerin ja käynnistääksesi ensimmäisen kehityskontin.
Tarkista ympäristön asetukset: Tutustu ohjeeseen Lokaalin ympäristön asetukset, jos haluat mukauttaa projektin verkkotunnusta (
config.yml), PHP-versiota tai muita asetuksia.Nouda sisältö tuotannosta: Jos kehität olemassa olevaa sivustoa, tuo tietokanta, lisäosat ja teemat tuotannosta ohjeen Sivuston noutaminen kehitysympäristöön mukaisesti.
Hyödynnä kehitystyökaluja: Ota käyttöön kontin sisäiset työkalut, kuten
WP-CLI, selaimen automaattisesti päivittäväwp-watchsekä Xdebug-profilointi.
Paikalliset osoitteet ja oletuskirjautumistiedot
Uudessa, tyhjässä kehitysympäristössä käytetään oletuksena wordpress.local-verkkotunnusta ja alla olevia tunnuksia. Jos olet määrittänyt projektille oman paikallisen osoitteen (esim. esimerkki.local), korvaa wordpress.local omalla paikallisella osoitteellasi.
Palvelu / Työkalu | Osoite (URL) | Oletustunnukset | Käyttötarkoitus |
WordPress ja hallintapaneeli |
| Käyttäjä: | Paikallinen WordPress-asennus ja hallintapaneeli. |
Adminer |
| Käyttäjä: | Selainpohjainen työkalu MariaDB-tietokannan hallintaan. |
Mailcatcher |
| Ei kirjautumista | Kaappaa lähetetyt sähköpostit testausta varten. |
Webgrind |
| Ei kirjautumista | Xdebug-suorituskykyprofiilien tarkastelu. |
Browsersync-konsoli |
| Ei kirjautumista | Live-päivitysten hallinta, kun |
MariaDB-tietokanta |
|
| Tietokantayhteydet komentoriviltä ( |
Huomio tuotantokopiosta: Kun noudat tuotantosivuston tietokannan lokaaliin ympäristöön (wp-pull-production-db), paikallinen tietokanta ylikirjoitetaan. Tämän jälkeen oletustunnus vagrant ei ole enää käytössä, vaan hallintapaneeliin kirjaudutaan tuotantosivuston omilla käyttäjätunnuksilla (tai luomalla uusi paikallinen pääkäyttäjä WP-CLI:llä).
Yleisimmät virhetilanteet
Osoite
[http://wordpress.local](http://wordpress.local)ei avaudu selaimessa: Varmista ensin, että Docker-kontti on käynnissä (docker ps). Tarkista myös, että paikallinen nimipalvelu (dnsmasq) tai työasemasihosts-tiedosto ohjaa.local-päätteiset osoitteet paikalliseen osoitteeseen127.0.0.1.Sisäänkirjautuminen
vagrant-tunnuksella epäonnistuu tietokannan tuonnin jälkeen: Tuotantotietokannan tuonti korvaa paikalliset käyttäjätilit. Luo uusi paikallinen ylläpitäjä kontin sisällä komennollawp user create kehittaja [email protected] --role=administrator --user_pass=salasana.Docker-kontti ei käynnisty porttivarauksen vuoksi (
port is already allocated): Työasemallasi on käynnissä toinen paikallinen palvelin (kuten paikallinen nginx, Apache tai toisen projektin Docker-kontti), joka varaa portit80tai443. Pysäytä muut paikalliset palvelimet ennen kontin käynnistämistä.Sivusto ohjaa paikallisen osoitteen tuotantosivustolle: Tarkista, että projektin
config.yml-tiedostossa paikallinen osoite on määritetty oikein ja aja tarvittaessa osoitteiden korvaus paikallisessa ympäristössä komennollawp search-replace 'https://tuotanto-osoite.fi' 'http://wordpress.local'.
Katso myös
Tuotantoympäristöä vastaava paikallinen kehityskontti tekee muutosten testaamisesta nopeaa ja turvallista ennen tuotantoon vientiä. Mikäli tarvitset apua paikallisen kehitysympäristön käyttöönotossa tai sivuston noutamisessa konttiin, asiakaspalvelumme auttaa osoitteessa [email protected].
