Čeština pro PHP 3.0

Co to umí:

Co je k tomu potřeba

Kompilace a konfigurace

Kompilace PHP

Viz soubor INSTALL v distribuci PHP. 

cd php-3.0RC4/
patch -p1 < patch-czech-php-3.0
make --with-apache=/usr/local/apache-1.3b6/
make install

Kompilace Apache

Následující návod platí pro verzi 1.3b6 a vyšší. 

cd apache-1.3b6/
./configure --activate-module=src/modules/php3/libphp3.a
make "EXTRA_CFLAGS=-DCHARSET"

Přidání typu pro konverzi statických html stánek

Do conf/srm.conf je třeba přidat: 

AddType application/x-httpd-php3-charset .html

Použití

Známé znakové sady

Funkce v PHP skriptech

string setoutputcharset(string charset)

Nastaví výstupní kódování (posílá se klientovi). Vrací nastavené kódování nebo FALSE (když nebyl parametr rozpoznán jako známá znaková sada).

string setinputcharset(string charset)

Nastaví vstupní kódování (soubor na disku). Vrací nastavené kódování nebo FALSE (když nebyl parametr rozpoznán jako známá znaková sada).

string getoutputcharset()

Vrátí nastavení výstupního kódování.

string getinputcharset()

Vrátí nastavení vstupního kódování.

bool setconvertcharset(string input, string output)

Nastaví kódování pro funkci convertcharset. Vrací TRUE nebo FALSE.

string convertcharset(string s)

Provede konverzi stringu s v závislosti na nastavení setconvertcharset.

string setandconvertcharset(string input, string output, string s)

Nastaví kódování pomocí setconvertcharset a poté zavolá convertcharset

string hitoutputcharset()

Nastaví na základě informací od klienta (User-Agent, Accept-Charset a podobně) vhodnou výstupní konverzi. Vrací požadované kódování nebo FALSE.

Nastavení v conf/httpd.conf

V souborech httpd.conf (resp. php3.ini a .htaccess) je možné nastavit další vlastnosti konverze:

php3_input_charset charset

Nastavuje konverzi vstupu (soubor na disku). Tak je možné mít na serveru souboru v různém typu kódování.
Pokud není nastaveno, nic se nekonvertuje.

php3_hit_charset on|off

Nastaví, zda se má provádět automatické rozpoznávání výstupní konverze pro klienta funkcí _php3_startupcharset.
Funkce sbírá informace z cookie, query stringu a případně volá php3_hitoutputcharset, aby zjistila kódování podporované klientem a nastaví na tuto hodnotu cookie.

php3_charset_id

Jméno cookie (resp. parametru v QUERY_STRING) pro nastavení konverze pro klienta. Standard je charset.

php3_charset_domain

Jméno domény (nutné psát s tečkou na začátku) nebo počítače, která se posílá v cookie.

php3_charset_expires

Doba, po které vyprší platnost cookie (v sekundách). 0 znamená "nenastavovat".

Konverze statických html stránek

Pro konverze statických stránek je třeba povolit php3_hit_charset, zvolit vstupní kódování php3_input_charset a změnit typ souborů html na application/x-httpd-php3-charset (viz konfigurace).

Autoři a kam psát hlášení o chybách

Pavel Kolesnikov
Jaromír Koutek

Diskuzní klub o php-czech