/home/Śpiechu->Blog

Tworzenie pakietów ICMP w PHP

Śpiechu — Wed, 16 May 2012 17:26:00 +0000

Od tygodnia na poważnie wziąłem się za rozpracowywanie protokołów sieciowych. Dzisiaj schodzimy na poziom najniższy jaki się da w programowaniu, czyli zer i jedynek. Ja jako osoba za 2 miesiące rozpoczynająca zawodowo przygodę z programowaniem (ojej, wydało się ;-) ) muszę mieć dosyć dobre pojęcie jak to się dzieje, że wpisuję adres www w pasku adresu przeglądarki, naciskam enter i pokazuje się Fejsbuk. Oczywiście zwykli użytkownicy internetu nie muszą wiedzieć jak to dokładnie działa w myśl zasady „nie muszę być mechanikiem samochodowym żeby jeździć autem”.

Wobec tego na warsztat wziąłem na początek rzecz dosyć prostą: ICMP, a nawet tylko jego wycinek pod nazwą Echo request/Echo reply. Komunikaty ICMP stanowią podstawę działania internetu. Każda maszyna podłączona do sieci potrafi zadawać pytania i otrzymywać odpowiedzi w postaci ICMP. Tak naprawdę zdubluję funkcjonalność wbudowaną w każdy system operacyjny pod powszechnie znaną nazwą ping.

Ręczne tworzenie pakietów w PHP nie ma oczywiście większego sensu poza edukacyjnym (no chyba, że tworzymy coś nietypowego lub dostosowujemy się do już istniejącego protokołu). Jeśli potrzebujemy coś „pingnąć”, wywołujemy polecenie ping shella z poziomu skryptu PHP i tyle.

W Gist zamieściłem klasę gotową do użytku. Na Linuksie będzie problem z jej odpaleniem, gdyż bez roota nie wywołamy funkcji socket_create(). Ten temat jest na tyle ciekawy, że zostawię sobie na następny wpis.

Sama struktura protokołu jest dosyć prosta. Mamy 6 elementów:

8 bitów typ żądania (0x08 w przypadku echo request, 0x00 w przypadku echo reply),
8 bitów kod żądania (0x00),
16 bitów suma kontrolna (tzw. internet checksum, o którym trochę niżej),
16 bitów identyfikator (losowa liczba z zakresu 0x000 - 0xFFFF),
16 bitów nr sekwencyjny (0x00),
8– bitów dane (znaki ASCII).

Operując niskopoziomowo musimy zaprzyjaźnić się z funkcjami pack() i unpack() w celu stworzenia i odczytu reprezentacji bitowej ciągu. W przypadku ICMP będzie to wyglądało tak:

const PACKET_REQUEST_TEMPLATE = 'CCnnnA*';
const PACKET_RESPOND_TEMPLATE = 'Ctype/Ccode/nchecksum/nuid/nseq/A*message';

Widać, że 1 bajt możemy odzwierciedlić w postaci typu unsigned char, a 2 bajty w postaci unsigned short.

Teraz może nasunąć się pytanie jak wypełnić pole checksum, skoro jest gdzieś w środku? Odpowiedź jest prosta: w pole wpisujemy tymczasowo 0x00, obliczamy sumę kontrolną dla całości, a następnie zastępujemy wynikiem. Jest to dokładnie 3 i 4 bajt. Jak obliczyć sumę kontrolną? Jest do tego RFC z 1988 r. pod nazwą Computing the Internet Checksum. Jednak zanim zniechęcicie się suchym żargonem informatycznym wytłumaczę po ludzku:

Cały pakiet ćwiartujemy na kawałki po 16 bitów,
sumujemy wszystko,
jeśli w wyniku powstaje nam jakaś nadwyżka w postaci 17 i więcej bitu, odcinamy ją, a następnie dodajemy do pozostałych 16tu,
ponownie sprawdzamy czy nie powstała nam nadwyżka,
odwracamy wynik.

Zapis w PHP:

protected function computeChecksum($packet) {
 
  // treat the whole packet as 16 bits unsigned short integers
  $seqPer16bits = unpack('n*', $packet);
  $sum = array_sum($seqPer16bits);
 
  // if there is a carry above 16 bit, add it at the beginning
  $sum = ($sum >> 16) + ($sum & 0xFFFF);
 
  // double check if there is no new carry after previous addition
  $sum += ($sum >> 16);
 
  // return 16 bits negate
  return pack('n', ~$sum);
}

Jak „wkleić” wynik w dobre miejsce? Mała sztuczka:

$packet[2] = $checkSum[0]; // 3 bajt pakietu
$packet[3] = $checkSum[1]; // 4 bajt pakietu

Następnie możemy sobie stworzyć gniazdo i ustawić jakiś timeout:

$this->_socket = socket_create(
  AF_INET, SOCK_RAW, getprotobyname('icmp'));
 
socket_set_option(
  $this->_socket, SOL_SOCKET, SO_RCVTIMEO, array(
    'sec' => 1,
    'usec' => 0));

Jesteśmy gotowi do wysyłki:

public function sendPacket($destination, $message = self::DEFAULT_MSG, $port = 0) {
  $packet = $this->getNewPacket($message);
  socket_sendto(
    $this->_socket, $packet, strlen($packet), 0, $destination, $port);
 
  $respond = 0;
  socket_recvfrom($this->_socket, $respond, 255, 0, $destination, $port);
 
  // strip IP header
  return substr($respond, 20);
}

Jeśli odbieramy pakiet, warto poddać go analizie:

public function analyzeRespond($responsePacket) {
  $unpackedRespond = unpack(self::PACKET_RESPOND_TEMPLATE, $responsePacket);
  if ($unpackedRespond['type'] !== self::TYPE_RESPONSE) {
    throw new Exception('Bad response type');
  }
 
  if ($unpackedRespond['uid'] !== $this->_uid) {
    throw new Exception('Bad unique id');
  }
 
  // set 3rd and 4th checksum byte to 0x00
  // in order to calculate correct checksum
  $responsePacket[2] = pack('C', self::INITIAL_CHECKSUM);
  $responsePacket[3] = pack('C', self::INITIAL_CHECKSUM);
  if (pack('n*', $unpackedRespond['checksum']) !== $this->computeChecksum($responsePacket)) {
    throw new Exception('Bad checksum');
  }
  return $unpackedRespond['message'];
}

Zdaję sobie sprawę, że opis jest niepełny. Chciałem zwrócić uwagę na ciekawsze/trudniejsze momenty. Proponuję dokładnie przeanalizować sobie całą klasę z linka podanego powyżej.

Tak jak obiecałem, w następnym wpisie opiszę jak to wywoływać w możliwie bezpiecznym środowisku.

Creating EAN-13 barcode using CoffeeScript and HTML5 Canvas

Śpiechu — Mon, 30 Apr 2012 09:44:30 +0000

It’s been a long time since I’ve written my last english-spoken text. It was about Webworkers API. The visitors number has been achieved, so it’s time for the next topic. Now I’m going to talk about Canvas and some CoffeeScript tricks. Again I’m asking You to forgive me my „language glitches”.

Since I don’t like to get to know about something new in an abstract way, we’ll going to write a simple EAN-13 barcode generator. You meet it at every store, it saves time and money for merchants. Price can be attached to barcode instead of price tags. Imagine changing a price in the same 100 products. But how to generate one? Wikipedia has a nice description. EAN-13 is composed of GS1 organization numbers, company numbers, item reference and check digit.

This time I’m going to cover some CoffeScript features I didn’t talk about 2 posts earlier: extending classes and static properties. I’ll write one class computing „0101…” EAN-13 code and another one capable of drawing the code on HTML canvas element. I even created a public GitHub repository, so feel free to steal some code. Working example can be found here.

I won’t explain You all code here, only the most important parts. For example how to compute control digit?

computeControlSum: ->
  sum = 0
 
  # this one line of array comprehension substitutes four lines in pure JS
  sum += (if key % 2 then 3 else 1) * value for value, key in @eanArray
  controlSum = 10 - sum % 10
  if controlSum == 10 then controlSum = 0
  return controlSum

Piece of code above is translated into:

EAN13Generator.prototype.computeControlSum = function() {
  var controlSum, key, sum, value, _i, _len, _ref;
  sum = 0;
  _ref = this.eanArray;
  for (key = _i = 0, _len = _ref.length; _i < _len; key = ++_i) {
    value = _ref[key];
    sum += (key % 2 ? 3 : 1) * value;
  }
  controlSum = 10 - sum % 10;
  if (controlSum === 10) {
    controlSum = 0;
  }
  return controlSum;
};

As we can see we don’t need to worry about some temporary variables in CoffeScript.

Digits 2–7 in barcode (before the central „whiskers”) can be written as odd or even. Pattern depends on first barcode digit. It has been written as object literal:

class EAN13Generator
 
# some code here
 
  # this is how we create class properties
  # we can call to such property like EAN13Generator.LEFT_SIDE_CODING
  @LEFT_SIDE_CODING:
    0: ['odd', 'odd',  'odd',  'odd',  'odd',  'odd' ]
    1: ['odd', 'odd',  'even', 'odd',  'even', 'even']
    2: ['odd', 'odd',  'even', 'even', 'odd',  'even']
    3: ['odd', 'odd',  'even', 'even', 'even', 'odd' ]
    4: ['odd', 'even', 'odd',  'odd',  'even', 'even']
    5: ['odd', 'even', 'even', 'odd',  'odd',  'even']
    6: ['odd', 'even', 'even', 'even', 'odd',  'odd' ]
    7: ['odd', 'even', 'odd',  'even', 'odd',  'even']
    8: ['odd', 'even', 'odd',  'even', 'even', 'odd' ]
    9: ['odd', 'even', 'even', 'odd',  'even', 'odd' ]

The next interesing part is how to concatenate barcode string. Here’s how:

generateEANcode: ->
 
  # we're using class property to find out first 6 digits coding
  codingStyle = EAN13Generator.LEFT_SIDE_CODING[@eanArray[0]]
  eanCode = EAN13Generator.START_SENTINEL
  for i in [1..6]
    if codingStyle[i-1] == 'odd'
      eanCode += EAN13Generator.EAN_13_CODE_TABLE[@eanArray[i]].left.odd
    else
      eanCode += EAN13Generator.EAN_13_CODE_TABLE[@eanArray[i]].left.even
  eanCode += EAN13Generator.CENTRAL_SENTINEL       
  eanCode += (EAN13Generator.EAN_13_CODE_TABLE[@eanArray[i]].right) for i in [7..12]
  eanCode += EAN13Generator.END_SENTINEL

Class extension is realized through extends keyword.

class EAN13CanvasDrawer extends EAN13Generator
 
  # @canvasId is shorthand for @canvasId = canvasId
  constructor: (eanString, @canvasId) ->
 
    # we're launching EAN13Generator constructor
    super(eanString)

I’m using jCanvaScript JS library to draw on canvas. Below is the whole drawBarcode() method:

drawBarcode: ->
  jc.clear @canvasId
  jc.start @canvasId
  splitArray = @generateEANcode().split ''   
  barStartActual = @barStartX  
  for i, key in splitArray
    barHeightActual = @barHeight
 
    # barcode longer 'whiskers'
    if key in [0,1,2,45,46,47,48,49,92,93,94] then barHeightActual = @barLongerHeight
 
    # draw white stripe
    if i == '0'
      jc.rect barStartActual, @barStartY, @barWidth, barHeightActual, 'rgb(255,255,255)', true
    else
      jc.rect barStartActual, @barStartY, @barWidth, barHeightActual, 'rgb(0,0,0)', true
  barStartActual += @barWidth    
  jc.start @canvasId
 
  # drawing numbers below the stripes
  textStartActual = @textStartX
  for i, key in @eanArray
    if key in [1,7] then textStartActual += @textBreak
    jc.text(i, textStartActual, @textStartY).font "#{@textSize}px courier bold"
    textStartActual += @textStep
  jc.start @canvasId

The final execution of code is just as simple as:

barcodeDrawer = new EAN13CanvasDrawer $('input#ean_13').val(), 'canvas_1'
barcodeDrawer.drawBarcode()

Testowanie localStorage, embedded gist i CoffeeScript

Śpiechu — Sun, 15 Apr 2012 19:17:30 +0000

Mamy niedzielę, więc warto trochę poprogramować dla sportu (oczywiście zamiast uprawiania „normalnego” sportu :-) ). Z głupoty chciałem rozpracować kilka rzeczy. Przede wszystkim wprawić się trochę w CoffeeScript, a przy okazji sprawdzić w działaniu zapisywanie danych po stronie przeglądarki przy użyciu localStorage.

Moim dzisiejszym zamiarem było stworzenie strony z formularzem, w którym wpisywane wartości zapisywałyby się na bieżąco po stronie przeglądarki wpisującego. Powiedzmy, że jakaś sierotka podczas wypełniania formularza zamknie kartę/przeglądarkę i całe mozolne wpisywanie poszło w las. Dzięki localStorage wpisane dane nie zostaną skasowane, a formularz wypełni się automatycznie. Oczywiście niesie to za sobą szereg niebezpieczeństw, jak np. co w przypadku kogoś korzystającego z publicznego komputera, chcącego zamówić coś w sklepie internetowym i mu się nagle „odwidzi”? Następna osoba dostanie dane osobowe poprzednika na tacy. Minimalnym zabezpieczeniem byłby mechanizm kasujący dane jeśli są sprzed dłużej niż np. 2 minut.

Dodatkowo chciałem zrobić przycisk, który daje jakąś kontrolę nad przechowywanymi danymi. Efekt można sobie oglądać tutaj.

Używana przeze mnie wtyczka do kolorowania składni (WP-Syntax) nie obsługuje CS. Zamiast tego kod umieszczę za pomocą embedded gist z GitHub. Efekt jest bardzo ładny. Poniżej „mózg” formularza:

Efektu kompilacji nie pokazuję. Jeśli ktoś bardzo chce to może sobie podejrzeć plik storager.js.

Jeśli szukasz biblioteki backupu danych formularza w czasie rzeczywistym opartego o localStorage to polecam wtyczkę jQuery: Sisyphus.

Wygrzebane z GitHuba (5) : CoffeeConsole

Śpiechu — Mon, 09 Apr 2012 10:30:50 +0000

W piątym odcinku Waszego ulubionego cyklu pojawi się projekt z tygodniowym stażem na GitHubie pod tytułem CoffeeConsole. Jest to interaktywna konsola języka CoffeeScript dla przeglądarki Chrome. Do tej pory trzeba było używać okienka „TRY COFFEESCRIPT” na stronie http://coffeescript.org (brak podświetlanej składni) lub instalować Node.js i npm.

Dla niewtajemniczonych, CS jest tzw. „lukrem składniowym” na JavaScript, tzn. wynikiem kompilacji CS jest czysty JS (który z kolei jeszcze można ścieśnić jakimś „zmniejszaczem” — minifierem). Składnia CS przypomina najbardziej Pythona (bloki kodu rozdzielane na podstawie wcięć, array comprehensions). Domieszano również nieco Rubyego (znak „?” przy zmiennych będący sprawdzeniem czy zmienna istnieje i „@” dla pól obieku).

Po ściągnięciu i rozpakowaniu pakietu wystarczy przeciągnąć plik coffeeconsole.crx na okno otwartego Chroma i rozpocznie się instalacja dodatku. Otrzymamy 2 pola edycji — lewy dla źródłowego CS i prawy dla wynikowego kodu JS.

Poniżej zademonstruję działanie tego cuda:

###
Przykladowy kod naskrobany w 5 min., nie zwracajcie na niego uwagi.
 
W ten sposob w wynikowym JS powstanie komentarz np. dotyczacy licencji.
###
 
# wartosc od ktorej humor jest dobry
goodMoodThrottle = 51
 
# tworze literal obiektowy
peopleMood = 
    'Dawid'  : 100
    'Marta'  : 78
    'Adam'   : 53
    'Marian' : 45
 
# tworze funkcje o 2 parametrach
getMoodString = (name, goodMood) ->
    # zwracam uwage na konstrukcje if-then-else
    # is zamieniane na ===
    # oraz "#{zmienna} cos tam dalej"
    if goodMood is true then "#{name} ma dobry humor" else "#{name} ma zły humor jak cholera"
 
# konstrukcja for-of dla petli po literalach obiektowych
for name, moodLevel of peopleMood
    # kompilator sam domysli sie, ze chodzi nam o alert(getMoodString(name,(bool)))
    alert getMoodString name, goodMoodThrottle <= moodLevel <= 100

W okienku z prawej strony otrzymamy następujący wynik kompilacji:

/*
Przykladowy kod naskrobany w 5 min., nie zwracajcie na niego uwagi.
 
W ten sposob w wynikowym JS powstanie komentarz np. dotyczacy licencji.
*/
 
var getMoodString, goodMoodThrottle, moodLevel, name, peopleMood;
 
goodMoodThrottle = 51;
 
peopleMood = {
  'Dawid': 100,
  'Marta': 78,
  'Adam': 53,
  'Marian': 45
};
 
getMoodString = function(name, goodMood) {
  if (goodMood === true) {
    return "" + name + " ma dobry humor";
  } else {
    return "" + name + " ma zły humor jak cholera";
  }
};
 
for (name in peopleMood) {
  moodLevel = peopleMood[name];
  alert(getMoodString(name, (goodMoodThrottle <= moodLevel && moodLevel <= 100)));
}

Patrząc na liczbę linii kodu mamy spory zysk w stosunku do wynikowego kodu JS. Przy okazji nie zajmujemy się zbędnymi średnikami i nawiasami.

Jeśli jeszcze Was nie przekonałem do użycia to proponuję zobaczyć tworzenie klas:

class Human
    constructor: (@name) ->
 
    whatIsYourName: ->
        "Mam na imie #{@name}"
 
people = []
 
people.push new Human 'Andrzej'
people.push new Human 'Marian'
people.push new Human 'Lucjan'
 
alert human.whatIsYourName() for human in people

Wynik w JS:

var Human, human, people, _i, _len;
 
Human = (function() {
 
  Human.name = 'Human';
 
  function Human(name) {
    this.name = name;
  }
 
  Human.prototype.whatIsYourName = function() {
    return "Mam na imie " + this.name;
  };
 
  return Human;
 
})();
 
people = [];
 
people.push(new Human('Andrzej'));
 
people.push(new Human('Marian'));
 
people.push(new Human('Lucjan'));
 
for (_i = 0, _len = people.length; _i < _len; _i++) {
  human = people[_i];
  alert(human.whatIsYourName());
}

Dla bardziej zainteresowanych tematem CoffeeScriptu polecam książkę The Little Book on Coffee Script dostępną online.

O modyfikatorach w Smarty i opisie słownym interwałów czasu

Śpiechu — Fri, 16 Mar 2012 15:06:53 +0000

Pomysł na wpis dał mi kilka dni temu Facebook, a dokładniej ich totalnie niekonsekwentne oznaczenia co się kiedy wydarzyło na naszej tablicy. Raz jest to 23 minut(y) temu, raz 7 godz. temu, jeszcze inaczej około godziny temu. Być może różne ekipy robią osobno opisy czasu i stąd różnice. Postanowiłem dla sportu zmierzyć się z problemem. Powstało takie coś jak Timespan Smarty Modifier.

Opis jak to zainstalować, wymagania i sposób użycia możecie sobie przeczytać w moim kaleczonym angielskim w GitHubie. Tutaj chciałbym się skupić jak to działa. Najwygodniejszym sposobem korzystania z biblioteki jest poprzez modyfikator w szablonach Smarty, a więc {$jakaśZmienna|naszModyfikator}.

Przede wszystkim sama nazwa pliku musi nazywać się modifier.nazwa.php, za to funkcja smarty_modifier_nazwa($argument). Pierwszy argument automatycznie dostaje wartość zmiennej, dla której wywołujemy modyfikator. Jeśli chcemy, następne podajemy po dwukropku. Drobna uwaga: nigdy niczego nie „echujemy”, tylko zwracamy poprzez return. Chodzi o łańcuchowe łączenie modyfikatorów.

Z uwagi na to, że całość rozrosła się do ponad 400 linii kodu, nie ma sensu wszystkiego tutaj przytaczać. Skupię się na najważniejszych rzeczach.

Całość ma formę klasy abstrakcyjnej rozszerzanej przez poszczególne języki. Na podstawie zadeklarowanego języka skrypt próbuje znaleźć sobie właściwą klasę (fragm. modifier.timespan.php):

$className = 'Spiechu\TimeSpan\TimeSpan' . strtoupper($lang);
   if (class_exists($className)) {
      $timeSpan = new $className();
 
      // sprawdz czy klasa rozszerza AbstractTimeSpan
      if (!($timeSpan instanceof Spiechu\TimeSpan\AbstractTimeSpan)) {
         $timeSpan = new Spiechu\TimeSpan\TimeSpanEN();
      }
   } else {
 
      // jesli nie ma takiego jezyka lub klasa niewlasciwa uzywam angielskiego
      $timeSpan = new Spiechu\TimeSpan\TimeSpanEN();
   }

Potem tylko konfigurujemy klasę i zwracamy wynik:

$timeSpan->setStartDate($date)->showSuffix($suffix);
return $timeSpan->getTimeSpan();

W klasie AbstractTimeSpan z kolei mamy trochę logiki związanej z obliczaniem interwału:

$curDate = new \DateTime('now');
$diff = $curDate->diff($this->_startDate); //otrzymujemt obiekt DateInterval

Począwszy od największej jednostki (rok) odpytujemy $diff która z jego zmiennych publicznych jest większa od 0 oraz za pomocą metod isHalfUnit($actualUnit, $fullUnit), almostFullUnit($actualUnit, $fullUnit) sprawdzamy czy może przekroczyliśmy połowę obecnej jednostki, większej jednostki oraz czy nie można jej zaokrąglić do następnej całej.

Klasy rozszerzające implementują m.in. metodę getUnit($howMany, $unitSymbol, $half). Liczebniki angielskie są tak trudne, że potrzeba na nie aż 1 linijki:

if ($howMany > 1) $howMany = 2;
return $this->_units[$howMany][$unitSymbol];

Jeśli mowa o $this->_units to wygląda to tak:

private $_units = array(
   -1 => array('s' => 'just now'),
   0 => array('i' => 'half minute',
      'h' => 'half hour',
      'd' => 'half day',
      'm' => 'half month',
      'y' => 'half year'),
   1 => array('s' => 'a second',
      'i' => 'a minute',
      'h' => 'an hour',
      'd' => 'a day',
      'm' => 'a month',
      'y' => 'a year'),
   2 => array('s' => 'seconds',
      'i' => 'minutes',
      'h' => 'hours',
      'd' => 'days',
      'm' => 'months',
      'y' => 'years')
);

Polskie jednostki z kolei prezentują się dużo bardziej okazale (3 odmiany):

private $_units = array(
   -1 => array('s' => 'przed chwilą'),
   0 => array('i' => 'pół minuty',
      'h' => 'pół godziny',
      'd' => 'pół dnia',
      'm' => 'pół miesiąca',
      'y' => 'pół roku'),
   1 => array('s' => 'sekundę',
      'i' => 'minutę',
      'h' => 'godzinę',
      'd' => 'dzień',
      'm' => 'miesiąc',
      'y' => 'rok'),
   2 => array('s' => 'sekundy',
      'i' => 'minuty',
      'h' => 'godziny',
      'd' => 'dni',
      'm' => 'miesiące',
      'y' => 'lata'),
   5 => array('s' => 'sekund',
      'i' => 'minut',
      'h' => 'godzin',
      'd' => 'dni',
      'm' => 'miesięcy',
      'y' => 'lat')
);

Mało tego, w polskiej klasie mamy jeszcze jednostki specjalne :-) :

private $_specialUnits = array(
   'poltora' => array('s' => 'półtorej sekundy', // nigdy nie uzywane
      'i' => 'półtorej minuty',
      'h' => 'półtorej godziny',
      'd' => 'półtora dnia',
      'm' => 'półtora miesiąca',
      'y' => 'półtora roku')
);

Metodę getUnit() przytaczam w całości:

protected function getUnit($howMany, $unitSymbol, $half) {
 
   // kluczowa liczba, do ktorej wszystkie maja odmiane jak '5', potem tylko z jedynka na koncu
   if ($howMany > 21) {
 
      // badamy ostatnia cyfre 
      $howMany = substr($howMany, -1);
 
         // jesli to 1 to odmienia sie jak '5'
         if ($howMany <= 1) {
            $howMany = 5;
 
         // jesli nie to rekurencyjnie dla samej ostatniej cyfry
         } else {
            return $this->getUnit($howMany, $unitSymbol);
         }
   } elseif ($howMany >= 5) {
      $howMany = 5;
   } elseif ($howMany >= 2) {
      $howMany = 2;
 
   // jesli mamy '1 i pol' to odpytujemy specjalne jednostki
   } elseif ($howMany == 1 && $half == true) {
      return $this->_specialUnits['poltora'][$unitSymbol];
   }
   return $this->_units[$howMany][$unitSymbol];
}

Mamy już jednostki, teraz tylko skleić to w jeden ciąg znaków. Zajmuje się tym metoda getTimeSpan() z klasy AbstractTimeSpan:

public function getTimeSpan() {
   $interval = $this->getInterval();
   $timeUnit = $this->getUnit($interval['counter'], $interval['unit'], $interval['half']);
 
   // jesli gdziekolwiek dane byly szacowane to dorzucamy 'okolo'
   $prefix = ($interval['approx']) ? $this->getPrefix() . ' ' : '';
 
   // jesli mamy co najmniej 1 i pol
   $half = ($interval['half'] && $interval['counter'] > 0) ? $this->getHalf() . ' ' : '';
 
   // sprawdzamy czy chcemy 'temu'
   $suffix = ($this->_showSuffix) ? ' ' . $this->getSuffix() : '';
 
   // podajemy razem z liczba jednostkek
   if ($interval['counter'] > 1) {
      return $prefix . $interval['counter'] . ' ' . $half . $timeUnit . $suffix;
 
   // podajemy bez liczby jednostek
   } elseif ($interval['counter'] >= 0) {
      return $prefix . $timeUnit . ' ' . $half . $suffix;
 
   // zostala tylko mozliwosc, ze to 'przed chwila', czyli offset -1
   } else {
      return $timeUnit;
   }
}

Domyślne wartości to 10 sekund dla komunikatu przed chwilą, 15% tolerancji dla połowy jednostki (np. około 2 i pół godziny temu lub około pół godziny temu) i 15% tolerancji dla całości jednostki (np. około godzinę temu).

Myślę, że całość da się łatwo przenieść do innych systemów szablonów (od biedy w samym PHP też w końcu można). Póki co brakuje testów jednostkowych, I’m working on it :-D