[klasa,php5] Różne wersje językowe strony (w plikach), moja gotowa klasa (prosze o opinie) Opcje

[rafalp]

Zamieszczam prostą bardzo uniwersalną klasę (z zastosowaniem do małych projektów) i może komuś się przyda a za dodatkowe sugestie, pomysły lub wytkanie jakiś błędów będę wdzięczny.

Wszystko opiera się na plikach i zczytaniu pliku do tablicy, zapisaniu tłumaczeń wiersz po wierszu a następnie pobraniu wybranego wiersza i wypisaniu go na stronie.

Klasa nadaje się najbardziej na tłumaczenie już gotowego projektu gdyż użycie polega na tłumaczeniu jakiegoś fragmentu tekstu, zapisanie do pliku(ów) przetłumaczenia a następnie wywołanie metody.

[PHP] pobierz, plaintext 
<?php
class Language
{
/*******************************
* Author: Rafal @ Pawlukiewicz . com
********************************/
/**
 * License
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * If you modify this class, or have any ideas to improve it, please contact me!
 * You are allowed to redistribute this class, if you keep my name and my contac
 on it.
 *
 *
 **/
 
 
public $language;	//actual language set
public $folder;		 // catalog where we storage file
public $myfile;	  // file with translation
public $default;	 // file with translation
public $extension;	 //  language file extention
public $error;		 // if some error appear
public $show_error;  // if we want to show error message on website
 
function __construct($set_default = "en") // default language
{
 $this->folder = "include/language/";
 $this->extension = ".lang";
 $this->default = $set_default;
 $this->error = false;
 $this->show_error = true; // change it if you do not want show error message
}
 
function e($text, $n)
{
 if($this->language == '')
  $this->language = $this->default;
 
 $source = $this->folder . $this->language . $this->extension;
 if(file_exists($source))
  $this->myfile = file($source);
 else
  $this->error = true;
 
 if(($n > 0) AND ($n <= count($this->myfile)) AND !($this->error))
  {
	$text = $this->myfile[intval($n)-1];
	return($text);
  }
 
  if($this->error AND $this->show_error)
	$this->ShowError();
}
 
function ShowError()
{
 echo "[We have a problem with (" . $this->language . ") translation file]";
 $this->show_error = false; // show only one error message per website
}
}
 
/*
 
===========
== USING: ==
===========
$lang = new Language("pl");			 // inicjacja z domyślnym językiem
 
$lang->language = $some_session->lang;	// ustawienie aktualnego języka pobranego np. z sesji
$lang->language = "pl";				 // ustawienie ręczne aktualnego języka
echo $lang->e("arbitrary_text", 1);			  // wstawienie tekstu gdzie "arbitrary_text" oznacza naszą interpterację/nazwę pola który chcemy wyświetlić a drugi parametr (1) znacza numer wiersza z pliku tłumaczeń który chcemy wstawić.
 
*/
?>
[PHP] pobierz, plaintext 

Ten post edytował rafalp 17.07.2008, 12:44:24

[cojack]

Taka o ta klasa, bazuje bardziej na wyświetlaniu całego pliku niż wczytywaniu plików językowych. Gdzie są np zdefiniowane grupy stałych... taka moja dygresja.
Ja osobiście teraz będę się przerzucał na XML'a jako pliki językowe. Ciekawa sprawa. Jak chcesz to umieść to swoją klasę na phpclasses.org tylko opisz ją bardziej i nadaj licencje, bo Ci jej nie uwzględnia.

[bim2]

Z tym numerem wiersza to normalnie przegięcie, nie mogłeś dać normalnie $lang->e('jakis_lang');

[rafalp]

Takich klas jest już od groma.
Zrobiłem coś co mi odpowiadało przy małym projekcie. Jak komuś nie odpowiada konwencja po prostu będzie używać innego typu tłumaczeń strony.

Pozatym klase można wykorzystać do innych celów jeśli ktoś ma troche wyobraźni np. wstawiania warunkowego elementów HTML.

pozdr.

Ten post edytował rafalp 22.07.2008, 10:38:32

[vokiel]

Nie będę się wdawał w przydatność tej klasy, bo to zależy od tego jakie kto ma zapotrzebowanie. Ale czepię się jednego:

[PHP] pobierz, plaintext 
<?php
function __construct($set_default = "en")
{
 $this->folder = "include/language/";
 $this->extension = ".lang";
 $this->default = $set_default;
 $this->error = false; // jeśli ustawiasz to w konstruktorze to daj możliwość zmiany z zewnątrz na nie be
zpośrednio z klasy
 $this->show_error = true; // j.w.
}
// czyli albo dajesz to w deklaracji przed konstruktorem
public $error=false;
public $show_error=true;
 
albo przerób kostrukor, tak, żeby można było to ustawić w zależności od danej potrzeby, a nie globalnie w kodzie klasy, czyli np:
function __construct($set_default = "en", $error=false, $show_error=true)
{
 $this->folder = "include/language/";
 $this->extension = ".lang";
 $this->default = $set_default;
 $this->error = $error;
 $this->show_error = $show_error;
}
?>
[PHP] pobierz, plaintext 

Co do podawania nr wiersza tłumaczenia to troche zamotane, bo kto przy 245liniach tłumaczenia będzie pamiętał, że tutaj to akurat była linia 156 a nie np 157. Poza tym ile można mieć tłumaczeń jednego elementu, w jednym języku? Raczej jedno.
Moim zdaniem lepiej chyba zrobić na zasadzie fraza_do_przetłumacznia=tłumaczenie.