関数・クラス解説

debug_backtrace

version:PHP 4 >= 4.3.0, PHP 5, PHP 7 (公式)

バックトレースを生成する

公式リファレンス

書式

debug_backtrace ([ int $options = DEBUG_BACKTRACE_PROVIDE_OBJECT [, int $limit = 0 ]] ) : array

説明

debug_backtrace() は PHP バックトレースを生成します。

パラメータ

options
PHP 5.3.6 以降、このパラメータは次のオプションのビットマスクとなります。
debug_backtrace() のオプション
DEBUG_BACKTRACE_PROVIDE_OBJECT "object" インデックスを埋めるかどうか。
DEBUG_BACKTRACE_IGNORE_ARGS "args" インデックス、 すなわちすべての関数/メソッドの引数を省略してメモリを節約するかどうか。
5.3.6 より前のバージョンでは TRUE あるいは FALSE しか指定できませんでした。これは DEBUG_BACKTRACE_PROVIDE_OBJECT オプションを指定するかしないかを意味します。
limit
5.4.0 以降、このパラメータを使ってスタックフレームの数を制限できるようになりました。 デフォルト (limit=0) は、すべてのスタックフレームを返します。

返値

連想配列の配列を返します。連想配列の要素として返される可能性があるものは以下のとおりです。

debug_backtrace() から返される可能性がある要素
名前 説明
function string カレントの関数名。 __FUNCTION__ も参照してください。
line int カレントの行番号。 __LINE__ も参照してください。
file string カレントのファイル名。 __FILE__ も参照してください。
class string カレントのクラス名。 __CLASS__ も参照してください。
object object カレントのオブジェクト。
type string カレントのコール方式。メソッド呼び出しの場合は "->"、 静的なメソッド呼び出しの場合は "::" が返されます。 関数呼び出しの場合は何も返されません。
args array 関数の内部の場合、関数の引数のリストとなります。 インクルードされたファイル内では、 読み込まれたファイルの名前となります。

サンプル

例1 debug_backtrace() の例

// ファイル名: /tmp/a.php function a_test($str) {     echo "\nHi: $str";     var_dump(debug_backtrace()); } a_test('friend'); // ファイル名: /tmp/b.php include_once '/tmp/a.php';

/tmp/b.php を実行した際の結果は以下のようになります。

Hi: friend array(2) { [0]=> array(4) { ["file"] => string(10) "/tmp/a.php" ["line"] => int(10) ["function"] => string(6) "a_test" ["args"]=> array(1) { [0] => &string(6) "friend" } } [1]=> array(4) { ["file"] => string(10) "/tmp/b.php" ["line"] => int(2) ["args"] => array(1) { [0] => string(10) "/tmp/a.php" } ["function"] => string(12) "include_once" } }

参考

  • trigger_error() - ユーザーレベルのエラー/警告/通知メッセージを生成する
  • debug_print_backtrace() - バックトレースを表示する
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール