PHP-versiot ja päivitykset

Moduuli 8: Varmuuskopiot, testiympäristö ja PHP-päivitykset · Lukuaika: 10 minuuttia

Oppimistavoite: Tämän oppitunnin jälkeen osaat valmistella, tehdä ja tarvittaessa perua PHP-päivityksen turvallisesti.

Keskeiset käsitteet: PHP:n elinkaari (aktiivinen tuki, vain tietoturva, loppu), WordPressin, teeman ja lisäosien yhteensopivuus, vanhentunut (deprecated), varoitus, kriittinen virhe, Sivuston eheys, virheloki, testiympäristö, palauttaminen, päivityksen teettäminen

Miksi PHP-versioilla on väliä

WordPress, teema ja lisäosat on kirjoitettu PHP:llä (oppitunti 1.2). PHP:stä ilmestyy uusi versio joka vuosi (8.3, 8.4, 8.5, ...). Jokaista versiota ylläpidetään tietyn ajan:

• aktiivinen tuki: kaksi vuotta virhe ja tietoturvakorjauksia;
• vain tietoturva: sen jälkeen vielä kaksi vuotta pelkkiä tietoturvakorjauksia;
• loppu (end of life): ei enää korjauksia, ei edes tietoturva-aukkoihin.

Tilanne 8. marraskuuta 2026, php.net:n mukaan:

Sivusto, joka käyttää versiota ilman päivityksiä, pyörii ohjelmistolla, jonka tunnetuille aukoille ei enää tehdä korjauksia. Lisäksi uudemmat versiot ovat huomattavasti nopeampia (oppitunti 6.3). Ja wordpress.org suosittelee PHP 8.3:a tai uudempaa (tilanne marraskuussa 2026). Tavoite on siis pysyä ajan tasalla joka vuosi, ei tehdä yhtä isoa hyppyä viiden vuoden välein.

Miksi päivitys voi rikkoa jotain

Jokainen uusi PHP-versio muuttaa jotain. Toiminnot, jotka on jo vuosia merkitty vanhentuneiksi (deprecated), poistetaan, ja säännöt tiukkenevat. Pari tunnettua esimerkkiä:

• PHP 8.0 poisti muun muassa create_function()- ja each()-funktiot, ja monet varoitukset muuttuivat virheiksi;
• PHP 8.2 merkitsi objektien ominaisuuksien dynaamisen luomisen vanhentuneeksi, mikä on yleistä vanhemmissa lisäosissa.

Ilmoituksia on kolmenlaisia, ja ero on tärkeä:

WordPress itse pysyy yleensä hyvin mukana uusissa PHP-versioissa. Riski on vanhoissa lisäosissa ja teemoissa, varsinkin jos niitä ei ole päivitetty pitkään aikaan tai ne ovat räätälöityjä.

Nykyisen version löytäminen

• WordPressissä: Työkalut > Sivuston eheys, välilehti Tiedot, kohdassa Palvelin: PHP-versio. Sivuston eheys varoittaa myös, jos versiosi on vanhentunut.
• Webhotellin hallintapaneelissa: DirectAdminissa CloudLinuxin kanssa kohdassa Select PHP version (nykyisen version perässä "(current)").
• Joskus palvelin paljastaa sen otsakkeessa X-Powered-By: PHP/8.3.x. Mieluummin ei (oppitunti 7.4), mutta jos se näkyy, asia selviää nopeasti.

Huomaa: monilla webhotelleilla PHP-versio koskee koko pakettia, eli kaikkia siinä olevia sivustoja. Vanha sivusto samassa paketissa voi jarruttaa sinua. Tämä on lisäsyy siivota vanhoja sivustoja tai antaa niille oma paketti.

Päivitys vaihe vaiheelta

1. Päivitä ensin. Päivitä WordPress, teema ja kaikki lisäosat nykyisellä PHP-versiolla. Suuri osa ongelmista ratkeaa jo tällä, koska tekijät mukauttavat koodinsa uusiin PHP-versioihin.
2. Katso mitä lisäosat kertovat. wordpress.org:n lisäosasivulla näkyy vaadittu PHP-versio; muutoslokissa (changelog) usein "compatible with PHP 8.x". Lisäosa, jota ei ole päivitetty vuosiin (oppitunti 5.3), on ehdokas vaihdettavaksi.
3. Tee varmuuskopio (oppitunti 8.1).
4. Testaa testiympäristössä (oppitunti 8.3). Jos webhotelli sallii eri PHP-version per sivusto, aseta testiympäristö uuteen versioon. Jos tämä ei onnistu (yksi versio per paketti), testaa testiympäristössä toisessa paketissa, paikallisesti, tai valitse rauhallinen hetki tuotannossa niin, että vanha versio on valmiina palautettavaksi.
5. Vaihto: valitse uusi versio hallintapaneelissasi. DirectAdminissa CloudLinuxin kanssa valitset sen kohdassa Select PHP version ja klikkaat Apply; ilman Apply-painiketta mikään ei muutu.
6. Tarkista heti: avaa sivusto ja klikkaa muutaman sivun läpi, myös hallinta, lomake ja (verkkokaupassa) kassalla asiointi. Katso virhelokista (oppitunti 5.4) uusia PHP Fatal error -rivejä.
7. Laajennukset ja asetukset: joillakin webhotelleilla PHP-laajennukset ja asetukset (kuten memory_limit) kuuluvat tiettyyn versioon. Tarkista vaihdon jälkeen, että ne ovat kunnossa uudessa versiossa.

Jos jokin menee pieleen

• Kriittinen virhe: palauta vanha versio (tämä onnistuu useimmilla webhotelleilla välittömästi), jotta sivusto toimii taas. Etsi virhelokista, mikä lisäosa tai teema oli kyseessä (polku näkyy virheilmoituksessa), päivitä se, vaihda se tai pyydä tekijältä ratkaisua. Yritä sen jälkeen uudelleen.
• Vain deprecated-ilmoituksia: ei syytä palata takaisin. Mutta kyseessä on varoitus: seuraavassa versiossa siitä voi tulla virhe. Merkitse muistiin, mikä lisäosa on kyseessä.
• Räätälöity koodi, joka ei enää toimi: vanha sivusto, jonka on rakentanut verkkosivuston tekijä, voi sisältää koodia, jota kukaan ei enää ylläpidä. Silloin koodin pitää muokata joku, joka osaa PHP:tä. Jotkut webhotellit, myös WebOké, tarjoutuvat tekemään tämän puolestasi.

Älä jätä sivustoa "ikuisesti" vanhaan versioon yhden lisäosan vuoksi, joka ei pysy mukana. Se on vain ongelman lykkäämistä, ja ongelma kasvaa joka vuosi.

Lisävarmuutta etukäteen

Jos haluat mennä pidemmälle: PHP_CodeSnifferillä ja PHPCompatibilityWP-säännöillä voit tarkistuttaa lisäosien ja teemojen koodin asioiden varalta, jotka eivät toimi uudemmassa PHP-versiossa, ilman että sivusto on käynnissä. Se löytää paljon, mutta ei kaikkea. Testaus testiympäristössä on silti tarpeen.

Käytännössä: näin se näkyy hallintapaneelissa

Esimerkkinä käytämme DirectAdminia CloudLinuxin kanssa. cPanelissa tämä on usein nimeltään MultiPHP Manager tai Select PHP Version, Pleskissä PHP Settings.

1. Avaa Select PHP version (kohdassa Extra Features).
2. Klikkaa versiota kohdassa PHP version, valitse uusi versio ja klikkaa Apply.
3. Tarkista välilehdet Extensions ja Options uudelle versiolle.
4. Tarkista sivusto ja virheloki. Jos jokin ei toimi, valitse vanha versio ja Apply.

Yhteenveto

• Jokainen PHP-versio saa kaksi vuotta aktiivista tukea ja kaksi vuotta vain tietoturvaa, sen jälkeen ei enää korjauksia. 8. marraskuuta 2026 8.1 ei saa enää mitään ja 8.2 vielä vuoden 2026 loppuun.
• Päivitys rikkoo lähinnä vanhoja lisäosia ja teemoja; deprecated on varoitus, fatal error pysäyttää sivuston.
• Järjestys: päivitä kaikki, tarkista lisäosat, varmuuskopio, testaa testiympäristössä, vaihda, tarkista heti.
• Jos jokin menee pieleen, palauta vanha versio, etsi syyllinen virhelokista ja korjaa se; älä jää jumiin vanhaan versioon.
• Monilla webhotelleilla versio koskee koko pakettia; siivoa vanhat sivustot.

Tietovisa

Tehtävä

Tehtävä A8.4: Onko PHP-versiosi vielä tuettu? Katso kohdasta Työkalut > Sivuston eheys (välilehti Tiedot, Palvelin), mitä PHP-versiota sivustosi käyttää, ja syötä se yhdessä verkkotunnuksesi kanssa. Ohjelma vertaa versiota php.net:n tuettujen versioiden listaan: vihreä aktiivisen tuen aikana, oranssi vain tietoturvan aikana, punainen jos päivityksiä ei enää tule. Jos palvelimesi näyttää version otsakkeessa X-Powered-By, ohjelma tarkistaa myös, vastaako se syöttämääsi tietoa (ja ilmoittaa, että otsake kannattaisi piilottaa, oppitunti 7.4).

Tehtävä D8.4: Päivityssuunnitelma. Kirjoita suunnitelma sivustosi päivittämiseksi uusimpaan PHP-versioon, jota webhotellisi tarjoaa. Täytä: nykyinen ja tavoiteversio, mitä lisäosia ja teemoja sinulla on ja tukevatko ne tavoiteversiota (mistä löysit tiedon), missä testaat (testiympäristö, toinen paketti, paikallisesti), miten voit palata takaisin, ja milloin teet sen. Toteuta se, jos mahdollista, ja merkitse muistiin, mitä virhelokissa näkyi.

Lue lisää

Nämä artikkelit kuvaavat vaiheet WebOkén hallintapaneeleissa; muissa paneeleissa toiminta on samankaltaista.

• DirectAdmin-ohje 14.1: PHP-version valinta (Select PHP version)
• DirectAdmin-ohje 14.6: Virheet PHP-päivityksen jälkeen ja virhelokin löytäminen
• PHP-version ja PHP-asetusten muuttaminen (ja mitä tehdä, jos päivityksen jälkeen ilmenee virheitä)
• DirectAdmin-ohje 14.2: PHP-laajennusten käyttöönotto ja poistaminen käytöstä
• WebOké-käyttöopas 6.11: PHP-päivityksen tilaaminen
• Tuetut PHP-versiot (php.net, englanniksi): https://www.php.net/supported-versions.php
• PHP ja WordPress-versiot (make.wordpress.org, englanniksi): https://make.wordpress.org/core/handbook/references/php-compatibility-and-wordpress-versions/