Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
docker:xdebug:xdebug.ini [2020/03/21 13:39] werwolf |
docker:xdebug:xdebug.ini [2023/01/12 12:18] (текущий) |
||
|---|---|---|---|
| Строка 2: | Строка 2: | ||
| == О чем? == | == О чем? == | ||
| - | \\ | + | |
| - | Всё о том же — об отладке сценариев PHP средствами модуля [[http://xdebug.com|xdebug]], точнее сказать о том файле, который обычно вызывает ряд вопросов, на которые не всегда находятся внятные ответы — o xdebug.ini (или о части php.ini, содержащим настройки xdebug).\\ | + | Всё о том же — об отладке сценариев PHP средствами модуля xdebug, точнее сказать о том файле, который обычно вызывает ряд вопросов, на которые не всегда находятся внятные ответы — o xdebug.ini (или о части php.ini, содержащим настройки xdebug). |
| - | Представляю вашим внемлющим разумам содержимое файла конфигурации с моими комментариями в свободной форме.\\ | + | Представляю вашим внемлющим разумам содержимое файла конфигурации с моими комментариями в свободной форме. |
| - | \\ | + | |
| - | == Кому адресовано? == | + | <code ini> |
| - | \\ | + | [Подключение модуля] |
| - | В основном материал рассчитан на программистов PHP, которые волей судьбы (случая, etc...) решили заняться профилированием и отладкой многих и многих своих кодов средствами модуля xdebug. Да ещё, плюс ко всему, с английским языком у которых не все в порядке.\\ | + | |
| - | == Почему написал? == | + | |
| - | \\ | + | |
| - | Потому что столкнулся с подобного рода проблемой относительно недавно… разобрался и решил поделиться с общественностью.\\ | + | |
| - | == Чего здесь нет? == | + | |
| - | \\ | + | |
| - | Установка, как пользоваться, где взять, кого спросить и прочие аспекты работы с xdebug, не касающиеся конфигурационного файла.\\ | + | |
| - | === Начнем ===<code>[Подключение модуля] | + | |
| zend_extension = /usr/lib/php5/20090626/xdebug.so | zend_extension = /usr/lib/php5/20090626/xdebug.so | ||
| [Основные] | [Основные] | ||
| ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| - | ; Основные настройки ; | + | ; Основные настройки ; |
| ; Документация http://www.xdebug.org/docs/basic ; | ; Документация http://www.xdebug.org/docs/basic ; | ||
| ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; | ||
| Строка 109: | Строка 101: | ||
| ; Сбор информации о переменных. | ; Сбор информации о переменных. | ||
| - | ; Данный параметр имеет смысл только если планируется использование функции | + | ; Данный параметр имеет смысл только если планируется использование функции |
| ; xdebug_get_declared_vars(). | ; xdebug_get_declared_vars(). | ||
| ; Анализ может быть довольно медленным! | ; Анализ может быть довольно медленным! | ||
| Строка 119: | Строка 111: | ||
| ; Отображение суперглобальных данных. | ; Отображение суперглобальных данных. | ||
| - | ; Данный параметр отвечает за отображение определенных данных из суперглобальных | + | ; Данный параметр отвечает за отображение определенных данных из суперглобальных |
| ; переменных при возникновении ошибки. | ; переменных при возникновении ошибки. | ||
| ; | ; | ||
| Строка 126: | Строка 118: | ||
| ; Документация http://www.xdebug.org/docs/all_settings#dump.* | ; Документация http://www.xdebug.org/docs/all_settings#dump.* | ||
| ; Возможные варианты: | ; Возможные варианты: | ||
| - | ; xdebug.dump.COOKIE = | + | ; xdebug.dump.COOKIE = |
| - | ; xdebug.dump.FILES = | + | ; xdebug.dump.FILES = |
| - | ; xdebug.dump.GET = | + | ; xdebug.dump.GET = |
| - | ; xdebug.dump.POST = | + | ; xdebug.dump.POST = |
| - | ; xdebug.dump.REQUEST = | + | ; xdebug.dump.REQUEST = |
| - | ; xdebug.dump.SERVER = | + | ; xdebug.dump.SERVER = |
| - | ; xdebug.dump.SESSION = | + | ; xdebug.dump.SESSION = |
| ; Возможные значения: | ; Возможные значения: | ||
| ; * - отображать всё (xdebug.dump.REQUEST = *) | ; * - отображать всё (xdebug.dump.REQUEST = *) | ||
| - | ; 'key1, ...' - отображать определенные значение | + | ; 'key1, ...' - отображать определенные значение |
| ; (xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD) | ; (xdebug.dump.SERVER = REMOTE_ADDR,REQUEST_METHOD) | ||
| xdebug.dump.REQUEST = * | xdebug.dump.REQUEST = * | ||
| Строка 150: | Строка 142: | ||
| ; Вывод информации, собранной из суперглобальных массивов при каждой ошибке. | ; Вывод информации, собранной из суперглобальных массивов при каждой ошибке. | ||
| - | ; Обычно суперглобальные массивы остаются неизменными на протяжении всего скрипта, | + | ; Обычно суперглобальные массивы остаются неизменными на протяжении всего скрипта, |
| ; поэтому нет смысла при выводе каждой ошибки отображать эти данные повторно. | ; поэтому нет смысла при выводе каждой ошибки отображать эти данные повторно. | ||
| ; Если значение установлено в 0 - данные выводятся каждый раз. | ; Если значение установлено в 0 - данные выводятся каждый раз. | ||
| - | ; | + | ; |
| ; Тип boolean | ; Тип boolean | ||
| ; По умолчанию 1 | ; По умолчанию 1 | ||
| Строка 160: | Строка 152: | ||
| ; Вывод неопределенных значений суперглобальных массивов. | ; Вывод неопределенных значений суперглобальных массивов. | ||
| - | ; | + | ; |
| ; Тип boolean | ; Тип boolean | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 170: | Строка 162: | ||
| ; Для более детального изучения данного параметра обратитесь к документации. | ; Для более детального изучения данного параметра обратитесь к документации. | ||
| ; Введен в Xdebug 2.1 | ; Введен в Xdebug 2.1 | ||
| - | ; | + | ; |
| ; Тип string | ; Тип 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.file_link_format = |
| ; Формат ссылки на документацию для функций. | ; Формат ссылки на документацию для функций. | ||
| - | ; При нажатии на ссылку будет происходить переход по адресу, | + | ; При нажатии на ссылку будет происходить переход по адресу, |
| ; указанному в данном параметре + название функции. | ; указанному в данном параметре + название функции. | ||
| - | ; | + | ; |
| ; Тип string | ; Тип string | ||
| ; По умолчанию http://www.php.net | ; По умолчанию http://www.php.net | ||
| Строка 187: | Строка 179: | ||
| ; Вывод стека трассировки исключения. | ; Вывод стека трассировки исключения. | ||
| ; Действительно, даже если исключение было перехвачено. | ; Действительно, даже если исключение было перехвачено. | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 195: | Строка 187: | ||
| ; Вывод информации о переменных в текущей области видимости. | ; Вывод информации о переменных в текущей области видимости. | ||
| ; Может выводить очень много информации и поэтому по умолчанию отключен. | ; Может выводить очень много информации и поэтому по умолчанию отключен. | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 203: | Строка 195: | ||
| ; Запись различий в памяти между вызовами функции. | ; Запись различий в памяти между вызовами функции. | ||
| ; Записывает в файлах трассировки при установленном xdebug.trace_format = 0. | ; Записывает в файлах трассировки при установленном xdebug.trace_format = 0. | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 217: | Строка 209: | ||
| ; Включение трассировки функций автоматически. | ; Включение трассировки функций автоматически. | ||
| ; Делает возможным слежение в auto_prepend_file | ; Делает возможным слежение в auto_prepend_file | ||
| - | ; | + | ; |
| ; Тип boolean | ; Тип boolean | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 224: | Строка 216: | ||
| ; Добавление значений переменных в след. | ; Добавление значений переменных в след. | ||
| - | ; | + | ; |
| ; Тип boolean | ; Тип boolean | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 231: | Строка 223: | ||
| ; Добавление возвращаемых функциями значений в след. | ; Добавление возвращаемых функциями значений в след. | ||
| - | ; | + | ; |
| ; Тип boolean | ; Тип boolean | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 239: | Строка 231: | ||
| ; Формат файла трассировки. | ; Формат файла трассировки. | ||
| ; 0 - человеко-понятный, 1 - для обработки парсерами (программами для чтения) | ; 0 - человеко-понятный, 1 - для обработки парсерами (программами для чтения) | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 247: | Строка 239: | ||
| ; Определение порядка записи файла. | ; Определение порядка записи файла. | ||
| ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла | ; 0 - перезапись существующего файла, 1 - добавление новой записи в конец файла | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 254: | Строка 246: | ||
| ; Директория для сохранения файлов трассировки. | ; Директория для сохранения файлов трассировки. | ||
| - | ; | + | ; |
| ; Тип string | ; Тип string | ||
| ; По умолчанию /tmp | ; По умолчанию /tmp | ||
| Строка 273: | Строка 265: | ||
| ; %% символ % trace.%% trace.%%.xt | ; %% символ % trace.%% trace.%%.xt | ||
| ; *) Все символы отличные от букв латинского алфавита и цифр будут заменены на символ "_" | ; *) Все символы отличные от букв латинского алфавита и цифр будут заменены на символ "_" | ||
| - | ; | + | ; |
| ; Тип string | ; Тип string | ||
| ; По умолчанию trace.%c | ; По умолчанию trace.%c | ||
| Строка 286: | Строка 278: | ||
| ; Генерация расширенной информации, необходимой для точек останова удаленного отладчика. | ; Генерация расширенной информации, необходимой для точек останова удаленного отладчика. | ||
| - | ; При включении исполняемый код увеличивается примерно на 33%, | + | ; При включении исполняемый код увеличивается примерно на 33%, |
| ; что делает скрипт немного медленнее. | ; что делает скрипт немного медленнее. | ||
| ; | ; | ||
| Строка 304: | Строка 296: | ||
| ; Автоматический старт сеанса отладки без GET/POST запроса. | ; Автоматический старт сеанса отладки без GET/POST запроса. | ||
| ; Обычно для старта сессии необходим специальный GET/POST запрос. | ; Обычно для старта сессии необходим специальный GET/POST запрос. | ||
| - | ; Если значение установлено в 1, xDebug будет пытаться начать сеанс отладки | + | ; Если значение установлено в 1, xDebug будет пытаться начать сеанс отладки |
| ; и подключение к клиенту без GET/POST параметров. | ; и подключение к клиенту без GET/POST параметров. | ||
| ; | ; | ||
| Строка 382: | Строка 374: | ||
| ; Профилирование будет осуществляться при каждом запуске любого сценария. | ; Профилирование будет осуществляться при каждом запуске любого сценария. | ||
| ; Для более управляемого профилирования используйте установку xdebug.profiler_enable_trigger | ; Для более управляемого профилирования используйте установку xdebug.profiler_enable_trigger | ||
| - | ; | + | ; |
| ; Тип integer | ; Тип integer | ||
| ; По умолчанию 0 | ; По умолчанию 0 | ||
| Строка 390: | Строка 382: | ||
| ; Включения профилирования посредством специального GET/POST параметра. | ; Включения профилирования посредством специального GET/POST параметра. | ||
| ; Если значение установлено в 1, то при выполнении сценария с GET/POST | ; Если значение установлено в 1, то при выполнении сценария с GET/POST | ||
| - | ; параметром XDEBUG_PROFILE профилирование будет выполнено вне зависимости | + | ; параметром XDEBUG_PROFILE профилирование будет выполнено вне зависимости |
| ; от установки xdebug.profiler_enable. | ; от установки xdebug.profiler_enable. | ||
| ; Пример: http://www.example.com/?XDEBUG_PROFILE | ; Пример: http://www.example.com/?XDEBUG_PROFILE | ||
| Строка 408: | Строка 400: | ||
| ; Формат именования файлов профилирования. | ; Формат именования файлов профилирования. | ||
| ; См. xdebug.trace_output_name | ; См. xdebug.trace_output_name | ||
| - | ; | + | ; |
| ; Тип string | ; Тип string | ||
| ; По умолчанию cachegrind.out.%p | ; По умолчанию 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 | xdebug.profiler_output_name = cachegrind.out.%p | ||
| - | + | </code> | |
| - | </file>\\ | + | |
| - | В принципе это все доступные на данный момент задокументированные настройки xdebug 2.1.\\ | + | |
| - | Почти все из них можно переопределять непосредственно вызовом ini_set().\\ | + | |