Liitännäinen ei asennu, teeman lataus katkeaa puolivälissä? Hallintapaneeli näyttää "Allowed memory size exhausted"? Useimmiten syyllinen on yksi tiedosto: php.ini.

Tämä on PHP:n pääasetustiedosto: se määrittää, kuinka paljon muistia skripteille varataan, kuinka kauan niitä suoritetaan ja mitkä tiedostokoot hyväksytään. Tavallisella hostingilla nämä rajat on asetettu alas, ja palveluntarjoaja säästää resursseja.

Alla kerrotaan, mistä php.ini löytyy missä tahansa ympäristössä (WAMP, XAMPP, Linux, cPanel) ja mitä viittä direktiiviä kannattaa muokata WordPressiä varten vuonna 2026. Mukana tarkat luvut, ei arvailua.

💡 Pikakatsaus:

• Luo testi-PHP-tiedosto phpinfo-funktiolla, niin näet heti polun php.ini-tiedostoon millä tahansa palvelimella
• WAMPissa, XAMPPissa ja cPanelissa polku löytyy käyttöliittymän kautta ilman koodin muokkaamista
• WordPressin keskeiset asetukset: memory_limit, max_execution_time, upload_max_filesize, post_max_size ja max_input_vars
• Tarkista muutosten jälkeen todelliset rajat phpinfo()-funktiolla tai WP-CLI:llä varmistaaksesi, ettei palveluntarjoaja ohittanut muutoksia

Mikä php.ini on ja miksi siihen kosketaan

php.ini on tekstitiedosto, joka sisältää direktiivejä, jotka ohjaavat PHP:n toimintaa palvelimella. Se latautuu jokaisen PHP-prosessin käynnistyessä ja määrittelee rajat: muisti, suoritusaika, ladattavan tiedoston koko, virhetaso.

WordPressille viisi direktiiviä on kriittisiä. memory_limit varaa RAM-muistia sivujen käsittelyyn, ja nykyaikaiset teemat ja rakentajat (Gutenberg, Elementor) vaativat helposti 256 Mt tai enemmän. max_execution_time rajoittaa skriptin suoritussekunteja: jos liitännäinen tuo demosisältöä tai WooCommerce generoi raportteja, oletusarvo 30 sekuntia takaa katkeamisen. upload_max_filesize ja post_max_size hallitsevat latauksia: teeman ZIP-tiedosto voi painaa yli 40 Mt, ja palveluntarjoajan raja on 2 Mt. Lopuksi max_input_vars rajoittaa POST-muuttujien määrää, ja kun valikkokohtia on 1000 ja oletusarvo on 2000, valikon tallennus katkeaa ilman varoitusta.

Hyvä uutinen: php.ini-tiedostoa voi muokata jopa edullisessa jaetussa hostingissa. Huono uutinen: ensin se täytyy löytää, ja polku riippuu käyttöjärjestelmästä, hallintapaneelista ja PHP:n asennustavasta (Apache-moduuli, CGI/FastCGI, PHP-FPM).

Miten php.ini löydetään: yleispätevä tapa phpinfo()-funktiolla

Varmin tapa, joka toimii millä tahansa palvelimella, on luoda testi-PHP-tiedosto phpinfo()-funktiolla.

Luo tiedosto millä tahansa nimellä ja .php-päätteellä (esimerkiksi info.php) ja laita siihen:

1
<?php phpinfo(); ?>

Siirrä tiedosto sivuston juureen (FTP:llä, hostingin tiedostonhallinnalla tai WP-CLI:llä) ja avaa selaimessa: https://your-site.com/info.php.

Etsi avautuneelta sivulta rivi Loaded Configuration File, tämä on täydellinen polku aktiiviseen php.ini-tiedostoon. Jos PHP toimii Apache-moduulina, polku näkyy rivillä Configuration File (php.ini) Path, jolloin itse tiedostoa ei välttämättä ole olemassa ja se täytyy luoda käsin.

Tarkistuksen jälkeen poista info.php välittömästi, se paljastaa palvelimen konfiguraation yksityiskohtia, mikä on turvallisuusriski.

Missä php.ini on WAMPissa

WAMPissa (Windows-kokoonpano: Apache + MySQL + PHP) polku php.ini-tiedostoon löytyy suoraan ilmaisinalueelta.

Klikkaa WAMP-kuvaketta hiiren oikealla painikkeella, vie hiiri PHP-kohdan päälle ja valitse php.ini, tiedosto avautuu tekstieditoriin. Jos kokoonpanossa on useita PHP-versioita, varmista, että olet valinnut sen, jolla sivusto toimii (näkyy ilmaisinalueella: WAMP → PHP → Version).

Vaihtoehtoinen polku WAMP-valikon kautta: vasen klikkaus kuvakkeeseen → PHP → php.ini. Tiedosto sijaitsee fyysisesti polussa C:\wamp64\bin\php\phpX.Y.Z\php.ini (tai C:\wamp\bin\... vanhemmissa versioissa).

Missä php.ini on XAMPPissa

XAMPPissa Windowsilla ja Linuxilla polku php.ini-tiedostoon löytyy hallintapaneelin kautta. Avaa XAMPP Control Panel ja klikkaa Config-painiketta Apache-moduulin rivillä. Valitse pudotusvalikosta PHP (php.ini), tiedosto avautuu editoriin.

Jos Config-painiketta ei ole (vanha XAMPP-versio), siirry suoraan: C:\xampp\php\php.ini Windowsissa tai /opt/lampp/etc/php.ini Linuxissa.

Tee muutosten jälkeen Apachelle uudelleenkäynnistys Stop → Start -painikkeilla hallintapaneelissa.

Missä php.ini on Linuxissa (VPS / dedikoitu)

Linux-palvelimella ilman hallintapaneelia php.ini löytyy yhdellä terminaalikomennolla:

1
php -i | grep "Loaded Configuration File"

Tuloste on jotakuinkin tällainen:

1
Loaded Configuration File => /etc/php/8.2/cli/php.ini

Tärkeä huomio: komentorivin PHP (CLI) ja web-palvelimen PHP (Apache/Nginx) käyttävät usein eri php.ini-tiedostoa. Yllä oleva komento näyttää CLI-version polun. Web-palvelimen polun löydät luomalla info.php-tiedoston edellisen osion menetelmällä ja avaamalla sen selaimessa, tai ajamalla:

1
ls /etc/php/*/apache2/php.ini
2
ls /etc/php/*/fpm/php.ini

Tyypilliset sijainnit riippuvat PHP-versiosta ja web-palvelimesta:

• Apache: /etc/php/8.2/apache2/php.ini
• PHP-FPM (Nginx): /etc/php/8.2/fpm/php.ini
• Yleinen polku (jos PHP on käännetty käsin): /usr/local/lib/php.ini

Muutosten jälkeen käynnistä web-palvelin uudelleen: sudo systemctl restart apache2 tai sudo systemctl restart php8.2-fpm.

Missä php.ini on cPanelissa ja muissa hallintapaneeleissa

Jaetulla hostingilla, jossa on cPanel, php.ini-tiedosto sijaitsee yleensä sivuston juurihakemistossa, public_html-kansiossa. Nähdäksesi sen:

• Kirjaudu cPaneliin ja avaa File Manager
• Siirry public_html-kansioon
• Etsi php.ini tiedostolistasta

Jos tiedostoa ei ole, luo se + File -painikkeella. Kirjoita tarvittavat direktiivit ja tallenna. Palvelin ottaa asetukset käyttöön muutamassa minuutissa.

Nykyaikaisilla palvelimilla MultiPHP Manager (cPanel) tai Select PHP Version on yhä yleisempi, niiden avulla voit muokata php.ini-tiedostoa web-käyttöliittymän kautta ilman tiedostonhallintaa. Jos hallintapaneelisi tukee tällaista työkalua, käytä sitä: pienempi syntaksivirheiden riski.

Erillinen tapaus: .user.ini. Palvelimilla, joissa on PHP-FPM (FastCGI), sivuston juuressa oleva php.ini saatetaan jättää huomiotta; sen sijaan luodaan .user.ini-tiedosto samoilla direktiiveillä. Tarkista palveluntarjoajan dokumentaatiosta, kumpaa tiedostoa käytetään.

Suositellut php.ini-asetukset WordPressille (voimassa 2026)

php.ini-tiedoston "oletusarvot" eivät ole muuttuneet vuosikymmeniin ja ne on suunniteltu yksinkertaisille skripteille, ei moderneille sisällönhallintajärjestelmille. WordPress nykyaikaisilla lisäosilla vaatii huomattavasti korkeampia rajoja. Alla on suositellut arvot, jotka on testattu käytännössä.

Keskeiset direktiivit

1
memory_limit = 512M
2
max_execution_time = 300
3
upload_max_filesize = 128M
4
post_max_size = 128M
5
max_input_vars = 4000
6
max_input_time = 300
7
file_uploads = On

safe_mode-direktiivi on poistettu PHP:stä versiosta 5.4 alkaen, älä lisää sitä asetuksiin. Jos näet tämän rivin vanhassa php.ini-tiedostossa, poista se epäröimättä.

Välimuisti (opcache)

Tuotantosivustoilla opcache on pakollinen, se antaa 2-3-kertaisen nopeusedun välimuistittamalla käännetyn tavukoodin:

1
opcache.enable = 1
2
opcache.memory_consumption = 256
3
opcache.max_accelerated_files = 10000
4
opcache.revalidate_freq = 2
5
opcache.validate_timestamps = 1

Virhelokitus

Julkisella sivustolla virheiden näyttäminen ruudulla tulee olla pois päältä, mutta lokituksen tulee olla päällä:

1
display_errors = Off
2
log_errors = On
3
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT

Vaihtoehtoiset menetelmät:.htaccess ja wp-config.php

php.ini-tiedostoon ei aina ole pääsyä. Joillakin palveluntarjoajilla on olemassa kiertotapoja.

.Htaccessin kautta (Apache + mod_php)

Lisää .htaccess-tiedostoon sivuston juuressa:

1
php_value memory_limit 512M
2
php_value upload_max_filesize 128M
3
php_value post_max_size 128M
4
php_value max_execution_time 300

Tämä toimii vain, jos PHP toimii Apache-moduulina (mod_php). PHP-FPM:n kanssa php_value-direktiivit aiheuttavat 500-virheen, tällöin käytä .user.ini-tiedostoa.

Wp-config.php:n kautta

Lisää ennen riviä /* That's all, stop editing! */:

1
define('WP_MEMORY_LIMIT', '512M');
2
define('WP_MAX_MEMORY_LIMIT', '512M');

WP_MEMORY_LIMIT asettaa rajan julkiselle puolelle, WP_MAX_MEMORY_LIMIT hallintapuolelle. Tämä ei korvaa php.ini-tiedostoa, mutta ratkaisee usein "Allowed memory size exhausted" -virheen juuri silloin, kun palvelimen asetuksiin pääsy on rajoitettu.

Video: php.ini:n etsiminen ja muokkaaminen käytännössä

Lyhyt video, jossa näytetään visuaalisesti kaikki kuvatut menetelmät phpinfo():sta cPanelin MultiPHP Manageriin:

⁉️🤔 Usein kysytyt kysymykset

Miksi mikään ei muuttunut php.ini:n muokkauksen jälkeen?

PHP-prosessi ei käynnistynyt uudelleen. Käynnistä Apache uudelleen (systemctl restart apache2 tai paneelin painikkeella), PHP-FPM (systemctl restart phpX.Y-fpm) tai odota automaattista uudelleenkäynnistystä jaetulla hostingilla (yleensä 2-5 minuuttia). Varmista, että muokkaat juuri sitä php.ini-tiedostoa, jonka phpinfo() näyttää Loaded Configuration File -rivillä (yhdellä palvelimella voi olla useita).

Tarkista muutosten jälkeen aina todellinen raja phpinfo():n kautta: palveluntarjoaja voi ohittaa joitakin asetuksia yleisillä asetuksilla. Jos arvo ei muuttunut, luo .user.ini sivuston juureen (PHP-FPM:ää varten) tai ota yhteyttä tukeen.

Minkä memory_limitin WordPress todella tarvitsee vuonna 2026?

256M: turvallinen minimi tyypilliselle sivustolle, jossa on 10-15 lisäosaa. Jos käytössä on sivunrakentaja (Elementor, Bricks, Breakdance), WooCommerce tai monimutkainen välimuistilisäosa, aseta 512M. Gutenbergia käyttävät sivustot, joissa on paljon lohkoja ja malleja, kallistuvat myös 512M:n suuntaan. Vanhoissa oppaissa suositeltu 128M ei enää riitä nykyaikaiselle WordPressille: pelkkä ydin Full Site Editing -teeman kanssa voi saavuttaa tämän rajan.

Poikkeus: halpa jaettu hosting, jossa on ehdoton yläraja. Jos palveluntarjoaja ei nosta memory_limit-arvoa yli 128M:n, harkitse sopimuksen tai palveluntarjoajan vaihtamista: tällä rajalla toimiva sivusto kaatuu lähes jokaisen päivityksen yhteydessä.

Kumpi on tärkeämpää: php.ini:n vai wp-config.php:n muokkaaminen?

php.ini toimii järjestelmätasolla, wp-config.php sovellustasolla. Jos sinulla on pääsy php.ini-tiedostoon, muokkaa sitä: rajat ovat voimassa yleisesti eivätkä nollaudu ydintä päivitettäessä. Käytä wp-config.php-tiedostoa varavaihtoehtona, kun palveluntarjoaja on lukinnut php.ini-tiedoston. WP_MEMORY_LIMIT wp-config.php-tiedostossa ohittaa php.ini-tiedoston memory_limit-arvon WordPressin osalta, mutta ei vaikuta max_execution_time-, upload_max_filesize- ja muihin asetuksiin: ne täytyy muokata .htaccess- tai .user.ini-tiedoston kautta.