Movable Typeでデバッグモードを設定してmt.cgiの処理をトレースする方法
作成日:2025.03.03
Movable Typeのデバッグモードを活用して、mt.cgiの処理を詳細にログ出力する方法を紹介します。デバッグモードの設定方法や、各モードの詳細、セキュリティ上の注意点についても説明します。
Movable Type のプラグインを開発している時などに、mt.cgi がどういう処理を行なっているかトレースしたいケースは多々あるかと思います。
そんな時に便利なのが、MTのデバッグモードの設定です。デバッグモードを有効にすると、mt.cgi がどのような処理を行なっているかを詳細にログに出力してくれます。
デバッグモードの設定は、MTの管理画面から行なえます。
「システム」⇒「設定」⇒「全般」を開き、「デバッグモード」の項目に数値を入力して保存することで、デバッグモードが有効になります。
デバッグモードの数値は、以下の通りです。
- 1: デバッグメッセージを表示する
- 2: スタックトレースメッセージ
- 4: Data::ObjectDriver でどのようなクエリが発生したか
- 8: 構築に 1/4 秒以上かかったテンプレートのレポート
- 128: アップレベルのリクエスト/レスポンス情報の標準エラーへの出力
上記を組み合わせて利用します。
例えば、デバッグモードに7
を指定すると、デバッグメッセージを表示(1)と、スタックトレースメッセージ(2)と、Data::ObjectDriver で発生したクエリ(4)が出力されます。
参考: DebugMode - 環境変数リファレンス | CMSプラットフォーム Movable Type ドキュメントサイト
なお、デバッグメッセージは、MTの画面最下部に出力されます。

デバッグモードを無効にするには、「デバッグモード」の項目に0
を入力して保存します。
デバッグモードを本番環境で使用する際は、セキュリティリスクに注意してください。デバッグメッセージには機密情報が含まれる可能性があるため、デバッグモードは開発環境でのみ使用することを推奨します。

奈良市を拠点に、25年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
Movable Typeプラグイン開発入門:第六回 ローカライゼーションの実装方法
2025.03.13
第六回では、Movable Typeプラグインのローカライゼーションに焦点を当て、多言語対応の具体的な手法を紹介します。多言語対応の実装方法を学び、プラグインの利用者層を広げましょう。
Movable Typeプラグイン開発入門:第五回 独立CGIスクリプトで設定表示機能を実装
2025.03.08
第五回の記事では、前回までの連載内容を踏まえて、設定表示機能を別CGIスクリプトとして実装する方法を詳しく解説します。Perlモジュールの修正手順やCGIスクリプトの構成、動作確認のポイントを具体例とともに紹介します。
Movable Typeプラグイン開発入門:第四回 管理画面へのモード追加と設定表示の実装
2025.03.07
第四回目の連載記事では、Movable Typeの管理画面に新たな機能を追加する方法として、モード定義を使った設定画面の実装を紹介します。前回記事との連携と、Perlモジュールでの設定値取得手法について分かりやすく解説します。
Movable Typeプラグイン開発入門:第三回 管理画面サイドメニューの変更と追加方法
2025.03.06
第三回の記事では、Movable Type管理画面のサイドメニューの変更・追加方法について解説します。既存メニューの名称変更から新規子メニュー・新規メニューの追加まで、具体的なYAML設定例をもとに詳しく紹介します。