repo_zf1/documentation/manual/cs/module_specs/Zend_Debug.xml

<sect1 id="zend.debug.dumping">

	<title>Ladění proměnných</title>

	<para>
		Statická metoda
		<code>Zend_Debug::dump()</code>
		vypisuje nebo vrací informaci
		o určitém výrazu. Tento způsob ladění kódu se používá běžně, protože
		není
		třeba používat žádné speciální nástroje nebo prostředí pro ladění.
	</para>

	<example id="zend.debug.dumping.example">
		<title>Příklad použití metody dump()</title>
		<programlisting role="php"><![CDATA[<?php

Zend_Debug::dump($var, $label=null, $echo=true)

?>]]></programlisting>
	</example>


	<para>
		Parametr
		<code>$var</code>
		přijímá výraz nebo proměnnou, jejíž
		obsah bude vypsán metodou
		<code>Zend_Debug::dump()</code>
		.
	</para>

	<para>
		Parametr
		<code>$label</code>
		obsahuje řetězec, který bude rovněž vypsán metodou
		<code>Zend_Debug::dump()</code>
		. Může být velmi užitečný v případě, kdy
		jsou vypisovány informace o více proměnných najednou.
	</para>

	<para>
		Parametr
		<code>$echo</code>
		obsahuje boolean hodnotu (true/false)
		a určuje, zda má být výstup metody
		<code>Zend_Debug::dump()</code>
		vypsán.
		Jestliže je hodnota
		<code>true</code>
		(defaultně), obsah je vypsán.
		Bez ohledu na hodnotu parametru
		<code>$echo</code>
		, vždy je vrácen nějaký
		obsah.
	</para>

	<para>
		Může být užitečné vědět, že metoda
		<code>Zend_Debug::dump()</code>
		interně používá funkci
		<ulink url="http://php.net/var_dump">
			<code>var_dump()</code>
		</ulink>
		.
		Metoda navíc zjišťuje, zda bude výstup vypsán ve webové prezentaci.
		Pokud ano, pak je výstup metody
		<code>var_dump()</code>
		escapován funkcí
		<ulink url="http://php.net/htmlspecialchars">
			<code>htmlspecialchars()</code>
		</ulink>
		a obalen elementy (X)HTML
		<code>&lt;pre&gt;</code>
		.
	</para>

	<tip>
		<title>Ladění pomocí Zend_Log</title>
		<para>
			Používání metody
			<code>Zend_Debug::dump()</code>
			je velmi dobré pro
			jednoduché ladění během vývoje. Jednoduše můžete přidat kód, který
			vypíše hodnotu proměnné a pak jej zase rychle odstranit.
		</para>
		<para>
			Je možné také používat knihovnu
			<link linkend="zend.log.overview">Zend_Log</link>
			pro dlouhodobé ladění kódu.
			Např. můžete používat
			<code>DEBUG</code>
			log level a výsledek metody
			<code>Zend_Debug::dump()</code>
			zapisovat do logu.
		</para>

	</tip>

</sect1>
<!-- vim:se ts=4 sw=4 et: -->