Not Found

Přepínání jazyků v php

Jednoduchá šablona pro vícejazyčný web

Nedávno jsem na icq s někým probíral přepínání jazyků. Řešení to bylo sice rychlé, ale už méně efektivní. Při změně jazyku se změnil adresář, ze kterého se načítalo menu a obsah. URL zůstávala stejná – na jedné adrese vyhledávače najdou více verzí webu což určitě není nejlepší řešení.

Teď jsem s k tomu vrátil a upravil (teda komplet přepsal) ten skript tak, aby tento neduh neměl.

V návrhu skriptu jsem si do požadavků, co by tento skript měl umět:

• jednoduché přepnutí jazyku
• zapamatování jazyku pro danou relaci i pro relace následující (přes sessions a cookies)
• pro každý jazyk jinou URL. Odkazy jsou v následujícím tvaru tvujweb/jazyk/xxx
• jednoduché přidání dalšího jazyku bez dalších složitých úprav na více místech skriptu (jen zadání další hodnoty do pole array)
• při zobrazení obsahu stránky např. clanek1.php v češtině při přepnutí na jiný jazyk otevřít taktéž tuto stránku v jiném jazyce (jestli existuje, jinak zobrazit úvod v daném jazyce).

Ukázka fungování skriptu

Pro fungování této kostry webu jsou potřeba tyto soubory:

• index.php (v rootu, rozhoduje na který jazyk se přesměruje)
• funkce.php (pomocné funkce pro zjednodušení obsahu indexů, přehlednější, jednodušší úprava)
• styl.css (nastylování výsledného webu – pro všechny jakyzy dohromady)
• jazyk/index.php (kostra webu v každé jazykové složce)
• jazyk/menu.php (menu webu v daném jazyce)
• jazyk/uvod.php (úvod webu v daném jazyce)

Hlavní index.php

Jak jsem již psal, tento soubor se stará o přesměrování na správnou jazykovou verzi webu. Jeho obsah:

<?php
require "funkce.php"; // Funkce, nastavení jazyků, startování sessions

// zavolám index.php?lang=en
if(isset($_GET["lang"])){ // Pokud jsme poslali požadavek na změnu jazyku
  $lang=$_GET["lang"];  // nastavím hodnotu jazyku
  if(in_array($lang,$JazykyDir)){ // Zkontroluji, zda je požadovaný jazyk mezi jazyky, které jsou k dispozici
    $_SESSION['jazyk']=$lang; // Nastavím si do session hodnotu s jazykem

    // Pokud jsme byli na nějaké kontrétní stránce, třeba tvujweb/cz/index.php?page=odkaz1 a stránka odkaz1.php je i v novém jazyce
    if(isset($_GET['page']) and file_exists($lang."/".$_GET['page'].".php")){
      $Link=$lang."/index.php?page=".$_GET['page'];
      // Nastavíme tuto stránku zpět a před to dáme nový jazyk
    }else{
      $Link=$lang."/index.php";
      // Pokud volaný soubor v daném jazyce neexistuje, voláme jen index daného jazyku.
    }
    setcookie("lang", $lang , time()+31536000);
    // Nastavíme hodnotu jazyku do cookies, aby při další návštěvě webu se otevřel "správný jazyk"
    header("location: $Link");
    exit;
    // Přesměrujeme na požadovaný jazyk, popřípadě i s kontrétním souborem
  }else{ // Jazyk není mezi podporovanými jazyky - toto by se nemělo stát, pokud ale někdo změní URL...
    echo "This language is not between supported languages.";
    echo "See this page in default language - <a href='".$JazykyDir[0]."/index.php'>Link</a>";
    // poskytneme uživateli návrat zpět na standardní jazyk
  }
}else{ // návštěvník nevolal po změně jazyku, podíváme se jestli už nemá nastavený jazyk v cookies
  if(isset($_COOKIE['lang']) and in_array($_COOKIE['lang'],$JazykyDir) ){
    // Má v cookies hodnotu jazyku, který je mezi podporovanými, přesměrujeme ho tam, na jakém jazyce minule zkončil
    $Link=$_COOKIE['lang']."/index.php";
  }else{ // nebyl tu ještě nebo má v cookies nesmysl (třeba už nepodporovaný jazyk), přesměrujeme ho na standardní jazyk (první jazyk v poli)
    $Link=$JazykyDir[0]."/index.php";
  }
  header("location: $Link");
  exit;
}
?>

Funkce.php

V tomto souboru se dá nastavit nový jazyk a jsou zde funkce pro zjednodušení.

<?php
session_start(); // startujeme sessions


$JazykyDir= array("cz","en","sk"); // nastavení jazyků a složek, ve kterém jsou soubory.
// Pro přidání nového jazyku stačí pouze zapsat tento jazyk do tohoto pole. Název jazyku je shodný s adresářem, kde jsou umístěné soubory.

// Funkce slouží pro vtoření odkazů k přepnutí na jiný jazyk.
// Její parametr je $Vyrad a $SetToLang
function UdelejOdkazBez($Vyrad,$SetToLang){
  $Href = "../index.php"; // odkaz na hlavní index
  $FirstChar="?";
  $QueryString=null;
  foreach ( $_GET as $key=>$value) {
    if ($key != $Vyrad){
        $QueryString.= $FirstChar.$key."=".$value;
        $FirstChar="&amp;";
    }
  }
  $Odkaz=$Href.$QueryString.$FirstChar."lang=".$SetToLang;
  return $Odkaz; // funkce vrací odkaz
}

// Funkce pro zapsání odkazů na jiné jazyky
function OdkazyJazyku(){
  $SlozkaJazyku=substr(strrchr(dirname($_SERVER['SCRIPT_FILENAME']), "/" ), 1); // Zjistíme, v kterém souboru se momentálně nacházíme
  $JazykyDir=$GLOBALS['JazykyDir']; // Vezmeme si dovnitř funkce proměnnou $JazykyDir
  if(in_array($SlozkaJazyku,$JazykyDir)){ // jestli je aktuální složka v jazycích -
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($SlozkaJazyku==$JazykyDir[$i]){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><strong>".strtoupper($JazykyDir[$i])."</strong></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'>".strtoupper($JazykyDir[$i])."</a> ";
      }
    }
  }else{
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($i==0){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><strong>".strtoupper($JazykyDir[$i])."</strong></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'>".strtoupper($JazykyDir[$i])."</a> ";
      }
    }
  }
  echo $OdkazyJazyku;
}

// Funkce - popis viz http://pecan.cz/index.php?id=44&n=konec-ramcu-v-cechach
function ZobrazObsah(){
  if (isset($_GET['page'])){        // pokud byl odeslán ?page= ...
    $soubor=$_GET['page'];
    $soubor2= dirname($_SERVER['SCRIPT_FILENAME'])."/".$soubor.".php";
      if(file_exists($soubor2)){      //pokud soubor existuje, načteme ho do středu
        if(substr_count($soubor,"../")>0){ // pokud je v parametru alespoň 1x ../ neumožíme soubor načíst
          echo "<h3>Upozornění</h3>Nelze nahrát soubor v nadřazeném adresáři!";
        }elseif($soubor=="index" or $soubor=="/index"){
          echo "<h3>Upozornění</h3>Index nemůže načíst sám sebe!";
        }else{
           include ($soubor2);
        }
      }else{                //pokud soubor neexistuje, zavoláme 404.php
        include "404.php";
      }
  }else{                  // Pokud nebyl paramentr page volaný, načteme uvod.php
    include "uvod.php";
  }
}
?>

Změna Nastavení jazyků:
Standardně je to pole

$JazykyDir= array("cz","en","sk");

// Chceme-li např. přidat francoužštinu ve složce fr, upravíme pole na
 $JazykyDir= array("cz","en","sk","fr");

Jazyk, který je uveden jako první v tomto poli je ve skriptu dále veden jako standardní.

index.php v každé složce jazyku

S tímto souborem můžete dále pracovat jak potřebujete. Na začátku souboru však musí být načten soubor funkce.php. Funkce OdkazyJazyku() už podle názvu zobrazuje jazyky, include „menu.php“ vloží menu a funkce ZobrazObsah() se postará o zobrazení obsahu ve středu stránky.

<?php require "../funkce.php"; ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="cs">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=win-1250" />
  <meta http-equiv="Content-Language" content="cs" />
  <link rel='stylesheet' type='text/css' href='../styl.css' />
  <title>peCan.cz - Přepínání jazyků v php tutorial</title>
</head>
<body>
<div id="okraj">
  <p align="right">
    <?php OdkazyJazyku(); ?>
  </p>
    <div id="logo">
    <h1>peCan.cz - Přepínání jazyků v php tutorial</h1>
    </div>
        <div id="menu">
      <?php include "menu.php"; ?>
        </div>
        <div id="obsah">
      <?php ZobrazObsah();?>
        </div>
  <div id="reset"></div>
  <div id="paticka">
    Patička, (c) 2007 peCan.cz - <a href="http://pecan.cz/index.php?id=47">stáhni skript</a>
  </div>
</div>
</body>
</html>

Každý jazyk má svoje menu.

Ukázka skriptu: pecan.cz/ukaz­ky/lang

Download skriptu: zde

Komentáře: 29

.:. peCan | www | mail

Tak udělat by to šlo. Realizaci ale nechám na někom jiném. Složité to není, stačí se podívat třeba zde - odkaz

Odpověď | 2007-04-26 14:49:36 | Příspěvek upraven: 2007-04-26 14:51:07

.:. Krutas57 | www | mail

No já osobně bych to řešil spíš pomocí define("zprava","Zpráva v daném jazyce"); a pak to ze scriptu zavolám pouze pomocí echo zprava;. Takle si udělám všechny zprávy do souboru lang_cz.php a do lang_en.php atd... Pak jen stačí přepínat jeden soubor pomocí např. require $_SESSION["Lang"]; a toť vše funguje.
To se mi zdá o něco pohodlnější

Odpověď | 2007-04-26 22:20:14

.:. Krutas57 | www | mail

Dva soubory - no to ano.
Více jazyků na jedné URL - no nevím čemu by to mělo vadit; najednou tam bude vždycky jen jeden takže návštěvníkovi to je IMHO vlastně fuk a vyhledávače stejnak uviděj jen default jazyk.
Psaní <?php ?> - no to ale musíš vždycky když chceš kombinovat suchej HTML kód a php... V tom tvojem zdrojáku na jazyk/index.php to tam taky hodně je.
Ta moje metoda má využití spíš v redakčních systémech a tak (např. jeden dost známej konkurenčí tvojemu, ale rozhodně ne lepší to používá). Tam se většinou všechno dělá pomocí php komplet (symčky na výpisy dat apod.) a tak ti to <?php ?> moc nevadí
PS: Neber to jako hádku to je jakože slušná debata

Odpověď | 2007-04-27 23:54:46

.:. peCan | www | mail

Vsak v pohode. Vadit by to melo autorovi webu - ma vice jazyku a z vyhledavacu chodi jen na standardni jazyk. Coz by asi nikdo nechtel.

Pokud bych to mel resit jazykovymi soubory - udelal bych si 1 xml soubor kde bych psal vsechny jazyky... Melo by to aspon tu vyhodu, ze bych nemel tech jazykovych souboru nekolik.

2007-04-28 10:10:02

.:. peCan | www | mail

Profík Jak ty ses mi tu zatoulal, to je mi záhada

ad 1) OK, my bad.
ad 2) Zlozvyk. Navíc jazyk přepínáš snad jen jednou, takže snad nevadí že si alokuji pár bajtů z paměti na vytvoření nové proměnné.
ad 3) Není třeba ale je to vhodné

Ad kultura: nejspíš patříš k těm, kteří komentář "//" na konci řádku považují za chybu a píšou jedině "/* */ " nebo složené závorky píšou na nový řádek. Jinak nechápu, co se ti na mém stylu psaní nelíbí, osobně mi přijde přehledný.

Odpověď | 2007-04-29 00:00:15

.:. Krutas57 | www | mail

Gettext - pokud se to musí instalovat, tak bych s tim na většině (free)hostingů nepočítal - na vlastním serveru to je asi dobrý.

1) Pokud vím, tak parser postupně vykonává příkazy scriptu a když je všechny vykoná tak se jeho práce ukončí. Takže pokud je header na konci tak se po jeho odeslání script stejnak ukončí, ne?

2) Přehlednost, jednoduchost - příklad s mysql dotazem:

insert into clanky (id, jmeno, popis, text, odkazy, prilohy) values ('".$_POST["id"]."', '".$_POST["jmeno"]."', '".$_POST["popis"]."', '".$_POST["text"]."', '".$_POST["odkazy"]."', '".$_POST["prilohy"]."')

NEBO

insert into clanky (id, jmeno, popis, text, odkazy, prilohy) values ('".$id."', '".$jmeno."', '".$popis."', '".$text."', '".$odkazy."', '".$prilohy."')

Co je přehlednější?

3) Podle norem W3C by tam mělo být $amp;

Kultura: Právě dělám vlastní RS (při porovnání funkcí by to bylo PikoRS ), takže mam v compu i na freehostingu několik RS u kterejch pozoruju funkce atd. Ale pokud potřebuju zjistit ve zdrojáku jak některá funkce funguje, tak nahlížim jen do zdrojáků MiniRS, protože u ostatních RS jsou zdrojáky (pro mě) dost nepřehledný. Takže myslim že tenhle styl je dobrej.

Odpověď | 2007-04-29 10:24:09

.:. peCan | www | mail

$lang mam malym protoze je to pres GET, zbytek v tom skriptu jsou velkym, krome $soubor, coz je promenna taky z GETu.

Pouzivam 2 IDE (doma obvas ZDE a praci VS) a vzdy se mi vlezou 2 postrani sloupce a je tam vice nez 80 znaku na radek. Pravdou je, ze vice jak 120 znaku na radek pouzivam vyjimecne.

Tato diskuse se mi ale zda zbytecna - ja se ve svem stylu dokonale vyznam a to je pro me dulezite. Jedine co mi "vadi", ze soucasne pouzivam CZ i EN, ale to je podle me detail

Jinak dik za rady, budu se snazit dbat na kazdy detail.

Odpověď | 2007-05-01 21:00:56

<?php
session_start(); // startujeme sessions


$JazykyDir= array("cz","en","sk"); // nastavení jazyků a složek, ve kterém jsou soubory.
$JazykyDirFlags= array("<img src='obrCZ.jpg' alt='cz'/>","<img src='obrEN.jpg' alt='en'/>","<img src='obrFR.jpg' alt='fr'/>");


// Pro přidání nového jazyku stačí pouze zapsat tento jazyk do tohoto pole. Název jazyku je shodný s adresářem, kde jsou umístěné soubory.

// Funkce slouží pro vtoření odkazů k přepnutí na jiný jazyk.
// Její parametr je $Vyrad a $SetToLang
function UdelejOdkazBez($Vyrad,$SetToLang){
  $Href = "../index.php"; // odkaz na hlavní index
  $FirstChar="?";
  $QueryString=null;
  foreach ( $_GET as $key=>$value) {
    if ($key != $Vyrad){
        $QueryString.= $FirstChar.$key."=".$value;
        $FirstChar="&amp;";
    }
  }
  $Odkaz=$Href.$QueryString.$FirstChar."lang=".$SetToLang;
  return $Odkaz; // funkce vrací odkaz
}

// Funkce pro zapsání odkazů na jiné jazyky
function OdkazyJazyku(){
  $SlozkaJazyku=substr(strrchr(dirname($_SERVER['SCRIPT_FILENAME']), "/" ), 1); // Zjistíme, v kterém souboru se momentálně nacházíme
  $JazykyDir=$GLOBALS['JazykyDir']; // Vezmeme si dovnitř funkce proměnnou $JazykyDir
  if(in_array($SlozkaJazyku,$JazykyDir)){ // jestli je aktuální složka v jazycích -
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($SlozkaJazyku==$JazykyDir[$i]){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><strong>".$JazykyDirFlags[$i]."</strong></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'>".$JazykyDirFlags[$i]."</a> ";
      }
    }
  }else{
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($i==0){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><strong>".$JazykyDirFlags[$i]."</strong></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'>".$JazykyDirFlags[$i]."</a> ";
      }
    }
  }
  echo $OdkazyJazyku;
}

// Funkce - popis viz http://pecan.cz/index.php?id=44&n=konec-ramcu-v-cechach
function ZobrazObsah(){
  if (isset($_GET['page'])){        // pokud byl odeslán ?page= ...
    $soubor=$_GET['page'];
    $soubor2= dirname($_SERVER['SCRIPT_FILENAME'])."/".$soubor.".php";
      if(file_exists($soubor2)){      //pokud soubor existuje, načteme ho do středu
        if(substr_count($soubor,"../")>0){ // pokud je v parametru alespoň 1x ../ neumožíme soubor načíst
          echo "<h3>Upozornění</h3>Nelze nahrát soubor v nadřazeném adresáři!";
        }elseif($soubor=="index" or $soubor=="/index"){
          echo "<h3>Upozornění</h3>Index nemůže načíst sám sebe!";
        }else{
           include ($soubor2);
        }
      }else{                //pokud soubor neexistuje, zavoláme 404.php
        include "404.php";
      }
  }else{                  // Pokud nebyl paramentr page volaný, načteme uvod.php
    include "uvod.php";
  }
}
?>

// nastavení jazyků.
$JazykyDir= array("cz","en");
// Pro přidání nového jazyku stačí pouze zapsat tento jazyk do tohoto pole. Název jazyku je shodný s adresářem, kde jsou umístěné soubory.

function UdelejOdkazBez($Vyrad,$SetToLang){ // Funkce slouží pro vtoření odkazů k přepnutí na jiný jazyk.
  $Href = "../index.php";
  $FirstChar="?";
  $QueryString=null;
  foreach ( $_GET as $key=>$value) {
    if ($key != $Vyrad){
        $QueryString.= $FirstChar.$key."=".$value;
        $FirstChar="&";
    }
  }
  $Odkaz=$Href.$QueryString.$FirstChar."lang=".$SetToLang;
  return $Odkaz; // funkce vrací odkaz
}

// Funkce pro zapsání odkazů na jiné jazyky
function OdkazyJazyku(){
  $SlozkaJazyku=substr(strrchr(dirname($_SERVER['SCRIPT_FILENAME']), "/" ), 1); // Zjistíme, v kterém souboru se momentálně nacházíme
  $JazykyDir=$GLOBALS['JazykyDir']; // Vezmeme si dovnitř funkce proměnnou $JazykyDir
  if(in_array($SlozkaJazyku,$JazykyDir)){ // jestli je aktuální složka v jazycích -
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($SlozkaJazyku==$JazykyDir[$i]){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><img src='../design/".$JazykyDir[$i].".bmp' alt='".strtoupper($JazykyDir[$i])."' title='".strtoupper($JazykyDir[$i])."' /></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><img src='../design/".$JazykyDir[$i].".bmp' alt='".strtoupper($JazykyDir[$i])."' title='".strtoupper($JazykyDir[$i])."' /></a> ";
      }
    }
  }else{
    $OdkazyJazyku=null;
    for($i=0;$i<count($JazykyDir);$i++){
      if($i==0){
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><img src='../design/".$JazykyDir[$i].".bmp' alt='".strtoupper($JazykyDir[$i])."' title='".strtoupper($JazykyDir[$i])."' /></a> ";
      }else{
        $OdkazyJazyku.="<a href='".UdelejOdkazBez("lang",$JazykyDir[$i])."'><img src='../design/".$JazykyDir[$i].".bmp' alt='".strtoupper($JazykyDir[$i])."' title='".strtoupper($JazykyDir[$i])."' /></a> ";
      }
    }
  }
  echo $OdkazyJazyku;
}

function ZobrazObsah(){
...

Jméno
Web
Mail
Kontrola	Zadejte číslo pět
Text
	Zde formátuje Texy! (syntaxe)