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プラグイン入門:MT::Author で実現するロール付与の手法
2025.03.26
本記事では、Movable Type のプラグイン開発において、MT::Author オブジェクトを利用したユーザーへのロール付与手法を詳しく解説します。具体的なコード例とともに、ユーザー、ブログ、ロールの各オブジェクトの取得方法や、add_role メソッドを活用したロール付与処理の流れを紹介。実務に直結する実装ポイントを分かりやすく解説しています。
Movable Typeプラグイン入門:MT::Authorを活用した新規ユーザー作成の実例解説
2025.03.21
本記事では、Movable Typeプラグインの実装において、MT::Authorオブジェクトを活用したユーザーの新規作成処理の具体例を解説します。コードサンプルを通して、ユーザーの存在確認から新規作成、各種プロパティの設定手順やログ出力まで、実践的なポイントを詳述しています。
Movable Typeプラグイン開発入門:第七回 Transformerプラグインで管理画面UIをカスタマイズする
2025.03.19
この記事では、Movable Type 管理画面の見た目を変更するために、Transformerプラグインで設定フォームをカスタマイズする方法を解説しています。具体的な文字列置換の実装例と、実運用時に考慮すべきポイントをわかりやすくまとめています。
Movable Typeプラグイン開発入門:第六回 ローカライゼーションの実装方法
2025.03.13
第六回では、Movable Typeプラグインのローカライゼーションに焦点を当て、多言語対応の具体的な手法を紹介します。多言語対応の実装方法を学び、プラグインの利用者層を広げましょう。