arecki's site

Symfony, walidacja obrazków i PHP 5.3.2

Maliński Arkadiusz — Thu, 29 Jul 2010 09:29:12 +0000

Jak to zwykle bywa po aktualizacji oprogramowania (w tym przypadku PHP 5.3.2 poszło na warsztat) coś zaczyna źle działać. Ale do rzeczy.

Opis problemu:
Mam projekt klienta w którym jest panel administracyjny do dodawania i zarządzania zdjęciami do ofert, które klient sobie dodaje. No i dzisiaj jak gdyby nic dodaję nową ofertę. Przechodzę do dodawania zdjęć a tam komunikat: “Plik nie może być dodany. Akceptowalne formaty to PNG, JPG i GIF”. Hmmm… nic dziwnego. Sam narzuciłem taki wymóg. No ale wydaje mi się że mój własny system stara się zrobić ze mnie debila. Ale co tam. Sprawdziłem najpierw czy poprawnie zrobiłem obrazek. Sprawdziłem też jaki typ zwraca funkcja getimagesize(). No i zdębiałem. Typ poprawny “image/jpeg” a walidacja nie działa. Jako że do walidacji obrazka mam własny walidator, który dziedziczy po sfValidatorFile to po kolei sprawdzałem co może być problemem i oto…. voilla !!

Rozwiązanie !
Problem stwarza funkcja finfo_open dodana w PHP 5.3.0. Zwraca ona typ “image/jpeg; content=binary” no i dlatego nie działa. Na chwilę obecną rozwiązaniem jest nadpisanie opcji “mime_type_guessers” w walidatorze tak żeby nie używał opcji “guessFromFileinfo” i gra muzyka. Mam nadzieje że komuś się to przyda bo chwilę można spędzić nad problemem :)

Atomatyczne skalowanie i tworzenie miniatur obrazków przy uploadzie

Maliński Arkadiusz — Wed, 30 Jun 2010 19:04:31 +0000

Większość z nas, przy tworzeniu dynamicznych stron przy użyciu naszego najlepszego framework’a symfony :) spotkał się z problemem automatycznego skalowania dodawanych zdjęć, ponieważ klient, który ma zawsze rację, nie wie jak zmniejszać lub skalować poprawnie zdjęcia do wrzucenia na stronę. No i oczywiście ten problem zrzuca na barki programisty, który przez grzeczność nie może powiedzieć “Nie da się”. Oczywiście można zrobić walidator, który nie pozwoli na dodanie zdjęcia, które ma wymiary nie pasujące do designu strony ale trzeba prezentować postawę “frontem do klienta” i wspiąć się na wyżyny swoich umiejętności aby temat rozwiązać. Oczywiście na temat samego skalowania obrazków jest już napisanych wiele tutoriali więc pominę opisy jak to się robi. Jeżeli ktoś nie wie to najpierw proszę wyguglać sobie a później wrócić do tego artykułu.

Co do samego skalowania obrazków używam sfThumbnailPlugin (sposób instalacji i użycia pozostawiam jako zadanie domowe) .Pozostaje oczywiście kwestia jak rozwiązać to, żeby “samo się robiło”. Otóż można to rozwiązać w prosty sposób. Walidator sfValidatorFile domyślnie używa do zapisu pliku na dysku klasy sfValidatedFile. Nasze zadanie to nadpisać ową klasę własną, która w momencie wywołania funkcji save() stworzy do tego miniaturę i przeskaluje obraz, który jest zbyt duży do wyświetlenia na naszej stronie.

Najpierw jednak informacja o tym jak zmusić walidator do użycia naszej klasy (nazwa dla uproszczenia: sfValidatedFileThumbnails):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

class ZdjeciaForm extends sfForm
{
// ... definicje pól itp.
$this->setValidators(array(
'plik' => new sfValidatorFile(array(
'max_size' => 8192000,
'mime_types' => 'web_images',
'path' => sfConfig::get('sf_upload_dir').DIRECTORY_SEPARATOR.'photos',
'validated_file_class' => 'sfValidatedFileThumbnails',
), array(
'required' => 'Wybierz plik z dysku',
'max_size' => 'Wielkośc pliku nie może przekroczyś 8 MB',
'mime_types' => 'Akceptowalne pliki to GIF, JPG i PNG',
)),
));

// reszta definicji formularza
}
?>

Jak widać, dodaliśmy w opcjach walidatora informacje o tym, że używać będziemy naszej klasy do obsługi walidowanego pliku. Poniższa linijka o tym mówi:

1	'validated_file_class' => 'sfValidatedFileThumbnails',

Nie pozostaje nam nic innego jak w katalogu lib stworzyć plik sfValidatedFileThumbnails.class.php i umieścić w nim kod naszej klasy w którym zdefiniujemy ścieżki do katalogów z obrazkami i ich miniaturami (katalogi to: web/upload/photos/ oraz web/upload/thumbnails a nazwy miniatur są identyczne jak nazwy plików więc wyciągając z bazy jedną nazwę pliku mamy od razu nazwę obrazka i miniatury):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

class sfValidatedFileThumbnails extends sfValidatedFile
{

public function save($file = null, $fileMode = 0666, $create = true, $dirMode = 0777)
{
// wykonywanie funkcji save() z klasy nadrzędnej
$parentResults = parent::save($file, $fileMode, $create, $dirMode);

// ustawianie ścieżek dostepu do plików
$filename = sfConfig::get('sf_upload_dir').DIRECTORY_SEPARATOR.'photos'.DIRECTORY_SEPARATOR.$parentResults;
$thumbnailname = sfConfig::get('sf_upload_dir').DIRECTORY_SEPARATOR.'thumbnails'.DIRECTORY_SEPARATOR.$parentResults;

// pobranie wielkości uploadowanego zdjęcia
$imagesizes = getimagesize($filename);

// generowanie miniatury
$thumb = new sfThumbnail(sfConfig::get('app_max_thumb_width'), sfConfig::get('app_max_thumb_height'));
$thumb->loadFile($filename);
$thumb->save($thumbnailname, $imagesizes['mime']);

// sprawdzanie czy większa jest wysokość czy szerokość obrazka
if($imagesizes[0] >= $imagesizes[1])
{
// wymiarowanie wg. szerokości, jeżeli szerokość obrazka jest większa niż zadeklarowalismy w app.yml
if($imagesizes[0] > sfConfig::get('app_max_photo_width'))
{
$newWidth = intval(sfConfig::get('app_max_photo_width'));
$newHeight = round( ( $newWidth * intval($imagesizes[1]) ) / intval($imagesizes[0]) );
$resizeFile = new sfThumbnail($newWidth, $newHeight);
$resizeFile->loadFile($filename);
$resizeFile->save($filename, $imagesizes['mime']);
}
}
else
{
// wymiarowanie wg. wysokosci, jeżeli wysokość obrazka jest większa niż zadeklarowalismy w app.yml
if($imagesizes[1] > sfConfig::get('app_max_photo_height'))
{
$newHeight = intval(sfConfig::get('app_max_photo_height'));
$newWidth = round ( ( intval($imagesizes[0]) * $newHeight ) / intval($imagesizes[1]) );

$resizeFile = new sfThumbnail($newWidth, $newHeight);
$resizeFile->loadFile($filename);
$resizeFile->save($filename, $imagesizes['mime']);
}
}

return $parentResults;
}

}
?>

Myślę, że komentarze w klasie nie wymagają zbytniego objaśnienia. Sama zasada działania jest prosta:

wykonywana jest funkcja save() z klasy nadrzędnej
po jej wykonaniu pobierane są wymiary wrzuconego zdjęcia
generowana jest miniatura niezależnie od wielkości dodanego obrazka
sprawdzane jest która z wartości: wysokość, szerokość jest większa
w zależności od poprzedniej opcji, sprawdzane jest czy wybrany wymiar jest większy od tego co zdefiniowaliśmy w pliku konfiguracyjnym
jeżeli obrazek jest zbyt duży, jest tworzony nowy, z wymiarami nam odpowiadającymi i zapisywany w miejsce poprzednio wrzuconego

Dla pełnego obrazu sytuacji dodam że wielkości maksymalne dla obrazków i ich miniatur definiujemy w pliku app.yml i wygląda to mniej więcej tak (wartości w pixelach):

1
2
3
4
5

all:
max_photo_width: 900
max_photo_height: 700
max_thumb_width: 100
max_thumb_height: 100

I tyle, proste prawda ? Czekam na uwagi i komentarze.

Widget i parser do BBCode w symfony

Maliński Arkadiusz — Wed, 30 Jun 2010 18:06:36 +0000

Jako że kolejną rzeczą którą potrzebuje dla klienta jest mało zaawansowany technicznie edytor do wpisywania Bóg wie czego (Klient nasz Pan i wie lepiej !) to zachciało mi się parsera do BBCode ponieważ nie chciałem wytaczać armaty w postaci CKeditora bądź TinyMCE. Założyłem sobie od razu, że ma to być widget przygotowany do następnego użycia przy innych projektach. Jako że sam widget to nie wszystko, to do tego dopisana została klasa definiująca tagi BBCode a przy okazji parsująca to co zostało wpisane. (tak wiem o istnieniu sfBBCodeParserPlugin ale nie po to jest się programistą, żeby wykorzystywać półśrodki :)).

Tak powstała klasa sfBBCode która jest przygotowana do tego aby modyfikować występujące w niej przyciski oraz aby wykorzystać mechanizm translacji na inne języki wg. mechanizmu i18n jaki oferuje symfony. Klasa ma trzy metody:

parse(string $tekstDoFormatowania) – funkcja do zwracania sformatowanego na HTML tekstu
getDefinitions() – funkcja zwracająca definicje znaczników BBCode; każdy znacznik jest osobnym elementem tablicy i wygląda mniej więcej tak:

1
2
3
4
5
6
7
8

'paragraph' => array(
'label' => self::__('P'),
'tag' => '[p]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[p\](.*)\[\/p\]/Usi',
'replacement' => '

',
),

- kluczem tablicy jest napis, który pojawi się po najechaniu myszką na przycisk
- kolejne pola to:
  - label – etykieta przycisku
  - tag – znacznik BBCode przypisany do przycisku
  - with_param – określa czy znacznik ma mieć parametr np. [url="parametr"]link[/url]
  - with_param_prompt – tekst który wyświetla się na okienku z funkcji prompt (javascript) z informacją co ma być wpisane jako parametr
  - pattern – wyrażenie regularne do zamiany znacznika BBCode na znacznik HTML
  - replacement – tekst na który będzie zamieniony znacznik BBCode
__($tekst_do_tlumaczenia) – funkcja do translacji tekstu (oczywiście w momencie gdy i18n jest włączone)

Oto kod klasy:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

/**
* Klasa do obsługi BBcode stworzona do obsługi widgetu sfWidgetFormBBCodeTextarea
* do używania w symfony framework'u. Zamiera definicje tagów możliwych do użycia
* zgodnych z wymaganiami widget'u. Może być stosowana do parsowania innych stringów
* stworzonych bez użycia ww. widgetu. Przystosowana do translacji przez I18N.
*
* Obsługiwane znaczniki:
* [p], [strong], [i], [u], [quote], [code], [color], [image], [link], [email]
*
* @author Arkadiusz Malinski
* @version 0.1
*/
class sfBBCode
{

/**
* Funkcja zwracająca sparsowany string wg. definicji
*
* @param string $string Tekst BBcode do parsowania
* @return string Tekst HTML po parsowaniu
*/
public static function parse($string)
{
$match = $replace = array();

foreach(self::getDefinitions() as $code)
{
$match[] = $code['pattern'];
$replace[] = $code['replacement'];
}

return preg_replace($match, $replace, nl2br(htmlspecialchars($string)));
}

/**
* Funkcja zwracająca definicje znaczników jakie mogą być użyte.
* Przykładowa definicja znacznika:
*



     *      array('id_znacznika' => 

     *          array(

     *              'label'             =>  'tekst wyświetlany na buttonie',

     *              'tag'               =>  '[bbcode_znacznik]',

     *              'with_param'        =>  true, // true|false - określa czy znacznik ma mieć parametr 

     *              'with_param_prompt' =>  'tekst', // tekst do wyświetlenia do funkcji javascript - prompt() w momencie naciśnięcia przycisku

     *              'pattern'           =>  '/\[bbcode_znacznik\](.*)\[\/bbcode_znacznik\]/Usi', // wyrażenie regularne dla znacznika

     *              'replacement'       =>  '$1', // wyrażenie zastepujące poprzednią definicję przy parsowaniu

     *          )

     *      );

     *

*
* @return Array Tablica znaczników z wyrażeniami regularnymi do zastepowania
*/
public static function getDefinitions()
{
return array(
'paragraph' => array(
'label' => self::__('P'),
'tag' => '[p]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[p\](.*)\[\/p\]/Usi',
'replacement' => '

',
),
'bold' => array(
'label' => self::__('B'),
'tag' => '[b]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[b\](.*)\[\/b\]/Usi',
'replacement' => '$1',
),
'italic' => array(
'label' => self::__('I'),
'tag' => '[i]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[i\](.*)\[\/i\]/Usi',
'replacement' => '$1',
),
'underline' => array(
'label' => self::__('U'),
'tag' => '[u]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[u\](.*)\[\/u\]/Usi',
'replacement' => '$1',
),
'quote' => array(
'label' => self::__('QUOTE'),
'tag' => '[quote]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[quote\](.*)\[\/quote\]/Usi',
'replacement' => '$1',
),
'code' => array(
'label' => self::__('CODE'),
'tag' => '[code]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[code\](.*)\[\/code\]/Usi',
'replacement' => '$1',
),
'color' => array(
'label' => self::__('COLOR'),
'tag' => '[color]',
'with_param' => true,
'with_param_prompt' => self::__('Podaj kolor (CSS)'),
'pattern' => '/\[color=("|")(.*)("|")\](.*)\[\/color\]/Usi',
'replacement' => '$4',
),
'image' => array(
'label' => self::__('IMG'),
'tag' => '[img]',
'with_param' => false,
'with_param_prompt' => self::__(''),
'pattern' => '/\[img\](.*)\[\/img\]/Usi',
'replacement' => '',
),
'link' => array(
'label' => self::__('URL'),
'tag' => '[url]',
'with_param' => true,
'with_param_prompt' => self::__('Podaj adres strony'),
'pattern' => '/\[url=("|")(.*)("|")\](.*)\[\/url\]/Usi',
'replacement' => '$4',
),
'email' => array(
'label' => self::__('MAIL'),
'tag' => '[email]',
'with_param' => true,
'with_param_prompt' => self::__('Podaj adres e-mail'),
'pattern' => '/\[email=("|")(.*)("|")\](.*)\[\/email\]/Usi',
'replacement' => '$4',
),
);
}

/**
* funkcja zwracająca (nie)tłumaczony tekst w zależności od konfiguracji symfony
*
* @param String $string Tekst do tłumaczenia
* @return String
*/
protected static function __($string)
{
if(sfConfig::get('sf_i18n'))
{
return sfContext::getInstance()->getI18N()->__($string);
}
else
{
return $string;
}
}

}
?>

Klasa ta, oprócz oczywistej oczywistości – parsowania znaczników, definiuje tagi BBCode w taki sposób, abym mógł je wykorzystać przy tworzeniu widgetu do formularza. Sam widget dodaje się do formularza w sposób standardowy jak to w symfony i wygląda to mniej więcej tak:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

class TestForm extends sfForm
{

public function setup()
{
$this->setWidgets(array(
'bbcode' => new sfWidgetFormBBCodeTextarea(array(
'buttons' => sfBBCode::getDefinitions()
))
));

$this->getWidgetSchema()->setLabels(array(
'bbcode' => 'textarea z bbcode'
));

$this->setValidators(array(
'bbcode' => new sfValidatorString(),
));

$this->widgetSchema->setNameFormat(__CLASS__.'[%s]');
}
}
?>

Widget ma jedną wymaganą opcję – ‘buttons’ oraz dwie nie wymagane: ‘width’ i ‘height’ – określają wymiary tagu

zawierającego mój edytor. Przyciski, czyli opcja ‘buttons’, muszą być zdefiniowane w sposób jaki już opisałem powyżej (wymagane elementy to ‘label’, ‘tag’, ‘with_param’ oraz ‘with_param_prompt’). Jeżeli definicja będzie niepoprawna, widget wyrzuci wyjątek i trzeba będzie poprawić. Oczywiście nie trzeba korzystać z mojej klasy do dodania przycisków ale jest to jakieś ułatwienie, przynajmniej na start. Widget ma też metodę która dołącza bibliotekę JQuery za pomocą funkcji include_javascripts_for_form() więc nie musimy się martwić że jej zabraknie.

Kod klasy widgetu:

/**
* sfWidgetFormBBCodeTextarea - Pole

z przyciskami BBcode. 
 * 
 * Wymagana opcja 'buttons' to tablica zgodna z poniższym przykładem: 
 * (klasa sfBBCode zawiera funkcję getDefinitions() zawierającą domyślny 
 * zestaw buttonów dla tego widgetu) 
 * 
 * Pola wymagane do definicji to: 
 *  - label             - tekst wyświetlany na buttonie 
 *  - tag               - znacznik bbcode wstawiany do <textarea> 
 *  - with_param        - wartość true|false w zależności od tego czy znacznik ma atrybut 
 *                        (np. adres w znaczniku [url="adres"]link[/url] 
 *  - with_param_prompt - tekst wyświetlany w javascript'owej funkcji prompt() 
 *                        w okienku do wpisania wartości atrybutu 
 * 
 * <code> 
 *  class TestForm extends sfForm 
 *  { 
 *      public function setup() 
 *      { 
 *          $this->setWidgets(array( 
 *              'text'  =>  new sfWidgetFormBBCodeTextarea(array( 
 *                  'buttons'   =>  array( 
 *                      'paragraph' =>  array( 
 *                          'label'                 =>  self::__('P'), 
 *                          'tag'                   =>  '[p]', 
 *                          'with_param'            =>  false, 
 *                          'with_param_prompt'     =>  self::__(''), 
 *                      ), 
 *                      'bold'      =>  array( 
 *                          'label'                 =>  self::__('B'), 
 *                          'tag'                   =>  '[b]', 
 *                          'with_param'            =>  false, 
 *                          'with_param_prompt'     =>  self::__(''), 
 *                      ), 
 *                  ) 
 *              )) 
 *          )); 
 *      } 
 * } 
 * </code> 
 * 
 * @author      Arkadiusz Malinski <amalinski@gmail.com> 
 * @uses        JQuery - http://jquery.com 
 * @version     0.1 
 */ 
class sfWidgetFormBBCodeTextarea extends sfWidgetFormTextarea 
{ 
    
    /** 
     * Nazwa klasy CSS która zostaje dodana do tagu <textarea> 
     * @var String 
     */ 
    const CLASSNAME = 'bbcodeTextareaInsertion'; 
    
    /** 
     * Nazwa funkcji javascript do dodawania znaczników do tagu <textarea> 
     * @var String 
     */ 
    const FUNCTONNAME = 'bbcodeInsertionFunction'; 
    
    
    
    /** 
     * (non-PHPdoc) 
     * @see sf_symfony_lib_dir/lib/widget/sfWidgetFormTextarea#configure() 
     */ 
    protected function configure($options = array(), $attributes = array()) 
    { 
        parent::configure($options, $attributes); 
        
        $this->addRequiredOption('buttons'); 
        
        $this->addOption('width', '500'); 
        $this->addOption('height', '200'); 
    } 
    
    
    
    /** 
     * (non-PHPdoc) 
     * @see sf_symfony_lib_dir/lib/widget/sfWidgetFormTextarea#render() 
     */ 
    public function render($name, $value = null, $attributes = array(), $errors = array()) 
    {       
        // dodawanie atrybutów 
        $attributes['style'] = 'width:'.($this->getOption('width')-10).'px; height: '.($this->getOption('height')-30).'px'; 
        $attributes['class'] = key_exists('class', $attributes) ? $attributes['class'].' '.self::CLASSNAME : self::CLASSNAME; 
        
        // generowanie tagu <textarea> 
        $textarea = parent::render($name, $value, $attributes, $errors); 
        
        // tworzenie <div> z przyciskami 
        $panel = '<div style="white-space:pre;width:'.$this->getOption('width').'; height:20px;font-size:10px;">'.self::getButtons().'</div>'; 
        
        // zwracanie gotowego <div> z przyciskami i polem do wpisywania tekstu 
        return preg_replace( 
            array('/:panel/', '/:textarea/', '/:js/'), 
            array($panel, $textarea, self::getJS()), 
            '<div style="width:'.$this->getOption('width').'px; height: '.$this->getOption('height').'px;">:panel:textarea</div>:js' 
        ); 
    } 
 
    
    
    /** 
     * Funkcja zwracająca definicje funkcji javascript dodającą znaczniki bbcode 
     *   
     * @return String 
     */ 
    private function getJS() 
    { 
        return ' 
            <script type="text/javascript"> 
                function '.self::FUNCTONNAME.'(Tag, isParam, inputText) { 
                    var TA = $("textarea.'.self::CLASSNAME.'"); 
                    var TA_DOM = TA.get(0); 
                    var Content = TA.val(); 
                    
                    var EndTag = Tag.replace("[", "[/"); 
                    if(isParam) 
                    { 
                        var inputResponse = ""; 
                        if(inputText.length) 
                        { 
                            inputResponse = prompt(inputText, ""); 
                        } 
                        Tag = Tag.replace("]", "=\"" + inputResponse + "\"]"); 
                    } 
                    
                    var Insertion = { 
                        strStart:   Content.substr(0, TA_DOM.selectionStart), 
                        strReplace: Content.substr(TA_DOM.selectionStart, (TA_DOM.selectionEnd - TA_DOM.selectionStart)), 
                        strEnd:     Content.substr(TA_DOM.selectionEnd) 
                    }; 
                    
                    TA.val( Insertion.strStart + Tag + Insertion.strReplace + EndTag + Insertion.strEnd ); 
                    return false; 
                } 
            </script> 
        '; 
    } 
    
    
    
    /** 
     * Funkcja zwracająca listę przycisków wraz z obsługą klikania 
     * 
     * @return String 
     */ 
    private function getButtons()   
    { 
        $str = ''; 
        
        foreach ($this->getOption('buttons') as $buttonID => $button) 
        { 
            if(self::isValidButton($button)) 
            { 
                $str .= '<button title="'.$buttonID.'" onclick="return '.self::FUNCTONNAME.'('; 
                
                $str .= '\''.htmlspecialchars($button['tag']).'\', '; 
                $str .= intval($button['with_param']).', '; 
                $str .= '\''.htmlspecialchars($button['with_param_prompt']).'\''; 
                
                $str .= ' );" ';                
                $str .= ' style="font-size:10px;" id="bbcode'; 
                $str .= strtoupper($button['label']).'button">'; 
                $str .= $button['label'].'</button>'; 
            } 
            else 
            { 
                throw new sfException('Invalid button definition ('.__CLASS__.' => '.$buttonID.')'); 
            } 
        } 
        
        return $str; 
    } 
    
    
    
    /** 
     * Funkcja sprawdzająca poprawność definicji przycisków 
     * 
     * @param array $button Button do sprawdzenia 
     * @return boolean 
     */ 
    private function isValidButton($button) 
    { 
        return ( 
            array_key_exists('label', $button) 
            && 
            array_key_exists('tag', $button) 
            && 
            array_key_exists('with_param', $button) 
            && 
            array_key_exists('with_param_prompt', $button) 
        ); 
    } 
    
    
    
    /** 
     * (non-PHPdoc) 
     * @see sf_symfony_lib_dir/lib/widget/sfWidget#getJavaScripts() 
     */ 
    public function getJavaScripts() 
    { 
        return array('http://code.jquery.com/jquery-1.4.2.min.js'); 
    } 
    
} 
?></div></td></tr></tbody></table></div>
A jak zainstalować ? Oczywiście wrzucić do katalogu lib w projekcie czy aplikacji pliki sfBBCode.class.php oraz sfWidgetFormBBCodeTextarea.class.php i oczyścić cache i powinno być już wszystko dostępne do użycia. 
A samo wyświetlanie ? Proszę:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap"><?php 
echo sfBBCode::parse(html_entity_decode($record->getText())); 
?></div></td></tr></tbody></table></div>
Mam nadzieję że komuś się przyda. A jakby były jakieś pytania bądź propozycje co do zmiany/rozwoju klas to jestem otwarty na wszystkie propozycje.

</article>
<article>
<h1>Modyfikacja filtrów w symfony</h1>
Maliński Arkadiusz — Wed, 16 Jun 2010 17:00:18 +0000
Jako że ostatnio na <a href="http://forum.php.pl/index.php?showtopic=152278&st=0&p=756342">forum</a> pojawił się problem z którym też miałem okazję się spotkać to napisze również tutaj informację dla potomnych. Chodziło mianowicie o zmianę typu pola w filtrze z input (domyślnie) na np. select a właściwie o to że po tej zmianie, pole do filtru się pokazywało poprawnie ale wyniki nie były filtrowane. Problem na moje oko jest w tym, że symfony nie może sobie odczytać wartości, którą podajemy w innym polu niż pole input. Aby mogło to poprawnie działać należy w klasie filtru dodać funkcje dla naszego konkretnego pola, która przypisze do obiekty Query (Doctrine) bądź Criteria (Propel) prawidłową wartość. 
 
Załóżmy, że nasze pole nazywa się ‘typ_platnosci’ i należy do klasy Zamowienie. Definiujemy filtr następująco:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">class ZamowienieFormFilter extends BaseZamowienieFormFilter 
{ 
 
    private function getTypyPlatnosci() 
    { 
        return array('1' => 'Karta kredytowa', '2' => 'Gotówka'); 
    } 
 
    public function configure() 
    { 
        $this->widgetSchema['typ_platnosci'] = new sfWidgetFormChoice(array('choices' => $this->getTypyPlatnosci())); 
        // validator do ustawienia jako zadanie domowe :) 
        $this->validatorSchema['typ_platnosci']=new sfValidatorPass(); 
    } 
 
}</div></td></tr></tbody></table></div>
Niestety filtrowanie w tym momencie nie działa. Co zrobić żeby działało ? Dodać funkcję do klasy filtra, która wymusi filtrowanie wg. naszych zasad.
Rozwiązanie dla Propela:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">protected function addTypPlatnosciColumnCriteria(Criteria $criteria, $field, $values) 
{ 
    if ($q = $values['text']) 
    { 
        $criteria->add ('typ_platnosci', $q); 
    } 
}</div></td></tr></tbody></table></div>
Rozwiązanie dla Doctrine:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">protected function addTypPlatnosciColumnQuery(Doctrine_Query $query, $field, $values) 
{ 
    if ($q = $values['text']) 
    { 
        $query->addWhere($this->getRootAlias().'.typ_platnosci = \''.$q.'\''); 
    } 
}</div></td></tr></tbody></table></div>
Pamiętać należy o tym że nazwy funkcji muszą się nazywać addNazwaPoleColumnQuery lub addNazwaPoleColumnCriteria bo inaczej nie zadziała no i oczywiście nic nie stoi na przeszkodzie żeby zamiast where użyć like lub coś bardziej wysublimowanego.

</article>
<article>
<h1>Generowanie Google Sitemap</h1>
Maliński Arkadiusz — Wed, 16 Jun 2010 16:25:31 +0000
Aby ułatwić sobie generowanie linków w swojej aplikacji w symfony dokonałem wiekopomnego dzieła i stworzyłem sobie prostą klasę do automatycznego generowania pliku sitemap dla Google’a. Przykład użycia:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">class sitemapActions extends sfActions 
{ 
 
    public function executeIndex(sfWebRequest $request) 
    { 
        sfLoader::loadHelpers(array('Url')); 
        
        $gs = new GoogleSitemap(); 
        $gs->addUrl(url_for('@szczegolyOferty?culture=pl&oferta=123'), GoogleSitemap::GOOGLE_SITEMAP_DAILY, date('c', mktime(1, 0, 0, date('m'), date('d'), date('Y'))), '0.8'); 
        $gs->addUrl(url_for('article/get?culture=pl&id=123'), GoogleSitemap::GOOGLE_SITEMAP_WEEKLY, date('c', strtotime("last Sunday")), '0.6'); 
        $gs->addUrl(url_for('info/show?culture=pl&token=o-firmie'), GoogleSitemap::GOOGLE_SITEMAP_MONTHLY, date('c', mktime(1, 0, 0, date('m'), 1, date('Y'))), '0.5'); 
 
        // flush content to browser 
        $gs->output(); 
    } 
}</div></td></tr></tbody></table></div>
 
A oto kod klasy. Mam nadzieje że komuś się przyda.
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;height:700px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">/** 
 * Generating Google Sitemap XML file 
 * @author Arkadiusz Malinski <amalinski@fornet.com.pl> 
 */ 
class GoogleSitemap 
{ 
 
    const GOOGLE_SITEMAP_DAILY = 'daily'; 
    const GOOGLE_SITEMAP_WEEKLY = 'weekly'; 
    const GOOGLE_SITEMAP_MONTHLY = 'monthly'; 
    
    private $_host = false; 
    private $_urls = array(); 
    private $_content = '<?xml version="1.0" encoding="utf-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'; 
    
    
    /** 
     * class constructor 
     * @param string $_host Host address 
     * @param date $_lastmod Last modification date 
     */ 
    public function __construct($_host = false, $_lastmod = false) 
    { 
        $this->_host    =   $_host === false ? $_SERVER['HTTP_HOST'] : $_host; 
        $this->_content .=  '<url>'. 
                            '<loc>http://'.($this->_host).'</loc>'. 
                            '<lastmod>'.($_lastmod === false ? date('c') : $_lastmod).'</lastmod>'. 
                            '<changefreq>daily</changefreq>'. 
                            '<priority>0.9</priority>'. 
                            '</url>'; 
    } 
    
    
    /** 
     * Adding url to sitemap 
     * @param string $url Address to add 
     * @param string $freq Site's change frequency 
     * @param date $lastmod Last modification date 
     * @param string $priority Site's priority (0.0 - 1.0) 
     */ 
    public function addUrl($url, $freq = self::GOOGLE_SITEMAP_WEEKLY, $lastmod = false, $priority = '0.5') 
    { 
        $record = array( 
            'url'       =>  $url, 
            'freq'      =>  $freq, 
            'lastmod'   =>  ($lastmod === false ? date('c') : $lastmod), 
            'priority'  =>  $priority, 
        ); 
        $this->_urls[] = $record; 
    } 
    
    
    /** 
     * Echoes XML file to browser and ending script 
     */ 
    public function output() 
    { 
        header('Content-type:text/xml'); 
        echo $this->_content; 
        
        foreach($this->_urls as $record) 
        { 
            echo '<url>'; 
                echo '<loc>'.(preg_match('/http(s)?:\/\//', $record['url']) ? $record['url'] : 'http://'.$this->_host.$record['url']).'</loc>'; 
                echo '<lastmod>'.date('c', strtotime($record['lastmod'])).'</lastmod>'; 
                echo '<changefreq>'.$record['freq'].'</changefreq>'; 
                echo '<priority>'.$record['priority'].'</priority>'; 
            echo '</url>'; 
        } 
        
        echo '</urlset>'; 
        exit(); 
    } 
 
}</div></td></tr></tbody></table></div>

</article>
<article>
<h1>Walidator dla wymiarów obrazków</h1>
Maliński Arkadiusz — Wed, 16 Jun 2010 16:05:20 +0000
Każdy z nas czasami potrzebuje żeby użytkownik dodający zdjęcie w naszym formularzu nie miał możliwości dodania zdjęcia mniejszego, większego bądź innego niż sami założyliśmy obrazka. Stąd pomysł na walidator określający wymiary dodawanego obrazka. Oto kod:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;height:700px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">class sfValidatorFileWithSize extends sfValidatorFile { 
    
    protected function configure($options = array(), $messages = array()) { 
        
        parent::configure($options, $messages); 
        
        $this->addOption('max_width'); 
        $this->addOption('max_height'); 
        
        $this->addOption('min_width'); 
        $this->addOption('min_height'); 
 
        $this->addOption('exact_width'); 
        $this->addOption('exact_height'); 
        
        $this->addOption('mime_categories', array( 
            'web_images' => array('image/jpeg','image/pjpeg','image/png','image/x-png','image/gif','application/x-shockwave-flash') 
        ));     
        
        $this->addMessage('max_width', 'File width is too large (maximum width is %max_width% px).'); 
        $this->addMessage('max_height', 'File height is too large (maximum height is %max_height% px).'); 
        
        $this->addMessage('min_width', 'File width is too small (minimum width is %min_width% px).'); 
        $this->addMessage('min_height', 'File height is too small (minimum height is %min_height% px).'); 
        
        $this->addMessage('exact_width', 'File width has not exact width (exact width is %exact_width% px).'); 
        $this->addMessage('exact_height', 'File height has not exact height (exact height is %exact_height% px).'); 
 
    } 
    
    
    protected function doClean($value) { 
        
        // get file sizes 
        list($width, $height, $type, $attr) = getimagesize((string) $value['tmp_name']); 
        
        // check max_width 
        if ($this->hasOption('max_width') && $this->getOption('max_width') < (int) $width) { 
            throw new sfValidatorError($this, 'max_width', array('max_width' => $this->getOption('max_width'), 'width' => (int) $width)); 
        } 
        
        // check max_height 
        if ($this->hasOption('max_height') && $this->getOption('max_height') < (int) $height) { 
            throw new sfValidatorError($this, 'max_height', array('max_height' => $this->getOption('max_height'), 'height' => (int) $height)); 
        } 
        
        // check min_width 
        if ($this->hasOption('min_width') && $this->getOption('min_width') > (int) $width) { 
            throw new sfValidatorError($this, 'min_width', array('min_width' => $this->getOption('min_width'), 'width' => (int) $width)); 
        } 
        
        // check min_height 
        if ($this->hasOption('min_height') && $this->getOption('min_height') > (int) $height) { 
            throw new sfValidatorError($this, 'min_height', array('min_height' => $this->getOption('min_height'), 'height' => (int) $height)); 
        } 
        
        // check exact_width 
        if ($this->hasOption('exact_width') && $this->getOption('exact_width') != (int) $width) { 
            throw new sfValidatorError($this, 'exact_width', array('exact_width' => $this->getOption('exact_width'), 'width' => (int) $width)); 
        } 
        
        // check exact_height 
        if ($this->hasOption('exact_height') && $this->getOption('exact_height') != (int) $height) { 
            throw new sfValidatorError($this, 'exact_height', array('exact_height' => $this->getOption('exact_height'), 'height' => (int) $height)); 
        } 
        
        
        return parent::doClean($value); 
    } 
    
}</div></td></tr></tbody></table></div>

</article>
<article>
<h1>Wspólny routing dla aplikacji w symfony 1.2</h1>
Maliński Arkadiusz — Wed, 16 Jun 2010 15:32:35 +0000
Jako że nie mam ostatnio czasu na pisanie rozwlekłych esejów związanych z programowaniem, więc pomyślałem sobie że mając chwilki pomiędzy domem a pracą postaram się wkleić co bardziej potrzebny kod, dzięki któremu zrealizowałem swoje problemy. A i przy okazji może komuś się to przyda :) Tak więc zaczynamy. 
 
Ostatnio się spotkałem z potrzebą dodania dodatkowego pliku z routingiem dla kilku aplikacji w <a href="http://www.symfony-project.org/">symfony</a> tak aby był on dla wybranych plikacji wspólny. Problem rozwiązałem poprzez:
Pierwsze primo – tworzymy w katalogu /projekt/config/ plik (myRouting.yml) z wpisami dotyczącymi wspólnego routingu :
<div class="codecolorer-container text default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 </div></td><td><div class="text codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">offersDetails: 
  url:    /:culture/details/:offer/:date_from/:date_to 
  param:  { module: show, action: offerDetails, culture: "pl" }</div></td></tr></tbody></table></div>
Drugie primo – W katalogu /projekt/lib/ tworzymy sobie klasę, dzięki której będziemy mogli ładować plik z routingiem:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">class Tools 
{ 
 
    /** 
     * ladowanie wspolnego routingu 
     * @param sfEvent $event 
     */ 
    public static function loadRouting(sfEvent $event) 
    { 
        $r = $event->getSubject(); 
        $route = sfYaml::load(sfConfig::get('sf_config_dir').DIRECTORY_SEPARATOR.'myRouting.yml'); 
 
        if($route) 
        { 
            foreach ($route as $routeName=>$params) 
            { 
                $r->prependRoute($routeName, new sfRoute($params['url'], $params['param'])); 
            } 
        } 
    } 
 
}</div></td></tr></tbody></table></div>
No i mamy zrobione. Teraz w każdej aplikacji do której chcemy dołączyć ten plik edytujemy plik aplikacjaConfiguration.class.php znajdujący się w katalogu /projekt/apps/aplikacja/config/ i dołączamy poniższy kod, tak aby w funkcji configure() znalazła się poniższa linijka:
<div class="codecolorer-container php default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 2 3 4 5 6 7 </div></td><td><div class="php codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">class aplikacjaConfiguration extends sfApplicationConfiguration 
{ 
    public function configure() 
    { 
        $this->dispatcher->connect('routing.load_configuration', array('Tools', 'loadRouting')); 
    } 
}</div></td></tr></tbody></table></div>
A na koniec ? Oczywiście:
<div class="codecolorer-container text default" style="overflow:auto;white-space:nowrap;border:1px solid #9F9F9F;width:500px;"><table cellspacing="0" cellpadding="0"><tbody><tr><td style="padding:5px;text-align:center;color:#888888;background-color:#EEEEEE;border-right: 1px solid #9F9F9F;font: normal 12px/1.4em Monaco, Lucida Console, monospace;"><div>1 </div></td><td><div class="text codecolorer" style="padding:5px;font:normal 12px/1.4em Monaco, Lucida Console, monospace;white-space:nowrap">./symfony cache:clear</div></td></tr></tbody></table></div>

</article>
<article>
<h1>i’m back czyli jestem z powrotem…</h1>
Maliński Arkadiusz — Thu, 26 Nov 2009 16:17:20 +0000
No i stało się. W końcu znalazłem swoje 5 minut i uruchomiłem bloga z powrotem. Mam nadzieje w ciągu kilku dni przywrócić wpisy poprzednie więc historia zostanie. Nowe wpisy też się pojawią. W końcu po to zrobiłem bloga prawda? Pozdrawiam zainteresowanych i do przeczytania.

</article>
</main></body></html>