[skrypt] "framework" OpenWikiBlog, Wolne oprogramowanie Opcje

[Babcia@Stefa]

Witam, ostatnio na własne potrzeby zacząłem pisać coś w czym będę się czuć swobodnie pisząc kolejne aplikacje internetowe, to tak zwany "szkielet".

Uwaga, uwaga, w celu rozwiania pewnych uwag i wątpliwości pojęcie framework zostało objęte cudzysłowiem ponieważ jest to framework po mojemu, jeżeli komuś się nie podoba to nie musi używać i nie, nie będę patrzeć na Zend Framework czy inne frameworki - ten jest inny!

Jednak jestem zwolennikiem Wolnego i Otwartego Oprogramowania dlatego postanowiłem, że podzielę się Swoją pracą z innymi ludźmi.

Hosting projektu zapewnia github.com, niestety muszę przyznać, że to mój pierwszy projekt hostowany na GIT i mam nadzieję, że nic nie zepsuje po drodzę ( jestem ostrożny ) (IMG:style_emoticons/default/smile.gif)

=== TU TNIJ ===

Przejdę do rzeczy, konkrety, konkrety!

No i oczywiście dodam link do repozytorium projektu:
http://github.com/webnull/OpenWikiBlog

Jądro

Całość jest zbudowana w oparciu o jądro, a reszta to tylko moduły.

Jądro może nie waży zbyt wiele, ale jest na prawdę funkcjonalne.

Cechy jądra:

• Budowa jądra zakłada maksymalnie łatwą dla dewelopera obsługę modułów
• Obsługa "domyślnych modułów" - muszą mieć zaimplementowany uniwersalny interfejs
• "Module On Demand" - Pierwsza cecha również tyczy się zależności, moduły ładowane są wtedy kiedy potrzeba ( same się załadują - to poprawia wydajność )
• Tak zwany skrypt startowy, są w nim moduły które startują razem z skryptem domyślnie
• "CallThroughtKernel" - pozwala w skryptach startowych zamiast modułu podać tylko jego wewnętrzną funkcję aby wywołać ją później
• "Kernel Module Triggers" - czyli odpowiednie reguły które jeżeli się zgadzają to moduł zostanie załadowany ( uproszczona budowa zapewnia szybkość wykonywania kodu )

"Module On Demand"

Wystarczy odwołać się do modułu który nie został załadowany aby został załadowany (IMG:style_emoticons/default/smile.gif)

Kod

$Kernel -> module -> moduleFunction ( Arguments );

Powyższy przykład w razie gdy moduł "module" nie istnieje załaduje moduł oraz odwoła się do jego funkcji o zwróci porządaną wartość.

Skrypty startowe

[PHP] pobierz, plaintext 
$MODS['admin'] = array ( 'k_TRIGGERS' => array (array(1=>$_GET['page'], 2=>9))); // jeżeli $_GET['page'] == 9 to moduł zostanie załadowany
$MODS['hooks'] = NuLL; // normalnie ładuje moduł
$MODS['smarty'] = array ( 'caching' => false, 
				'cache_lifetime' => 120, 
				'template_dir' => 'websites/cube/templates', 
				'compile_dir' => 'websites/cube/templates_c', 
				'config_dir' => 'websites/cube/core', 
				'cache_dir' => 'websites/cube/cache' ); // ładuje moduł smarty z odpowiednimi argumentami
$MODS['translator'] = array ( 'default_language' => 'english' ); // ładuje moduł translator z argumentami
$MODS['mypage'] = array ( 'index' => 1 );  // ładuje mypage ze wskazaniem która strona to strona główna
$MODS['menu'] = NuLL; // ładuje menu
$MODS[] = array ( 'mypage', 'display', ''); // odwołuje się do modułu mypage i wykonuje display() z argumentem '' -  inaczej CallThroughtKernel
[PHP] pobierz, plaintext 

Odnośnie skryptów startowych, na wiki jeszcze niema nic opisane ale obiecuję, że wkrótce opiszę każdy szczegół konfiguracji razem z "kolorowymi" przykładami ( gotowcami ) w miarę prosto i zwięźle.

Obsługa domyślnych modułów

Moduł może zdefiniować Siebie jako domyślny do wykonywania danej czynności, np. moduł MojErrorHandler może wywołać $Kernel->setAsDefault('MojErrorHandler', 'error_handler' );

Po zdefiniowaniu domyślnego modułu np. Error Handlera inne moduły będą go używać w taki sposób:

Kod

$Kernel->error_handler->log('asd');

"hooking" ( zaczep ) - czyli jak zmodyfikować prywatną zmienną wewnątrz funkcji innej klasy

Od niedawna ( dwa ostatnie commity ) dodałem moduł libhooks ( nazwa wywoławcza: hooks ).

Moduł pozwala zmodyfikować prywatną zmienną wewnątrz funkcji innego modułu jeżeli ten moduł na to pozwoli.

Jak to działa w praktyce?

Moduł który chce zmodyfikować dane innego modułu musi być załadowany najpierw.
Definiujemy zaczep o nazwie np. "moj_zaczep" podając dodatkowo nazwę klasy i funkcji która ma być wywołana do zmodyfikowania danych przekazanych z zaczepu.
Definicji dokonujemy w module który startuje najpierw.

Teraz startujemy moduł który posiada dane do zmodyfikowania przez inny moduł, wykonujemy zaczep wrzucając do niego dane które przejmie drugi moduł i zwróci "w poprawionej wersji".

Teraz prosty przykład:

[PHP] pobierz, plaintext 
modul_pierwszy {
            konstruktor_lub_dowolna_funkcja { // najlepiej konstruktor
                     definiuj_zaczep ( 'liczba', 'modul_pierwszy', 'edytor_zaczepu' );
            }
 
            edytor_zaczepu ( $dane ) {
                     return ($dane+1);
            }
}
[PHP] pobierz, plaintext 

[PHP] pobierz, plaintext 
modul_drugi {
            konstruktor_lub_dowolna_funkcja {
                     $moja_liczba = 500;
                     echo $moja_liczba; // pokaże 500
                     wykonaj_zaczep ( 'liczba', $moja_liczba );
                     echo $moja_liczba; // pokaże 501 ponieważ zaczep wykona funkcję modul_pierwszy->edytor_zaczepu($dane) i ustawi zwrócone dane funkcji w zmiennej $moja_liczba
            }
}
[PHP] pobierz, plaintext 

Jak powstają nowe funkcje oraz moduły Kernela?

Oczywiście buduję własne strony na tym frameworku i jeżeli coś stoi na drodze to poprawiam to lub dodaję nową funkcjonalność i publikuję na bieżąco na githubie.

Zawsze jednak jeżeli jesteś chętny/chętna do współpracy to na prawdę zapraszam, z chęcią przejrzę każdą poprawkę i dodam do projektu.

Niestety nie posiadam teraz żadnego zewnętrznego hostingu, dlatego strona testowa ( mój warsztat ) nie zawsze jest dostępny, ale wtedy kiedy będzie to zapraszam: http://194.29.181.186/tuxplace-cube/

To jedna ze stron która działa na frameworku.

Zapraszam do ocen, oraz do pomocy przy pisaniu kodu (wnoszeniu poprawek jak i funkcjonalności nowej) (IMG:style_emoticons/default/smile.gif)

PS. OpenWikiBlog dlatego, że projekt miał być małym mechanizmem podobnym do bloga - jedynie tworzenie i edytowanie podstron HTML razem z panelem administracyjnym ale się rozrosło (IMG:style_emoticons/default/smile.gif)

-- WebNuLL

Ten post edytował Babcia@Stefa 1.09.2010, 13:31:44

[Babcia@Stefa]

Huh, domniemam że u Ciebie coś w stylu modelu musi być w DB i np. zawartości katalogu nie możesz użyć wymiennie (tzn. wymieniasz adapter w modelu i nie trzeba nic grzebać)?

Ten fragment mam zamiar przepisać tak aby części bazy danych były wymienne a co do samego Kernela to projekt nie zakłada, że będzie wymienny.
Przepisanie tego fragmentu nie pochłonie wiele pracy, obecny kod służył do testów..

Co z mod_rewrite?

Całość jest i będzie przygotowywana pod mod_rewrite, niestety narazie nie stoi to wysoko bo całość testuję na lighttpd bez mod_rewrite.

.so.php - co znaczy SO, bo jakoś nie mogę tego z niczym skojarzyć prócz uniksowych odpowiedników .dll.

Nazywając "Jądro" Kernel, a pluginy modułami wprowadzam "styl nazw Uniksowych" do mojego projektu.

Musisz się każdorazowo łączyć z DB? A jak wykonuję stronę na plikach bądź cache'uje, to nawet jeśli wszystkie dane z cache odpowiadają zapotrzebowaniu, to i tak połączenie zostanie nawiązane? Fajnie, że zrobiłeś module on demand, ale zysk jest minimalny w porównaniu z tą samą techniką stosowaną przy łączeniu z DB.

Module on demand to po prostu prosta funkcja która pozwala na ominięcie zależności, jest to standard nazwany "po imieniu" w projekcie.

Co do bazy danych, to jak widzisz - łączę się z DB każdorazowo.
Myślę, że wprowadzenie jakiegoś cache nie będzie wcale problemem, jednak z tym jeszcze poczekam.

A tego kompletnie nie jarzę. (IMG:style_emoticons/default/biggrin.gif)

Proszę zatem przeczytać cały post, nie tylko fragmenty.
W dolnej częsci postu *w komentarzu konfiguracji* jest pokazany przykład zastosowania.
Nie jest to jakaś zaskakująca funkcja w PHP, jednak jest zaskakująca w tym "frameworku" ze względu na jego budowę.

Ale są pewne standardy, które - pomimo nieco większego nakładu pracy przy tworzeniu - umożliwiają późniejsze szybsze i bardziej eleganckie pisanie aplikacji, chociażby mod_rewrite, podział na (H)MVC/MVP (dopiero po napisaniu paru aplikacji na bazie własnego frameworka można dostrzec, czego brakuje), czy formularze.

Wybierając mój "framework" wybiera się coś innego niż reszta frameworków, lecz bardzo chętnie przyjrzę się konkretnym standardom i jeżeli są warte zaimplementowania to z pewnością zaimplementuję ale jednak chcę nadal aby projekt rozwijał się inną drogą.

-- WebNuLL

Ten post edytował Babcia@Stefa 1.09.2010, 17:50:47