Skip to content

Latest commit

 

History

History
305 lines (225 loc) · 14.7 KB

debugging.rst

File metadata and controls

305 lines (225 loc) · 14.7 KB

デバッグ

デバッグはいかなる開発サイクルにおいても避けることのできない、必要なものです。 CakePHP は IDE やエディタと直接連携するようなツールは提供しませんが、CakePHP はデバッグ作業やあなたのアプリケーション内部で何が走っているのかを探る作業を助けるためのツールをいくつか提供します。

基本的なデバッグ

.. php:function:: debug(mixed $var, boolean $showHtml = null, $showFrom = true)

    :param mixed $var: 出力する内容。配列やオブジェクトを渡してもうまく動作します。
    :param boolean $showHTML: true をセットしたならエスケープが有効になります。2.0 では、ウェブリクエストを扱う場合にはデフォルトでエスケープが有効になります。
    :param boolean $showFrom: debug() がどのファイルのどの行で呼ばれたのかを表示します。

debug() 関数は PHP 関数の print_r() と同様に、グローバルに利用可能な関数です。debug() 関数により、さまざまな方法で変数の内容を出力することができます。 データを HTML に優しい方法で表示させたいなら、第２引数を true にしてください。この関数はまた、デフォルトで呼ばれた場所となるファイルと行番号も出力します。

この関数からの出力は、core の debug 変数が 0 より大きな値だった場合のみ行われます。

.. versionchanged:: 2.1
    ``debug()`` の出力は ``var_dump()`` のものと多くの点で似ており、内部的には :php:class:`Debugger` を使っています。

Debugger クラス

Debugger クラスは CakePHP 1.2 で導入され、デバッグ情報を取得するための数多くのオプションも、持っているものでした。 それには static に呼び出すいくつかの関数が存在し、ダンプ出力やログ出力、エラーをハンドルする関数を提供していました。

Debugger クラスは PHP のデフォルトのエラーハンドリングを上書き、より使いやすいエラーレポートをするものに置き換えます。 CakePHP ではデフォルトで Debugger クラスのエラーハンドリングが使われます。 すべてのデバッグ関数と同様に、Configure::debug が 0 より大きい値の場合のみ動作します。

エラーが発生したら、Debugger はページに情報を表示し、かつ、error.log ファイルに出力します。 生成されるエラーレポートにはスタックトレースとエラーが発生した部分のコード抜粋の両方が出力されます。 「Error」のリンクをクリックすると、スタックトレースが表示され、「Code」のリンクをクリックすると、エラーが発生した行が表示されます。

Debugger クラスの使用

.. php:class:: Debugger

Debugger を使用する際にはまず、Configure::read('debug') に 0 より大きな値がセットされていることを確認してください。

.. php:staticmethod:: Debugger::dump($var)

    dump は変数の内容を出力します。渡された変数のすべてのプロパティと（可能なら）メソッドを出力します::

        $foo = array(1,2,3);

        Debugger::dump($foo);

        // 出力
        array(
            1,
            2,
            3
        )

        // シンプルなオブジェクト
        $car = new Car();

        Debugger::dump($car);

        // 出力
        Car
        Car::colour = 'red'
        Car::make = 'Toyota'
        Car::model = 'Camry'
        Car::mileage = '15000'
        Car::accelerate()
        Car::decelerate()
        Car::stop()

    ..
      Dump prints out the contents of a variable. It will print out all
      properties and methods (if any) of the supplied variable::

    .. versionchanged:: 2.1
        2.1 以降、出力が読みやすいものに変更されました。:php:func:`Debugger::exportVar()` を参照してください。

    ..
      In 2.1 forward the output was updated for readability. See
      :php:func:`Debugger::exportVar()`


.. php:staticmethod:: Debugger::log($var, $level = 7)

    呼び出されたときに詳細なスタックトレースを生成します。
    log() メソッドは Debugger::dump() によるものと似たデータを出力しますが、出力バッファにではなく、 debug.log に出力します。
    log() が正常に動作するためには、あなたの app/tmp ディレクトリ（と、その中）はウェブサーバにより書き込み可能でなければならないことに気をつけてください。


.. php:staticmethod:: Debugger::trace($options)

    現在のスタックトレースを返します。トレースの各行には、呼び出しているメソッド、どこから呼ばれたかというファイルと行番号が含まれています::

        //PostsController::index() の中で
        pr(Debugger::trace());

        //出力
        PostsController::index() - APP/Controller/DownloadsController.php, line 48
        Dispatcher::_invoke() - CORE/lib/Cake/Routing/Dispatcher.php, line 265
        Dispatcher::dispatch() - CORE/lib/Cake/Routing/Dispatcher.php, line 237
        [main] - APP/webroot/index.php, line 84

    上記では、コントローラのアクション内で Debugger::trace() を呼ぶことで、スタックトレースを生成しています。
    スタックトレースは下から上へと読み、現在走っている関数（スタックフレーム）の順になっています。
    上記の例では、index.php が Dispatcher::dispatch() を呼び、それが今度は Dispatcher::\_invoke() を呼んでいます。
    その後、\_invoke() メソッドは PostsController::index() を呼んでいます。
    この情報は再帰呼出やスタックが深い場合に、trace() の時点でどの関数が現在走っているのか特定できるので、役に立ちます。


.. php:staticmethod:: Debugger::excerpt($path, $line, $context)

    $path （絶対パス） にあるファイルからの抜粋を取得します。$line 行目をハイライトし、$line 行目の前後 $context 行もあわせて取得します::

        pr(Debugger::excerpt(ROOT . DS . LIBS . 'debugger.php', 321, 2));

        //下記のように出力されます
        Array
        (
            [0] => <code><span style="color: #000000"> * @access public</span></code>
            [1] => <code><span style="color: #000000"> */</span></code>
            [2] => <code><span style="color: #000000">    function excerpt($file, $line, $context = 2) {</span></code>

            [3] => <span class="code-highlight"><code><span style="color: #000000">        $data = $lines = array();</span></code></span>
            [4] => <code><span style="color: #000000">        $data = @explode("\n", file_get_contents($file));</span></code>
        )

    このメソッドは内部的に使われているものですが、あなたが独自のエラーメッセージを生成する場合や独自の状況でログ出力する場合にも使いやすいものです。


.. php:staticmethod:: Debugger::exportVar($var, $recursion = 0)

    どんなタイプの変数でもデバッグ出力に使える文字列へと変換します。
    このメソッドはまた、多くの Debugger により内部変数を変換する際に使われているものです。あなた自身の Debugger でも使うことができるでしょう。

    .. versionchanged:: 2.1
        この関数は 2.1 以前とは異なる出力内容を生成します。

    ..
        This function generates different output in 2.1 forward.


.. php:staticmethod:: Debugger::invoke($debugger)

    CakePHP Debugger を新しいインスタンスに置き換えます。


.. php:staticmethod:: Debugger::getType($var)

    変数の型を取得します。オブジェクトならクラス名を返します。

    .. versionadded:: 2.1

ログ出力によるデバッグ

アプリケーションをデバッグするもう一つの良い方法はログメッセージです。 :php:class:`CakeLog` を使うことで、あなたのアプリケーションでログ出力をさせることができます。 :php:class:`Object` を継承するすべてのオブジェクトは、インスタンスメソッド log() を持っており、ログメッセージを出力するのに使えます:

$this->log('通ったよ', 'debug');

上記では 通ったよ がデバッグログに出力されます。 ログに出力することで、リダイレクトや複雑なループを含むメソッドをデバッグしやすくなるでしょう。 また、 :php:meth:`CakeLog::write()` を使うことで、ログメッセージを書きだすことも可能です。 このメソッドは CakeLog がロードされているなら static にあなたのアプリケーション内のどこからでも呼び出すことができるのです:

// app/Config/bootstrap.php の中で
App::uses('CakeLog', 'Log');

// あなたのアプリケーションのどこからでも
CakeLog::write('debug', '通ったよ');

Debug Kit

DebugKit は便利なデバッグツールをたくさん提供してくれるプラグインです。 まずは、レンダリングされた HTML 内にツールバーを表示して、あなたのアプリケーションや現在のリクエストについての情報を大量に提供してくれます。 GitHub の DebugKit からダウンロードが可能です。