Movable Type CMSプラットフォーム Movable Type
ドキュメントサイト

Manualマニュアル

内部文字列のUTF8化と、エンコード / デコード処理

最終更新日: 2010.02.17

Movable Type 5 の内部文字列は、すべてutf8で処理されます。通常、ユーザーの入力文字列や、データベースへの入出力は、Movable Typeが適切にエンコードとデコードを行うので、プラグインで文字コードを意識する必要はありません。例えば、以下の箇所では Movable Type が自動的にエンコードとデコードをおこないます。

  • MT::Objectに保存されたデータのセーブとロード
  • データベースのクエリ
  • MT::FileMgr経由でのuploadモード以外でのファイル入出力 (MT::WeblogPublisherでのブログの再構築を含みます)
  • MT::Serializeを利用した Serializeと Unserialize (注意: Movable Type 5 では、バイナリ値が含まれているデータ構造をSerializeする事は出来ません。)
  • MT::App::printでのダイナミック出力

ただし、以下のようなケースでは、エンコードとデコード処理を明示的に行う必要があります。

  • 外部ネットワークと通信する場合
  • MT::FileMgrを利用しないファイル入出力
  • MT::Objectのblob型で宣言されたカラムに値を保存する場合

また、L10N用辞書などのソースコードで、コード内にutf8文字列を含む場合には、utf8プラグマを指定する等の対応を行ってください。
Movable Type 5.0 ではプラグインの後方互換性のため、L10N/*.pmファイルについて強制的にデコード処理を行っていますが、これはあくまで一時的な互換性確保のための処理であり、将来この機能は廃止される予定です。

サンプルコード

MTタグ ハンドラ

Movable Type が PublishCharset に応じて自動でエンコードをおこないます。

sub _hdlr_my_tag {
   my ( $ctx, $args ) = @_;
   my $obj = MT::Entry->load(
       $args->{id});
   my $data = $obj->text;

   # do something...

   # MT does encode based on the PublishCharset
   return $data;
}

Movable Type 5 以前では、プラグインでエンコードをする必要がありました。

 return MT::I18N::encode_text( $data, 'utf-8' );

外部のウェブサービスからデータを取得する

sub _hdlr_my_tag {
   my ( $ctx, $args ) = @_;
   my $data;

   # When to receive data from web services,
   # plugin should decode as UTF-8-flagged
   return Encode::decode_utf8( $data );
}

MT::FileMgrを使わずに外部ファイルに書き出す

sub _hdlr_output_file {
   my ( $entry ) = @_;

   # Plugin should encode
   my $charset = 'utf-8';
   my $title = Encode::encode($charset, $entry->title);

   my $fh;
   open $fh ">output.txt" or die;
   print $fh <<EOT;
<?xml version="1.0" ?>
<entry>$title</entry>
EOT
   close $fh;
   return 1;
}
目次