Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
docker:xdebug:xdebug.ini [2020/03/21 13:40] werwolf |
docker:xdebug:xdebug.ini [2023/01/12 12:18] (текущий) |
||
|---|---|---|---|
| Строка 3: | Строка 3: | ||
| == О чем? == | == О чем? == | ||
| - | \\ | + | Всё о том же — об отладке сценариев PHP средствами модуля xdebug, точнее сказать о том файле, который обычно вызывает ряд вопросов, на которые не всегда находятся внятные ответы — o xdebug.ini (или о части php.ini, содержащим настройки xdebug). |
| - | Всё о том же — об отладке сценариев PHP средствами модуля [[http://xdebug.com|xdebug]], точнее сказать о том файле, который обычно вызывает ряд вопросов, на которые не всегда находятся внятные ответы — o xdebug.ini (или о части php.ini, содержащим настройки xdebug).\\ | + | Представляю вашим внемлющим разумам содержимое файла конфигурации с моими комментариями в свободной форме. |
| - | Представляю вашим внемлющим разумам содержимое файла конфигурации с моими комментариями в свободной форме.\\ | + | |
| - | == Кому адресовано? == | + | |
| - | \\ | + | <code ini> |
| - | В основном материал рассчитан на программистов PHP, которые волей судьбы (случая, etc…) решили заняться профилированием и отладкой многих и многих своих кодов средствами модуля xdebug. Да ещё, плюс ко всему, с английским языком у которых не все в порядке. | + | [Подключение модуля] |
| + | zend_extension = /usr/lib/php5/20090626/xdebug.so | ||
| - | == Почему написал? == | + | [Основные] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Основные настройки ; | ||
| + | ; Документация http://www.xdebug.org/docs/basic ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | \\ | + | ; Включение обработчика ошибок xDebug (заменяет стандартный вывод ошибок). |
| - | Потому что столкнулся с подобного рода проблемой относительно недавно… разобрался и решил поделиться с общественностью. | + | ; |
| + | ; Тип boolean | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#default_enable | ||
| + | xdebug.default_enable = 1 | ||
| - | == Чего здесь нет? == | + | ; Максимальный уровень рекурсии (превышение порога прекращает выполнение функции). |
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 100 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#max_nesting_level | ||
| + | xdebug.max_nesting_level = 150 | ||
| - | \\ | + | ; Отключение оператора подавления вывода ошибок "@". |
| - | Установка, как пользоваться, где взять, кого спросить и прочие аспекты работы с xdebug, не касающиеся конфигурационного файла.\\ | + | ; |
| - | === Начнем ===''[Подключение модуля] zend_extension = /usr/lib/php5/20090626/xdebug.so '' | + | ; Тип boolean |
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#scream | ||
| + | xdebug.scream = 1 | ||
| - | ''[Основные] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Основные настройки ; ; Документация [[http://www.xdebug.org/docs/basic|http://www.xdebug.org/docs/basic]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | [Отображения переменных] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Данные настройки влияют на вывод переменных функцией var_dump() ; | ||
| + | ; Не влияют на отправляемые данные для удаленных клиентов ; | ||
| + | ; Документация http://xdebug.com/docs/display ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ''; Включение обработчика ошибок xDebug (заменяет стандартный вывод ошибок). ; ; Тип boolean ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#default_enable|http://www.xdebug.org/docs/all_settings#default_enable]] xdebug.default_enable = 1 '' | + | ; Включение xDebug для перегрузки var_dump(). |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#overload_var_dump | ||
| + | xdebug.overload_var_dump = 1 | ||
| - | ''; Максимальный уровень рекурсии (превышение порога прекращает выполнение функции). ; ; Тип integer ; По умолчанию 100 ; Документация [[http://www.xdebug.org/docs/all_settings#max_nesting_level|http://www.xdebug.org/docs/all_settings#max_nesting_level]] xdebug.max_nesting_level = 150 '' | + | ; Максимальное число выводимых элементов массива или свойств объекта. |
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 128 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#var_display_max_children | ||
| + | xdebug.var_display_max_children = 256 | ||
| - | ''; Отключение оператора подавления вывода ошибок "@". ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#scream|http://www.xdebug.org/docs/all_settings#scream]] xdebug.scream = 1 '' | + | ; Максимальный уровень вложенности элементов в массиве или свойстве объекта. |
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 3 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#var_display_max_depth | ||
| + | xdebug.var_display_max_depth = 16 | ||
| - | ''[Отображения переменных] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Данные настройки влияют на вывод переменных функцией var_dump() ; ; Не влияют на отправляемые данные для удаленных клиентов ; ; Документация [[http://xdebug.com/docs/display|http://xdebug.com/docs/display]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | ; Максимальная длина выводимых строк. |
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 512 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#var_display_max_data | ||
| + | xdebug.var_display_max_data = 1024 | ||
| - | ''; Включение xDebug для перегрузки var_dump(). ; ; Тип boolean ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#overload_var_dump|http://www.xdebug.org/docs/all_settings#overload_var_dump]] xdebug.overload_var_dump = 1 '' | + | [Трассировка стека] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Данные настройки влияют на информативность отображение стека трассировки ; | ||
| + | ; Вывод осуществляется при возникновении ошибок (предупреждений и т.п.) ; | ||
| + | ; Документация http://xdebug.com/docs/stack_trace ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ''; Максимальное число выводимых элементов массива или свойств объекта. ; ; Тип integer ; По умолчанию 128 ; Документация [[http://www.xdebug.org/docs/all_settings#var_display_max_children|http://www.xdebug.org/docs/all_settings#var_display_max_children]] xdebug.var_display_max_children = 256 '' | + | ; Отображение пути к файлу в инструкциях типа include/require. |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#collect_includes | ||
| + | xdebug.collect_includes = 1 | ||
| - | ''; Максимальный уровень вложенности элементов в массиве или свойстве объекта. ; ; Тип integer ; По умолчанию 3 ; Документация [[http://www.xdebug.org/docs/all_settings#var_display_max_depth|http://www.xdebug.org/docs/all_settings#var_display_max_depth]] xdebug.var_display_max_depth = 16 '' | + | ; Отображение параметров, передаваемых при вызове функции. |
| + | ; Для больших сценариев может не хватить памяти для детализации параметров! | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#collect_params | ||
| + | ; Возможные значения: | ||
| + | ; 0 - не отображать | ||
| + | ; 1 - отображать тип и количество элементов (array(5), string(8)) | ||
| + | ; 2 - то же, что и "1", только с выводом подсказок (не работает в версии CLI) | ||
| + | ; 3 - информация о переменных с учетом "Настройки отображения переменных" | ||
| + | ; 4 - вся информация о переменных, включая имена переменных | ||
| + | xdebug.collect_params = 4 | ||
| - | ''; Максимальная длина выводимых строк. ; ; Тип integer ; По умолчанию 512 ; Документация [[http://www.xdebug.org/docs/all_settings#var_display_max_data|http://www.xdebug.org/docs/all_settings#var_display_max_data]] xdebug.var_display_max_data = 1024 '' | + | ; Сбор информации о переменных. |
| + | ; Данный параметр имеет смысл только если планируется использование функции | ||
| + | ; xdebug_get_declared_vars(). | ||
| + | ; Анализ может быть довольно медленным! | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#collect_vars | ||
| + | xdebug.collect_vars = 1 | ||
| - | ''[Трассировка стека] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Данные настройки влияют на информативность отображение стека трассировки ; ; Вывод осуществляется при возникновении ошибок (предупреждений и т.п.) ; ; Документация [[http://xdebug.com/docs/stack_trace|http://xdebug.com/docs/stack_trace]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | ; Отображение суперглобальных данных. |
| + | ; Данный параметр отвечает за отображение определенных данных из суперглобальных | ||
| + | ; переменных при возникновении ошибки. | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию '' | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#dump.* | ||
| + | ; Возможные варианты: | ||
| + | ; xdebug.dump.COOKIE = | ||
| + | ; xdebug.dump.FILES = | ||
| + | ; xdebug.dump.GET = | ||
| + | ; xdebug.dump.POST = | ||
| + | ; xdebug.dump.REQUEST = | ||
| + | ; xdebug.dump.SERVER = | ||
| + | ; xdebug.dump.SESSION = | ||
| + | ; Возможные значения: | ||
| + | ; * - отображать всё (xdebug.dump.REQUEST = *) | ||
| + | ; 'key1, ...' - отображать определенные значение | ||
| + | ; (xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD) | ||
| + | xdebug.dump.REQUEST = * | ||
| + | xdebug.dump.SESSION = * | ||
| + | xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD | ||
| - | ''; Отображение пути к файлу в инструкциях типа include/require. ; ; Тип boolean ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#collect_includes|http://www.xdebug.org/docs/all_settings#collect_includes]] xdebug.collect_includes = 1 '' | + | ; Вывод информации, собранной из суперглобальных массивов. |
| + | ; Отображает результаты работы xdebug.dump.* | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#dump_globals | ||
| + | xdebug.dump_globals = 1 | ||
| - | ''; Отображение параметров, передаваемых при вызове функции. ; Для больших сценариев может не хватить памяти для детализации параметров! ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#collect_params|http://www.xdebug.org/docs/all_settings#collect_params]] ; Возможные значения: ; 0 - не отображать ; 1 - отображать тип и количество элементов (array(5), string(8)) ; 2 - то же, что и "1", только с выводом подсказок (не работает в версии CLI) ; 3 - информация о переменных с учетом "Настройки отображения переменных" ; 4 - вся информация о переменных, включая имена переменных xdebug.collect_params = 4 '' | + | ; Вывод информации, собранной из суперглобальных массивов при каждой ошибке. |
| + | ; Обычно суперглобальные массивы остаются неизменными на протяжении всего скрипта, | ||
| + | ; поэтому нет смысла при выводе каждой ошибки отображать эти данные повторно. | ||
| + | ; Если значение установлено в 0 - данные выводятся каждый раз. | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#dump_once | ||
| + | xdebug.dump_once = 1 | ||
| - | ''; Сбор информации о переменных. ; Данный параметр имеет смысл только если планируется использование функции ; xdebug_get_declared_vars(). ; Анализ может быть довольно медленным! ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#collect_vars|http://www.xdebug.org/docs/all_settings#collect_vars]] xdebug.collect_vars = 1 '' | + | ; Вывод неопределенных значений суперглобальных массивов. |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#dump_undefined | ||
| + | xdebug.dump_undefined = 1 | ||
| - | ''; Отображение суперглобальных данных. ; Данный параметр отвечает за отображение определенных данных из суперглобальных ; переменных при возникновении ошибки. ; ; Тип string ; По умолчанию '' ; Документация [[http://www.xdebug.org/docs/all_settings#dump|http://www.xdebug.org/docs/all_settings#dump]].* ; Возможные варианты: ; xdebug.dump.COOKIE = ; xdebug.dump.FILES = ; xdebug.dump.GET = ; xdebug.dump.POST = ; xdebug.dump.REQUEST = ; xdebug.dump.SERVER = ; xdebug.dump.SESSION = ; Возможные значения: ; * - отображать всё (xdebug.dump.REQUEST = *) ; 'key1, …' - отображать определенные значение ; (xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD) xdebug.dump.REQUEST = * xdebug.dump.SESSION = * xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD ; Вывод информации, собранной из суперглобальных массивов. ; Отображает результаты работы xdebug.dump.* ; ; Тип boolean ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#dump_globals|http://www.xdebug.org/docs/all_settings#dump_globals]] xdebug.dump_globals = 1 ; Вывод информации, собранной из суперглобальных массивов при каждой ошибке. ; Обычно суперглобальные массивы остаются неизменными на протяжении всего скрипта, ; поэтому нет смысла при выводе каждой ошибки отображать эти данные повторно. ; Если значение установлено в 0 - данные выводятся каждый раз. ; ; Тип boolean ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#dump_once|http://www.xdebug.org/docs/all_settings#dump_once]] xdebug.dump_once = 1 ; Вывод неопределенных значений суперглобальных массивов. ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#dump_undefined|http://www.xdebug.org/docs/all_settings#dump_undefined]] xdebug.dump_undefined = 1 ; Формат ссылки для имен файлов, выводимых при трассировке. ; Данные ссылки предназначены для перехода к определенному файлу и строки в нем. ; Для более детального изучения данного параметра обратитесь к документации. ; Введен в Xdebug 2.1 ; ; Тип string ; По умолчанию ''; Документация [[http://www.xdebug.org/docs/all_settings#file_link_format|http://www.xdebug.org/docs/all_settings#file_link_format]] xdebug.file_link_format = '' | + | ; Формат ссылки для имен файлов, выводимых при трассировке. |
| + | ; Данные ссылки предназначены для перехода к определенному файлу и строки в нем. | ||
| + | ; Для более детального изучения данного параметра обратитесь к документации. | ||
| + | ; Введен в Xdebug 2.1 | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию '' | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#file_link_format | ||
| + | xdebug.file_link_format = | ||
| - | ''; Формат ссылки на документацию для функций. ; При нажатии на ссылку будет происходить переход по адресу, ; указанному в данном параметре + название функции. ; ; Тип string ; По умолчанию [[http://www.php.net|http://www.php.net]] ; Документация [[http://www.xdebug.org/docs/all_settings#manual_url|http://www.xdebug.org/docs/all_settings#manual_url]] xdebug.manual_url = [[http://www.php.net|http://www.php.net]] '' | + | ; Формат ссылки на документацию для функций. |
| + | ; При нажатии на ссылку будет происходить переход по адресу, | ||
| + | ; указанному в данном параметре + название функции. | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию http://www.php.net | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#manual_url | ||
| + | xdebug.manual_url = http://www.php.net | ||
| - | ''; Вывод стека трассировки исключения. ; Действительно, даже если исключение было перехвачено. ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#show_exception_trace|http://www.xdebug.org/docs/all_settings#show_exception_trace]] xdebug.show_exception_trace = 1 '' | + | ; Вывод стека трассировки исключения. |
| + | ; Действительно, даже если исключение было перехвачено. | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#show_exception_trace | ||
| + | xdebug.show_exception_trace = 1 | ||
| - | ''; Вывод информации о переменных в текущей области видимости. ; Может выводить очень много информации и поэтому по умолчанию отключен. ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#show_local_vars|http://www.xdebug.org/docs/all_settings#show_local_vars]] xdebug.show_local_vars = 1 '' | + | ; Вывод информации о переменных в текущей области видимости. |
| + | ; Может выводить очень много информации и поэтому по умолчанию отключен. | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#show_local_vars | ||
| + | xdebug.show_local_vars = 1 | ||
| - | ''; Запись различий в памяти между вызовами функции. ; Записывает в файлах трассировки при установленном xdebug.trace_format = 0. ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#show_mem_delta|http://www.xdebug.org/docs/all_settings#show_mem_delta]] xdebug.show_mem_delta = 1 '' | + | ; Запись различий в памяти между вызовами функции. |
| + | ; Записывает в файлах трассировки при установленном xdebug.trace_format = 0. | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#show_mem_delta | ||
| + | xdebug.show_mem_delta = 1 | ||
| - | ''[Следы] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Данные настройки нужны для функций, помогающих понять принцип работы приложения ; ; Документация [[http://xdebug.com/docs/execution_trace|http://xdebug.com/docs/execution_trace]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | [Следы] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Данные настройки нужны для функций, помогающих понять принцип работы приложения ; | ||
| + | ; Документация http://xdebug.com/docs/execution_trace ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ''; Включение трассировки функций автоматически. ; Делает возможным слежение в auto_prepend_file ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#auto_trace|http://www.xdebug.org/docs/all_settings#auto_trace]] xdebug.auto_trace = 1 '' | + | ; Включение трассировки функций автоматически. |
| + | ; Делает возможным слежение в auto_prepend_file | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#auto_trace | ||
| + | xdebug.auto_trace = 1 | ||
| - | ''; Добавление значений переменных в след. ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#collect_assignments|http://www.xdebug.org/docs/all_settings#collect_assignments]] xdebug.collect_assignments = 1 '' | + | ; Добавление значений переменных в след. |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#collect_assignments | ||
| + | xdebug.collect_assignments = 1 | ||
| - | ''; Добавление возвращаемых функциями значений в след. ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#collect_return|http://www.xdebug.org/docs/all_settings#collect_return]] xdebug.collect_return = 1 '' | + | ; Добавление возвращаемых функциями значений в след. |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#collect_return | ||
| + | xdebug.collect_return = 1 | ||
| - | ''; Формат файла трассировки. ; 0 - человеко-понятный, 1 - для обработки парсерами (программами для чтения) ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#trace_format|http://www.xdebug.org/docs/all_settings#trace_format]] xdebug.trace_format = 1 '' | + | ; Формат файла трассировки. |
| + | ; 0 - человеко-понятный, 1 - для обработки парсерами (программами для чтения) | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#trace_format | ||
| + | xdebug.trace_format = 1 | ||
| - | ''; Определение порядка записи файла. ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#trace_options|http://www.xdebug.org/docs/all_settings#trace_options]] xdebug.trace_options = 0 '' | + | ; Определение порядка записи файла. |
| + | ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#trace_options | ||
| + | xdebug.trace_options = 0 | ||
| - | ''; Директория для сохранения файлов трассировки. ; ; Тип string ; По умолчанию /tmp ; Документация [[http://www.xdebug.org/docs/all_settings#trace_output_dir|http://www.xdebug.org/docs/all_settings#trace_output_dir]] xdebug.trace_output_dir = /var/www/xdebug/log '' | + | ; Директория для сохранения файлов трассировки. |
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию /tmp | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#trace_output_dir | ||
| + | xdebug.trace_output_dir = /var/www/xdebug/log | ||
| - | ''; Формат именования файлов трассировки. ; Спецификаторы: ; %c crc32 текущего каталога trace.%c trace.1258863198.xt ; %p pid (id процесса) trace.%p trace.5174.xt ; %r случайное число trace.%r trace.072db0.xt ; %s имя сценария (полный путь файла)* trace.%s trace._var_www_test_php ; %t время в секудах с 01.01.1970 trace.%t trace.1179434742.xt ; %u время в микросекундах с 01.01.1970 trace.%u trace.1179434749_642382.xt ; %H $_SERVER['HTTP_HOST']* trace.%H trace.kossu.xt ; %R $_SERVER['REQUEST_URI']* trace.%R trace._test_php_param_1 ; %S id сессии (берется из Cookie) trace.%S trace.c70c1e … 0bbdd2a679d.xt ; символ % trace. trace.%%.xt ; *) Все символы отличные от букв латинского алфавита и цифр будут заменены на символ "_" ; ; Тип string ; По умолчанию trace.%c ; Документация [[http://www.xdebug.org/docs/all_settings#trace_output_name|http://www.xdebug.org/docs/all_settings#trace_output_name]] xdebug.trace_output_name = trace.%c '' | + | ; Формат именования файлов трассировки. |
| + | ; Спецификаторы: | ||
| + | ; %c crc32 текущего каталога trace.%c trace.1258863198.xt | ||
| + | ; %p pid (id процесса) trace.%p trace.5174.xt | ||
| + | ; %r случайное число trace.%r trace.072db0.xt | ||
| + | ; %s имя сценария (полный путь файла)* trace.%s trace._var_www_test_php | ||
| + | ; %t время в секудах с 01.01.1970 trace.%t trace.1179434742.xt | ||
| + | ; %u время в микросекундах с 01.01.1970 trace.%u trace.1179434749_642382.xt | ||
| + | ; %H $_SERVER['HTTP_HOST']* trace.%H trace.kossu.xt | ||
| + | ; %R $_SERVER['REQUEST_URI']* trace.%R trace._test_php_param_1 | ||
| + | ; %S id сессии (берется из Cookie) trace.%S trace.c70c1e ... 0bbdd2a679d.xt | ||
| + | ; %% символ % trace.%% trace.%%.xt | ||
| + | ; *) Все символы отличные от букв латинского алфавита и цифр будут заменены на символ "_" | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию trace.%c | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#trace_output_name | ||
| + | xdebug.trace_output_name = trace.%c | ||
| - | ''[Удаленная отладка] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Настройки интерфейса для удаленных клиентов ; ; Документация [[http://xdebug.com/docs/remote|http://xdebug.com/docs/remote]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | [Удаленная отладка] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Настройки интерфейса для удаленных клиентов ; | ||
| + | ; Документация http://xdebug.com/docs/remote ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ''; Генерация расширенной информации, необходимой для точек останова удаленного отладчика. ; При включении исполняемый код увеличивается примерно на 33%, ; что делает скрипт немного медленнее. ; ; Тип integer ; По умолчанию 1 ; Документация [[http://www.xdebug.org/docs/all_settings#extended_info|http://www.xdebug.org/docs/all_settings#extended_info]] xdebug.extended_info = 1 '' | + | ; Генерация расширенной информации, необходимой для точек останова удаленного отладчика. |
| + | ; При включении исполняемый код увеличивается примерно на 33%, | ||
| + | ; что делает скрипт немного медленнее. | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 1 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#extended_info | ||
| + | xdebug.extended_info = 1 | ||
| - | ''; Ключ для удаленных отладчиков. ; Необходим для старта сессии удаленной отладки. ; ; Тип string ; По умолчанию *complex* ; Документация [[http://www.xdebug.org/docs/all_settings#idekey|http://www.xdebug.org/docs/all_settings#idekey]] xdebug.idekey = *complex* '' | + | ; Ключ для удаленных отладчиков. |
| + | ; Необходим для старта сессии удаленной отладки. | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию *complex* | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#idekey | ||
| + | xdebug.idekey = *complex* | ||
| - | ''; Автоматический старт сеанса отладки без GET/POST запроса. ; Обычно для старта сессии необходим специальный GET/POST запрос. ; Если значение установлено в 1, xDebug будет пытаться начать сеанс отладки ; и подключение к клиенту без GET/POST параметров. ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#remote_autostart|http://www.xdebug.org/docs/all_settings#remote_autostart]] xdebug.remote_autostart = 0 '' | + | ; Автоматический старт сеанса отладки без GET/POST запроса. |
| + | ; Обычно для старта сессии необходим специальный GET/POST запрос. | ||
| + | ; Если значение установлено в 1, xDebug будет пытаться начать сеанс отладки | ||
| + | ; и подключение к клиенту без GET/POST параметров. | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_autostart | ||
| + | xdebug.remote_autostart = 0 | ||
| - | ''; Включение режима удаленной отладки. ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#remote_enable|http://www.xdebug.org/docs/all_settings#remote_enable]] xdebug.remote_enable = 0 '' | + | ; Включение режима удаленной отладки. |
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_enable | ||
| + | xdebug.remote_enable = 0 | ||
| - | ''; Протокол отладчика. ; Xdebug 2.1 и поздние версии поддерживают только DBGp! ; ; Тип string ; По умолчанию dbgp ; Документация [[http://www.xdebug.org/docs/all_settings#remote_handler|http://www.xdebug.org/docs/all_settings#remote_handler]] xdebug.remote_handler = dbgp '' | + | ; Протокол отладчика. |
| + | ; Xdebug 2.1 и поздние версии поддерживают только DBGp! | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию dbgp | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_handler | ||
| + | xdebug.remote_handler = dbgp | ||
| - | ''; Адрес компьютера, на котором расположен клиент отладчика. ; Настройка игнорируется, если значение xdebug.remote_connect_back установлено в 1 ; ; Тип string ; По умолчанию localhost ; Документация [[http://www.xdebug.org/docs/all_settings#remote_host|http://www.xdebug.org/docs/all_settings#remote_host]] xdebug.remote_host = 192.168.0.99 '' | + | ; Адрес компьютера, на котором расположен клиент отладчика. |
| + | ; Настройка игнорируется, если значение xdebug.remote_connect_back установлено в 1 | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию localhost | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_host | ||
| + | xdebug.remote_host = 192.168.0.99 | ||
| - | ''; Активация сеанса отладки со всеми, кто передал специальный GET/POST параметр на сервер. ; Учтите, что сеанс могуть начать все, кто имеет доступ к серверу по http! ; ; Тип boolean ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#remote_connect_back|http://www.xdebug.org/docs/all_settings#remote_connect_back]] xdebug.remote_connect_back = 0 '' | + | ; Активация сеанса отладки со всеми, кто передал специальный GET/POST параметр на сервер. |
| + | ; Учтите, что сеанс могуть начать все, кто имеет доступ к серверу по http! | ||
| + | ; | ||
| + | ; Тип boolean | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_connect_back | ||
| + | xdebug.remote_connect_back = 0 | ||
| - | ''; Путь к файл-логу для записи всех, кто обращался к отладчику. ; ; Тип string ; По умолчанию '' ; Документация [[http://www.xdebug.org/docs/all_settings#remote_log|http://www.xdebug.org/docs/all_settings#remote_log]] xdebug.remote_log = /var/www/xdebug/log/access.log '' | + | ; Путь к файл-логу для записи всех, кто обращался к отладчику. |
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию '' | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_log | ||
| + | xdebug.remote_log = /var/www/xdebug/log/access.log | ||
| - | ''; Настройка подключения к клиенту отладки. ; REQ - как только скрипт начал работать, JIT - при возникновении ошибки ; ; Тип string ; По умолчанию req ; Документация [[http://www.xdebug.org/docs/all_settings#remote_mode|http://www.xdebug.org/docs/all_settings#remote_mode]] xdebug.remote_mode = req '' | + | ; Настройка подключения к клиенту отладки. |
| + | ; REQ - как только скрипт начал работать, JIT - при возникновении ошибки | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию req | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_mode | ||
| + | xdebug.remote_mode = req | ||
| - | ''; Порт, по которому xDebug пытается подключится к удаленному отладчику. ; ; Тип integer ; По умолчанию 9000 ; Документация [[http://www.xdebug.org/docs/all_settings#remote_port|http://www.xdebug.org/docs/all_settings#remote_port]] xdebug.remote_port = 9000 '' | + | ; Порт, по которому xDebug пытается подключится к удаленному отладчику. |
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 9000 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#remote_port | ||
| + | xdebug.remote_port = 9000 | ||
| - | ''[Профилирование] ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Настройки, управляющие профилированием скриптов ; ; Документация [[http://xdebug.com/docs/profiler|http://xdebug.com/docs/profiler]] ; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; '' | + | [Профилирование] |
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| + | ; Настройки, управляющие профилированием скриптов ; | ||
| + | ; Документация http://xdebug.com/docs/profiler ; | ||
| + | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ''; Определение порядка записи. ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#profiler_append|http://www.xdebug.org/docs/all_settings#profiler_append]] xdebug.profiler_append = 1 '' | + | ; Определение порядка записи. |
| + | ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#profiler_append | ||
| + | xdebug.profiler_append = 1 | ||
| - | ''; Включение режима профилирования. ; Профилирование будет осуществляться при каждом запуске любого сценария. ; Для более управляемого профилирования используйте установку xdebug.profiler_enable_trigger ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#profiler_enable|http://www.xdebug.org/docs/all_settings#profiler_enable]] xdebug.profiler_enable = 1 '' | + | ; Включение режима профилирования. |
| + | ; Профилирование будет осуществляться при каждом запуске любого сценария. | ||
| + | ; Для более управляемого профилирования используйте установку xdebug.profiler_enable_trigger | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#profiler_enable | ||
| + | xdebug.profiler_enable = 1 | ||
| - | ''; Включения профилирования посредством специального GET/POST параметра. ; Если значение установлено в 1, то при выполнении сценария с GET/POST ; параметром XDEBUG_PROFILE профилирование будет выполнено вне зависимости ; от установки xdebug.profiler_enable. ; Пример: [[http://www.example.com/?XDEBUG_PROFILE|http://www.example.com/?XDEBUG_PROFILE]] ; ; Тип integer ; По умолчанию 0 ; Документация [[http://www.xdebug.org/docs/all_settings#profiler_enable_trigger|http://www.xdebug.org/docs/all_settings#profiler_enable_trigger]] xdebug.profiler_enable_trigger = 1 '' | + | ; Включения профилирования посредством специального GET/POST параметра. |
| + | ; Если значение установлено в 1, то при выполнении сценария с GET/POST | ||
| + | ; параметром XDEBUG_PROFILE профилирование будет выполнено вне зависимости | ||
| + | ; от установки xdebug.profiler_enable. | ||
| + | ; Пример: http://www.example.com/?XDEBUG_PROFILE | ||
| + | ; | ||
| + | ; Тип integer | ||
| + | ; По умолчанию 0 | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#profiler_enable_trigger | ||
| + | xdebug.profiler_enable_trigger = 1 | ||
| - | ''; Директория для сохранения файлов профилирования. ; ; Тип string ; По умолчанию /tmp ; Документация [[http://www.xdebug.org/docs/all_settings#profiler_output_dir|http://www.xdebug.org/docs/all_settings#profiler_output_dir]] xdebug.profiler_output_dir = /var/www/xdebug/log '' | + | ; Директория для сохранения файлов профилирования. |
| - | + | ; | |
| - | ''; Формат именования файлов профилирования. ; См. xdebug.trace_output_name ; ; Тип string ; По умолчанию cachegrind.out.%p ; Документация [[http://www.xdebug.org/docs/all_settings#profiler_output_name|http://www.xdebug.org/docs/all_settings#profiler_output_name]] xdebug.profiler_output_name = cachegrind.out.%p '' | + | ; Тип string |
| - | + | ; По умолчанию /tmp | |
| - | \\ | + | ; Документация http://www.xdebug.org/docs/all_settings#profiler_output_dir |
| - | ''В принципе это все доступные на данный момент задокументированные настройки xdebug 2.1.\\ | + | xdebug.profiler_output_dir = /var/www/xdebug/log |
| - | Почти все из них можно переопределять непосредственно вызовом ini_set().'' | + | |
| + | ; Формат именования файлов профилирования. | ||
| + | ; См. xdebug.trace_output_name | ||
| + | ; | ||
| + | ; Тип string | ||
| + | ; По умолчанию cachegrind.out.%p | ||
| + | ; Документация http://www.xdebug.org/docs/all_settings#profiler_output_name | ||
| + | xdebug.profiler_output_name = cachegrind.out.%p | ||
| + | </code> | ||