1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-27 01:02:19 +01:00
Files
archived-doc-ru/reference/errorfunc/functions/debug-print-backtrace.xml
Sergey Panteleev daef8df962 Обнуление тега Reviewed (#364)
[skip-lint]
[skip-spellcheck]
2021-11-16 13:03:53 +03:00

154 lines
4.1 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 24ea750d479d4992705bfb11bd3be4a388c7c13f Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.debug-print-backtrace" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>debug_print_backtrace</refname>
<refpurpose>
Выводит стек вызовов функций
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>debug_print_backtrace</methodname>
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>limit</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<function>debug_print_backtrace</function> выводит стек вызовов функций.
Выводит вызовы функций, имена включённых/требуемых файлов и другую
информацию из функций (<function>eval</function>).
</para>
</refsect1>
<refsect1 role="parameters"><!-- {{{ -->
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>options</parameter></term>
<listitem>
<para>
Аргумент является битовой маской для следующих
настроек:
<table>
<title>Опции <function>debug_print_backtrace</function></title>
<tgroup cols="2">
<tbody>
<row>
<entry>DEBUG_BACKTRACE_IGNORE_ARGS</entry>
<entry>
Нужно ли исключить ключ "args", то есть
списки аргументов всех функций/методов, чтобы уменьшить расход
памяти.
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>limit</parameter></term>
<listitem>
<para>
Аргумент используется для ограничения количества
вызовов функций, которые будут выведены. По умолчанию
(<parameter>limit</parameter>=<literal>0</literal>) будет выведен весь
стек вызовов.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1><!-- }}} -->
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>debug_print_backtrace</function></title>
<programlisting role="php">
<![CDATA[
<?php
// файл include.php
function a() {
b();
}
function b() {
c();
}
function c(){
debug_print_backtrace();
}
a();
?>
]]>
</programlisting>
<programlisting role="php">
<![CDATA[
<?php
// файл test.php
// этот файл нужно запустить
include 'include.php';
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
#0 c() called at [/tmp/include.php:10]
#1 b() called at [/tmp/include.php:6]
#2 a() called at [/tmp/include.php:17]
#3 include(/tmp/include.php) called at [/tmp/test.php:3]
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>debug_backtrace</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->