Отладка PHP-кода с помощью FirePHP

 <?php require 'FirePHPCore/fb.php'; $specialHashes = array(); FB::group('Special Hashes'); for ($x = 0; $x < 5; $x++) { $specialHashes[$x] = sha1($x . 'somesalt'); FB::info($specialHashes[$x], "Hash #" . $x); } FB::groupEnd(); 

А теперь новый вывод:

Как видите, теперь есть возможность минимизировать группу, помеченную «Специальные хеши». FirePHP даже позволяет свернуть группу по умолчанию. Просто замените вызов group() и добавьте массив параметров следующим образом:

 FB::group('Special Hashes', array('Collapsed'=>true)); 

таблицы

FirePHP может отправлять табличные данные довольно легко. На самом деле, поскольку метод console.table() Firefox очень console.table() , данные отображаются прекрасно и их легко понять. (О, Chrome, пожалуйста, подтянись!) Для отправки данных таблицы в FirePHP используется массив столбцов. Однако первым элементом массива должны быть имена столбцов. Используя наш специальный пример хэшей, давайте запишем их в виде таблицы:

 <?php require 'FirePHPCore/fb.php'; $specialHashes = array(); for ($x = 0; $x < 5; $x++) { $specialHashes[] = array($x, sha1($x . 'somesalt')); } $headers = array('Hash #', 'Hash Value'); $logTable = array($headers) + $specialHashes; FB::table("Special Hashes", $logTable); 

Вы можете заметить одну вещь, которую я сделал немного по-другому — создание переменной $logTable . Поскольку первый элемент массива, отправляемый методу table (), должен быть меткой столбца, я создал временную переменную, чтобы выполнить эту задачу для меня. Я не хочу манипулировать массивом $specialHashes — это мои бизнес-данные. Метод table() принимает параметр Label, за которым следует массив столбцов.

Когда консоль загружает данные из FirePHP, таблица свернута. Для приведенного выше снимка экрана я щелкнул ярлык, чтобы отобразить данные.

Следы

Следы могут быть неоценимы при отладке кода PHP. Если вы хотите связать их с сообщением журнала, показывающим значение переменной в определенной точке кода, или вам нужна дополнительная информация из исключения, трассировка находится там, где она есть. Очень просто, вы можете вызвать трассировку в любом месте вашего PHP-кода с помощью FirePHP, как показано здесь:

 <?php require 'FirePHPCore/fb.php'; FB::trace('Simple Trace'); 

И вывод:

Когда вывод был отображен, я просто нажал на метку «Простой след», чтобы отобразить весь след. Этот пример очень прост и показывает, как легко его можно вставить в любой код.

Давайте сделаем пример немного более сложным (хотя, я сомневаюсь, что вы действительно захотите сделать такой код в своем проекте):

 <?php require 'FirePHPCore/fb.php'; function one() { echo "This is one.<br>"; two(); } function two() { echo "This is two!<br>"; FB::trace('Trace from function two.'); } one(); 

Здесь вызывается функция one() . Функция two() вызывается в последней строке функции. После того, как two() завершается, он выполняет вызов трассировки для FirePHP. Следующий снимок экрана показывает вывод Firefox:

… И это еще не все!

С помощью FirePHP вы можете сделать гораздо больше, чем приведенные выше примеры. Чтобы просмотреть дополнительную информацию об указании других параметров, настройке трассировок исключений и даже об использовании утверждений, посетите штаб-квартиру FirePHP .

Бонусный пример

Как и в большинстве статей, посвященных стилю введения, информация здесь была относительно общей, а примеры — умеренными. Нужен более подробный пример, чтобы убедить вас использовать FirePHP? Пошли:

 <?php try { $key = "user.{$userId}"; if (!SimpleCache::has($key)) { FB::info($key, 'Cache miss:'); $userService = new UserService(); $user = $userService->fetchById($userId); SimpleCache::set($key, $user); } $user = SimpleCache::get($key); } catch (Exception $e) { FB::error($e); Router::generate500(); } 

Этот простой пример кода построен для извлечения пользовательского объекта. Эта система использует некоторый тип кэширования и генерирует исключения, когда пользователь недоступен. При первом запуске этого кода пользователь не кэшируется, поэтому FirePHP отправляет информационное сообщение. Для идентификатора пользователя 5 следующий снимок экрана показывает вывод.

При втором запуске кода метод info() не вызывается, и сообщение не отправляется на консоль. Теперь давайте представим, что кеш стал недоступен. (Я мог бы создать код, чтобы он мог работать, если бы кеша не было, но это просто лишило бы всех удовольствия!) В случае, когда кеш больше не доступен, метод set() будет выбрасывать исключение. На экране появится сообщение об ошибке 500, согласно этому коду. Но я хотел бы видеть исключение и сразу отслеживать трассировку. Вот где появляется метод error() . Он может интерпретировать объект Exception и хорошо его регистрировать.

Резюме

Самый безопасный способ отладки вашего PHP-кода — использовать среду отладчика, настроенную в вашей IDE. Однако для более быстрой отладки, а также ведения журнала на уровне приложений FirePHP может сыграть важную роль.

Изображение через Fotolia