Установка Xdebug

В данной статье рассмотрены несколько способов установки.

Прекомпилированным модулем

На официальном сайте Xdebug в правой части страницы вы найдете ссылки на уже скомпилированнные модули для Windows и на архив исходных кодов.

Для того чтобы установить скомпилированный модуль просто поместите его в какой либо каталог на машине, где установлен PHP и добавьте следующую строку в php.ini

zend_extension_ts="c:/php/modules/php_xdebug-4.4.1-2.0.2.dll"

Не забудьте изменить путь и имя файла. Убедитесь, что вы используете полный путь.

Установка расширения из PECL

Начиная с Xdebug 0.9.0 вы можете устанавливать расширение из PEAR/PECL. Это работает только с PEAR версии 0.9.1-dev или выше и на любой UNIX-подобной системе.

Установка из PEAR/PECL:

# pecl install xdebug

Но не забывайте, что вы должны добавить строку в ваш php.ini (не забывайте изменять имя файла и указывать правильный полный путь):

zend_extension="/usr/local/php/modules/xdebug.so"

Установка из исходников

Вы можете скачать исходники последнего стабильного релиза или получить их из CVS:

cvs -d :pserver:srmread@cvs.xdebug.org:/repository login
CVS password: srmread
cvs -d :pserver:srmread@cvs.xdebug.org:/repository co xdebug

Исполнив комманды выше вы получите последнюю разрабатываемую версию.

Компиляция

Вы можете компилировать Xdebug отдельно от PHP. Но заметьте, что вы должны иметь доступ к исполняемым скриптам 'phpize' и 'php-config'. Если в вашей системе не установлены phpize и php-config, вы должны установить php из исходных кодов (примечание переводчика: или установить пакет php-dev).

Если вы имеете доступ к phpize и php-config, следуйте дальнейшим инструкциям:

  • Распакуйте архив: tar -xzf xdebug-2.0.2.tgz . Заметьте, что вы не должны распаковывать его внутри дерева исходных текстов PHP.
  • cd xdebug-2.0.2
  • Запустите на исполнение phpize: phpize (или /path/to/phpize).
  • ./configure –enable-xdebug (или ./configure –enable-xdebug –with-php-config=/path/to/php-config)

Если вы получили сообщение об ошибке:

      ../configure: line 1960: syntax error near unexpected token
      `PHP_NEW_EXTENSION(xdebug,'
      ../configure: line 1960: `  PHP_NEW_EXTENSION(xdebug, xdebug.c
      xdebug_code_coverage.c xdebug_com.c xdebug_handler_gdb.c
      xdebug_handler_php3.c xdebug_handlers.c xdebug_llist.c xdebug_hash.c
      xdebug_profiler.c xdebug_superglobals.c xdebug_var.c usefulstuff.c,
      $ext_shared)'

Это значит, что версия установленного PHP не совместима с данной версией xdebug.

Так же вы можете увидеть такое сообщение:

      configure: line 1145: PHP_INIT_BUILD_SYSTEM: command not found
      configure: line 1151: syntax error near unexpected token `config.nice'
      configure: line 1151: `PHP_CONFIG_NICE(config.nice)'

Это значит, что вы должны обновить пакет autotools (autoconf, automake и libtool) или установить рабочие версии autoconf-2.13, automake-1.5 и libtool-1.4.3.

  • make
  • Скопируйте модуль xdebug в нужное вам место: cp modules/xdebug.so /to/wherever/you/want/it/

Конфигурация PHP для использования Xdebug

  • Добавьте следующую строку в php.ini:
zend_extension="/wherever/you/put/it/xdebug.so"

(для не «treaded» использования PHP, например CLI, CGI or Apache 1.3 module) или:

zend_extension_ts="/wherever/you/put/it/xdebug.so"

(для «threaded» использования PHP, например Apache 2 MPM-worker или ISAPI module). Note: In если вы компилировали PHP с опцией –enable-debug вы можете использовать zend_extension_debug=

  • Перезапустите ваш веб-сервер.
  • Создайте php-файл, вызывающий 'phpinfo()' Загрузите страницу в браузере и посмотрите информацию о модуле Xdebug. Если вы видите ее в после логотипа Zend, вы успешно установили и подключили модуль. Вы так же можете использовать 'php -m', если вы пользуетесь CLI-версией PHP.

Совместимость

Xdebug не будет работать совместно с Zend Optimizer или другими расширениями Zend (DBG,APD и т.д.), т.к. эти модули не совместимы. Мы работаем над проблемами совместимости, и конечно будем пытаться устранить их.

Последние изменения: %2010/%03/%22 %01:%Mar