Jotkin ohjelmat tarvitsevat muutoksia PHP:n oletusasetuksiin. Moduuli-PHP:ta varten asetukset ovat tiedostossa .htaccess, josta Kapsilla FCGI:nä ajettava PHP ei kuitenkaan osaa niitä lukea. Tämän ohjeen avulla on lisäksi mahdollista muokata PHP:n asetuksia paljon laajemminkin.

Käyttäjäkohtaisen asetustiedoston luonti

Kapsilla on käytössä .user.ini-tiedosto, joka mahdollistaa PHP:n oletusasetusten helpon mukauttamisen. Tiedosto .user.ini tehdään siihen hakemistoon, mihin halutaan vaikuttaa. Esimerkiksi tiedosto ~/sites/käyttäjä.kapsi.fi/www/.user.ini vaikuttaa kaikkiin käyttäjä.kapsi.fi:n PHP-asetuksiin.

Tiedoston sisältö voi olla yksinkertaisimmillaan esimerkiksi seuraavanlainen:

post_max_size = 128M
upload_max_filesize = 128M

Eri asetukset on listattu PHP:n dokumentaatiossa. Myös valmiista php.ini-tiedostosta voi ottaa oppia, mutta kaikkia php.inin sisältämiä asetuksia ei tarvitse kopioida .user.iniin.

Muutosten kokeileminen

PHP:n käytössä olevat asetukset löytyvät phpinfon kautta: Luo asetusten testaamista varten phpinfo.php-tiedosto, jossa on rivi:

<?php phpinfo(); ?>

Voit tarkkailla sivulta asetuksia, joita yrität muuttaa. "Local Value" -sarakkeessa pitäisi näkyä tekemäsi muutokset. Virheelliset .user.inin rivit eivät päädy käyttöön.