Tämä ohje käsittelee PHP:n ajamista CGI-ohjelmana. Aiemmin ohje oli olennainen PHP:n ajamisessa ilman safemodea, mutta nykyään vastaava asetus on jo valmiiksi käytössä. Ohjetta voi kuitenkin käyttää tarvittaessa asetusten muuttamiseen.

Asetus vaikuttaa rekursiivisesti kaikkiin hakemiston ja sen alihakemistojen tiedostoihin. Yleensä se on paras tehdä ohjelman juurikansioon.

Luodaan php.fcgi

Luodaan haluttuun hakemistoon tiedosto php.fcgi . Tiedoston lopussa on oltava vähintään yksi rivinvaihto, jonka monet editorit luovat automaattisestikin.

#!/usr/bin/php5-cgi

Skriptille annetaan käyttöoikeus 700:

chmod 700 php.fcgi

Luodaan .htaccess

Luodaan .htaccess -tiedosto samaan hakemistoon. Jos tiedosto on jo olemassa, seuraavat rivit lisätään alkuun.

RemoveHandler .php
AddType application/cgi-php php
Action application/cgi-php /~käyttäjä/polku/php.fcgi

Polku /~käyttäjä/polku/php.fcgi muutetaan php.fcgi tiedoston oikeaksi osoitteeksi. Polun alku on URL-osoitteessa verkkotunnuksen jälkeinen osa. Esimerkiksi:

http://kapsi.fi/~käyttäjä/polku/php.fcgi -> /~käyttäjä/polku/php.fcgi
http://tunnus.kapsi.fi/polku/php.fcgi -> /polku/php.fcgi

Mahdolliset ongelmatilanteet

Windows-käyttäjien on siirrettävä tiedostot ascii-tilassa tai luotava ne palvelimella ssh-yhteyden kautta, jotta rivinvaihdoista tulee oikeanlaiset. Useimpien SFTP-ohjelmien automaattitunnistus ei osaa käsitellä .htaccess-tiedostoa, koska sillä ei ole päätettä.

Ongelmat tämän ohjeen käytössä johtuvat usein vääristä käyttöoikeuksista. Muut yleiset virheet ja ohjeita lisäavun pyytämiseen on annettu perinteisen cgi-ohjelman ohjeessa.