Laděnka, jak se vám líbí?

Laděnka je užitečnou každodenní pomocnicí PHP programátora. Její oficiální jméno zní Nette\Debug.

Aktuální informace najdete na webu Nette Framework.

Každý ladič je dobrým kamarádem s funkcí var_dump, která podrobně vypíše obsah proměnné. Bohužel v prostředí HTML výpis pozbude formátování a slije se do jednoho řádku, o sanitizaci HTML kódu ani nemluvě. V praxi je nezbytné var_dump nahradit šikovnější funkcí. Tou je právě Debug::dump()

$arr = array(10, 20.2, TRUE, NULL, 'hello');

Debug::dump($arr);
// včetně jmenného prostoru Nette\Debug::dump($arr);

vygeneruje výstup:

array(5) {
  [0] => int(10)
  [1] => float(20.2)
  [2] => bool(true)
  [3] => NULL
  [4] => string(5) "hello"
}

Dalším užitečným nástrojem ladiče jsou stopky s přesností na mikrosekundy:

Debug::timer();

// princi můj malinký spi, ptáčkové sladce již sní...
sleep(2);

$elapsed = Debug::timer();
// $elapsed ≈ 2

Tohle všechno jsou sice užitečné drobnosti, skutečným killerem je však jiná Laděnčina vlastnost. Zpráva o nezachycené výjimce nebo chybě poskytuje vývojáři důležité informace o tom, kde a proč k ní došlo. Standardní výstup v PHP vypadá asi takto:

Standardní podoba nezachycené výjimky

Pusťme však ke slovu Laděnku. Po aktivaci příkazem Debug::enable() nám předvede svou nejvíce sexy polohu:

Nezachycená výjimka v provedení NDebug

Takto vypadá výjimka, takto vypadá vygenerovaná chyba. To je pak jiné ladění, co?

Snad nemusím dodávat, že vypisování chyb se nesmí nikdy dostat na produkční server. Je to výborná společnice na pracovišti, ale nikdy ji nesmíme brát sebou ven. Je totiž děsně ukecaná a vyzradí na vás úplně všechno (nicméně kdyby k tomu náhodou došlo, má integrovaný systém pro skrytí citlivých políček, např. hesel). Na produkčním serveru je však možné nechat výpisy ukládat do adresáře nebo odesílat administrátorovi emailem.

→ Download: Nette\Debug.zip, licence, překlad

(doplněno: mám na vás prosbu…)

karma 13. líbil se vám článek?
30. 1. 2008 | Nette | shlédnuto 5873x
vytisknout | odeslat emailem
nahoru

Komentáře » přidat

#1 Hrach http://hrach.netuje.cz nový

Miluju laděnku :-* Ty krásné tvary, vnady, ta barva očí, rozevíratelné oblasti, jej, až sem se ztoho celý okouzlil.

Posláno 30. 1. 2008 v 15.43 | Odpovědět

Na komentář reagoval [12] Ondra [15] bratr ekim

#2 enoice http://enoice.fialove.eu nový

Tak to je bomba, Dave! Dokonalost

Posláno 30. 1. 2008 v 15.46 | Odpovědět

#3 papi http://ctenari.cz nový

Vypadá to velmi, velmi dobře. Jak dlouho si s ní už užíváš?

Posláno 30. 1. 2008 v 16.28 | Odpovědět

#4 Tom nový

Vypadá dobře, pro potření prvně zmi=novaných problémů používám xdebug, neškodí si navzájem?

Posláno 30. 1. 2008 v 16.29 | Odpovědět

#5 Pixy pixy@pixy.cz nový

Gratuluji ke krásné holčičce. Laděnka vypadá moc mile a chytře. Radost.

Posláno 30. 1. 2008 v 16.36 | Odpovědět

#6 Littlemaple http://blog.javorek.net nový

Opravdu sexy! :)

Posláno 30. 1. 2008 v 17.02 | Odpovědět

#7 v6ak http://v6ak.profitux.cz/ nový

Dobrý. ukecaností mi to připomíná ASP.NET. Taky jsem narazil na server se zapnutým debugem…
Já mám vlastní debug nástroj, ale laděnka je patrně lepší. Ale:

může mít laděnka více výstupů (HTML, text, …)?
Je možné nastavit zapnuto/vypnuto?

Posláno 30. 1. 2008 v 17.06 | Odpovědět

Na komentář reagoval [10] David Grudl

#8 tark miroslav.navratil@gmail.com nový

Mě by se spíš líbilo něco jiného. Přesměrovat výstup laděnky (tedy NDebug.template) do souboru a navázat na NDebug vlastní nástroj pro zachytávání výjimek. Šlo by to? :)

Posláno 30. 1. 2008 v 17.08 | Odpovědět

Na komentář reagoval [10] David Grudl

#9 džidžir nový

Moc pěkné. Umí to rozumně odchytnout i Fatal Errory?

Posláno 30. 1. 2008 v 17.11 | Odpovědět

Na komentář reagoval [10] David Grudl

#10 David Grudl http://davidgrudl.com nový

#7 v6ak: zapíná se přes NDebug::enable(), vypíná přes NDebug::disable(). Je možné zapnout i textový výstup NDebug::$html = TRUE, respektive v CLI režimu se zapne automaticky. Ale ten není zdaleka tak ukecený, spíš odpovídá standardnímu PHP výstupu.

Textový režim existuje hlavně hlavně kvůli tomu, že změní chování NDebug::dump(). Hodí se mi to k testování kódu – z příkazové řádky spouštím sadu malých testovacích příkladů, zachytávám výstup a porovnávám s referenčním.

#8 tark: zachytávát můžeš i vlastním nástrojem a k vykreslení použít NDebug::exceptionHandler(). I když asi by to vyžadovalo drobnou úpravu kódu.

#9 džidžir: systémové fatal errory v PHP bohužel nijak odchytit nelze, na to už jsem si stěžoval dříve. Jen
E_USER_ERROR a E_RECOVERABLE_ERROR.

Posláno 30. 1. 2008 v 17.39 | Odpovědět

Na komentář reagoval [11] džidžir [13] v6ak [19] veena

#11 džidžir nový

#10 David Grudl:

systémové fatal errory v PHP bohužel nijak odchytit nelze, na to už jsem si stěžoval dříve.

Jo, už jsem na to taky došel. Velký problém, pokud ladím na serveru a server má vypnuté v konfigu z pochopitelných důvodů vypisování chyb. Zend sliboval před časem odchytávatelnost některých FE, myslím že těch, při kterých zůstane stabilní jádro.

V Perlu jde třeba zachytit a zpracovat jakákoli chyba, dokonce i chyby při parsování skriptu. Ale Perl koneckonců také není určen pro psaní skriptů pro web.

Posláno 30. 1. 2008 v 18.49 | Odpovědět

#12 Ondra nový

#1 Hrach: Řekl bych, že by si spíš potřeboval na chvíli vyměnit klávesnici a myš za pořádnou ženskou :)

Jinak NDebug je super ;)

Posláno 30. 1. 2008 v 19.12 | Odpovědět

Na komentář reagoval [15] bratr ekim

#13 v6ak http://v6ak.profitux.cz/ nový

#10 David Grudl: Já jsem dělal přímo možnost použití šablon, ale v praxi to stačí. Automatické zapínání textového režimu nemám. Jde mi taky pochopitelně hlavně o komandlajnu.
K vypínání: Jo, to jsem si přečet, ale jde mi hlavně o debugování.
[0] Ještě jeden návrh převzatý z mé víceméně staré primitivní debugovací knihovničky: Velké plus (oproti var_dump a print_r) je v tom, že umožňuje výpis části výrazu:

if( v6_deb(výraz 1) == v6_deb(výraz 2) ){
...

Případně lze dodat komentář:

if( v6_deb(výraz 1, 'komentář 1') == v6_deb(výraz 2, 'komentář 2') ){
...

Vtip je pochopitelně v tom, že zadaný parametr 1 je zároveň návratovou hodnotou.

Posláno 30. 1. 2008 ve 20.10 | Odpovědět

#14 paranoiq paranoiq@centrum.cz nový

davide, gratuluji. udělal jsi nádherné udělátko :)

sám používám něco podobného jako NDebug::dump() ve formě jedinné funkce dump(). výstup je trochu méně ukecaný, zato ale hraje všemi barvami :), umí vypsat pole a objekty povolných tříd† rekurzivně do zvolené hloubky, přičemž defaultně censoruje hodnoty jistých názvů (kdybych ji přeci jen někde zapoměl)

† povolná třída obsahuje:
public function _dump() {
return (array)$this;
}

Posláno 30. 1. 2008 ve 20.18 | Odpovědět

#15 bratr ekim http://bratrekim.unas.cz nový

#12 Ondra: asi tak no
#1 Hrach: jo něco takového sem potřeboval už dlouho :D

Posláno 30. 1. 2008 ve 21.05 | Odpovědět

#16 Littlemaple http://blog.javorek.net nový

Mno, tak první dojmy: Nemohla by mít Laděnka cestu k oné úžasné šabloně modifikovatelnou? Rád bych si ji dal jinam než do stejného adresáře jako třídu.

Jistě, stačí si to tam přepsat nebo ručně přidat jednu public vlastnost, ale tím se připravuji o dopřednou kompatibilitu s možnými dalšími verzemi Laděnky :) .

Posláno 30. 1. 2008 ve 22.12 | Odpovědět

#17 Věroš http://www.cestovatel.cz/ nový

Jo, tohle mi v PHP chybělo.

<hr />

Nechca být za rejpala, ale podobný nástroj máme v Pythonu už pár let ve vlajkové knihovně .

Když jsem na cgitb poprvé narazil, tak jsem myslel, že nemůže být nic lepšího.

Rychle jsem ale zjistil, že může – jen jsem tomu nekrofilnímu vrtání se v zemřelém kódu ještě nepřišel na chuť. Ano, post-mortem inspector v okně prohlížeče v Pylons mne opravdu překvapil.

PS: Jo a to že tracebacky mohou správcům chodit e-mailem včetně session, parametrů dotazu, cookies, hlaviček, identifikace prohlížeče a čísla bot uživatele, to jsem už říkal?

Posláno 30. 1. 2008 ve 23.26 | Odpovědět

Na komentář reagoval [21] David Grudl

#18 Oswald http://www.webkitchen.cz/ nový

Něco podobného je v symfony frameworku, jenom to není tak přehledné a navíc tam jsou vypsány i globální proměnné, což je také užitečné.

Posláno 30. 1. 2008 ve 23.43 | Odpovědět

Na komentář reagoval [20] golf [21] David Grudl

#19 veena nový

#10 David Grudl: Nelze ten fatal error odchytnout pomocí output_bufferingu?
http://cz2.php.net/…rror_handler#…

Laděnka pěkná!

Posláno 31. 1. 2008 v 8.09 | Odpovědět

Na komentář reagoval [22] David Grudl

#20 golf nový

#18 Oswald: Symfony je tak dokonale, az je problem tu dokonalost pochopit A ja z toho mam jen schizofrenii, pouzivat dokonale Symfony, nebo pouzivat skvele Nette. A dokonce se zda, ze i Zend ve verzi 1.5 zacina byt pouzitelny. No co vcil???????

Posláno 31. 1. 2008 v 8.21 | Odpovědět

#21 David Grudl http://davidgrudl.com nový

#17 Věroš: #18 Oswald: narovinu, chtěl jsem vidět, jak vypadá taková obrazovka v jiných systémech, ale pokud si jej nestáhneš, nenainstaluješ, nepochopíš, nerozchodíš a nevyhodíš výjimku, tak to nemáš šanci zjistit. Ani tvůj odkaz mi v tom nepomohl.

Takže mám prosbu pro všechny uživatele různých frameworků: hoďte sem odkaz na „blue screen“, pokud je něčím zajímavý, Nemusí být „živý“, stačí htmlshot.

ad odesílání emailem: odesílání nebo ukládání do adresáře řeším přes jinou třídu, k tomu se dostaneme.

Posláno 31. 1. 2008 v 11.14 | Odpovědět

Na komentář reagoval [23] Oswald [24] v6ak [25] Věroš

#22 David Grudl http://davidgrudl.com nový

#19 veena: obecně není problém

jak vykonat kód po vzniku chyby, ale
jak chybu detekovat

ad a) při normálním ukončení skriptu se ještě zavolají handlery pro

destruktory objektů
output buffering (ob_start)
session handler (session_set_save_handler)
stream wrapper (stream_wrapper_register)

PHP garantuje (od verze 5.0.5), že session se uzavře až po zavolání všech destruktorů, jinak pořadí ovlivňuje garbage collector.

Při vzniku fatální chyby se destruktory zřejmě vynechají. Stále tu však máme tři momenty, kde na ni můžeme reagovat. Klíčová je tedy otázka b), jak chybu od korektního ukončení detekovat?

To netuším. Bohužel ani novinka error_get_last nepomůže. Ovšem skenování output bufferu na řetězec <b>... error</b> k rozumným obecně použitelným řešením podle mého nepatří ;)

Posláno 31. 1. 2008 v 11.49 | Odpovědět

#23 Oswald http://www.webkitchen.cz/ nový

#21 David Grudl: tady je htmlshot ze symfony

Symfony kromě toho v debug módu zobrazuje nad stránkou toolbar, kde jsou informace o prováděných SQL dotazech, konfiguraci, délce trvání jednotlivých úkonů apod., považuji to za velmi užitečné a myslím, že by to mohlo být celkem inspirativní:

http://www.symfony-project.org/…gement-Tools#…

Posláno 31. 1. 2008 v 11.59 | Odpovědět

#24 v6ak http://v6ak.profitux.cz/ nový

#21 David Grudl: To se asi mě netýká, že?

Posláno 31. 1. 2008 ve 13.24 | Odpovědět

#25 Věroš http://www.cestovatel.cz/ nový

#21 David Grudl: Odpovídám soukromě.

Posláno 31. 1. 2008 ve 13.56 | Odpovědět

#26 SodaE http://sodae.cz nový

Fakt super,duper , tohle využiju

Posláno 31. 1. 2008 ve 14.08 | Odpovědět

#27 Tarmaq nový

Poslusne hlasim ze ve Firefoxu 2.0.0.11@OpenSUSE 10.3 Gnome se zobrazi vse jak ma, v Konqueroru 3.5.7 nelze rozbalovat Call Stack, Source File, atd. tyto polozky lze pouze zabalit.. Samozrejme mam Konqueror pod Gnome, takze je mozne ze v KDE to pobezi v pohode, ale IMHO by to nemelo mit vliv.. Nevim jestli to nejak pomohlo, ale snad jo ;]

Posláno 31. 1. 2008 ve 14.30 | Odpovědět

Na komentář reagoval [30] David Grudl

#28 JS josef.sabl@gmail.com nový

Hmm, nějak se mi nepovedlo ji rozběhat pro vyjímky

Zobrazování všech vyjímek sice funguje v závislosti na tom, jakou úroveň reportování nastavím, ale zobrazí se v klasickým (hnusným) PHPkovským hávu.

Errory naopak zobrazuje správně tak, jak ukazuje příklad.

Mohl by mi prosím někdo poradit, co by mohlo být špatně? Díky.

Posláno 31. 1. 2008 ve 14.33 | Odpovědět

Na komentář reagoval [30] David Grudl

#29 Kamil http://www.kamil.cz nový

Ahoj Davide: error a výjimka hodí chybu, dump logicky ne, server běží na linuxu:

Fatal error: Maximum execution time of 60 seconds exceeded in /home/localhost/www2/class/NDebug/Nette/NDebug.php on line 158

Info: Red Hat 2.6.18–53.1.4.el5×en, PHP Version 5.1.6, safe_mode Off, … ?

Posláno 31. 1. 2008 v 15.35 | Odpovědět

Na komentář reagoval [30] David Grudl

#30 David Grudl http://davidgrudl.com nový

#27 Tarmaq: to mi moc nepomůže, potřeboval bych konkrétní opravu kódu.

#28 JS: výjimky s úrovní reportování nijak nesouvisí. Prostě vyhoď výjimku throw new Exception; a nezachycuj ji.

#29 Kamil: zajímavá chyba v ob_get_level, vyřešíme přes email.

Posláno 31. 1. 2008 v 17.13 | Odpovědět

#31 Vrtak-CZ http://www.vrtak-cz.net nový

Czus tak jsem si s ladenkou trochu hral a vzniklo z toho nakonec docela zajimava hracicka… Ladenka vs. DiBi a taky sem si trochu pohral s dumpem Ladenka vs. Dump
Jinak dekuju DGX za sqvelou vecicku…

Posláno 2. 2. 2008 ve 14.52 | Odpovědět

Na komentář reagoval [32] Patrik Bóna [38] David Grudl

#32 Patrik Bóna http://head.wall.sk/ nový

Cau Dgx,

Qcodo ma podobny error handler, ale nieje vnom tolko info ako v tvojom, len tak dalej ;)

#31 Vrtak-CZ: Ladenka vs. DiBi je tiez super ;)

Posláno 7. 2. 2008 v 19.59 | Odpovědět

#33 David Grudl http://davidgrudl.com nový

Přidal jsem experimentální podporu pro logování chyb (via NDebug::$logDir), odesílání chyb na email (NDebug::$email a NDebug::$emailSubject). Na produkčním serveru je pak nutné vypnout vypisování chyb (NDebug::$display = FALSE).

Posláno 12. 2. 2008 v 6.56 | Odpovědět

#34 Inza http://www.webend.cz nový

Perfektní, naprosto dokonalé Davide!:-)

Posláno 12. 2. 2008 v 8.04 | Odpovědět

#35 tajo nový

skvělý nástroj! dík

Posláno 14. 2. 2008 ve 23.29 | Odpovědět

#36 lordfrikk kucharczyk.lukas@gmail.com nový

Když jsem viděl slovo „laděnka“, tak moje první reakce byla, jak se anglicky říká: „I lol'd.“

Posláno 18. 2. 2008 v 10.42 | Odpovědět

#37 Neph04 adife@centrum.cz nový

To propojeni DIBI-Ladenka… neslo by implementovat do Ladenky neco jako udelal Vrtak?
Nasel sem dibi nedavno, a sem z nej nadsenej :) Dneska sem tu narazil na Ladenku a je to genialni vec…

Posláno 20. 2. 2008 ve 14.36 | Odpovědět

Na komentář reagoval [38] David Grudl

#38 David Grudl http://davidgrudl.com nový

#31 Vrtak-CZ: #37 Neph04: jo, udělal to pěkně a určitě něco podobného implementovat (přes obecný interface) plánuju.

Posláno 20. 2. 2008 v 15.16 | Odpovědět

Tento článek byl uzavřen. Už není možné k němu přidávat komentáře ani hlasovat

Výtah na začátek článku na první komentář

Názory čtenářů v diskusích nejsou názory provozovatele webu, a ten za jejich obsah neodpovídá.

Laděnka, jak se vám líbí?

Komentáře » přidat

#1 Hrach http://hrach.netuje.cz nový

#2 enoice http://enoice.fialove.eu nový

#3 papi http://ctenari.cz nový

#4 Tom nový

#5 Pixy pixy@pixy.cz nový

#6 Littlemaple http://blog.javorek.net nový

#7 v6ak http://v6ak.profitux.cz/ nový

#8 tark miroslav.navratil@gmail.com nový

#9 džidžir nový

#10 David Grudl http://davidgrudl.com nový

#11 džidžir nový

#12 Ondra nový

#13 v6ak http://v6ak.profitux.cz/ nový

#14 paranoiq paranoiq@centrum.cz nový

#15 bratr ekim http://bratrekim.unas.cz nový

#16 Littlemaple http://blog.javorek.net nový

#17 Věroš http://www.cestovatel.cz/ nový

#18 Oswald http://www.webkitchen.cz/ nový

#19 veena nový

#20 golf nový

#21 David Grudl http://davidgrudl.com nový

#22 David Grudl http://davidgrudl.com nový

#23 Oswald http://www.webkitchen.cz/ nový

#24 v6ak http://v6ak.profitux.cz/ nový

#25 Věroš http://www.cestovatel.cz/ nový

#26 SodaE http://sodae.cz nový

#27 Tarmaq nový

#28 JS josef.sabl@gmail.com nový

#29 Kamil http://www.kamil.cz nový

#30 David Grudl http://davidgrudl.com nový

#31 Vrtak-CZ http://www.vrtak-cz.net nový

#32 Patrik Bóna http://head.wall.sk/ nový

#33 David Grudl http://davidgrudl.com nový

#34 Inza http://www.webend.cz nový

#35 tajo nový

#36 lordfrikk kucharczyk.lukas@gmail.com nový

#37 Neph04 adife@centrum.cz nový

#38 David Grudl http://davidgrudl.com nový

Aktuální termíny školení

Doporučuji k přečtení

Navigace

Poslední články

Kategorie

Projekty

Používám a doporučuji

Statistiky

Odběr zpráv