Movable Typeユーザー・マニュアル: 設定ガイド

≪ 目次

• 設定ガイド

設定ガイド

Movable Typeの設定ファイルであるmt.cfgは、Movable Typeディレクトリ(.cgiスクリプトを格納しているディレクトリ)にあります。 以下は、mt.cfgで使用できる有効な設定オプションのリストです。各オプションの説明とデフォルト値を参照できます。 これらの説明はmt.cfgの中にも記載されています。

• CGIPath
  
• AdminCGIPath
  
Movable Typeは、CGIPathとAdminCGIPathの設定値を使ってMovable TypeのCGIスクリプトへのリンクを生成します。 たとえば、Movable Typeのタグ<$MTCGIPath$>はCGIPath の設定値に置き換えられます。 AdminCGIPathはmt.cgiへのリンクを生成するために使われ、CGIPathはその他すべてのCGIスクリプトへリンクを生成するために使われています。

AdminCGIPathは任意オプションです。 値を指定しないと、デフォルトでCGIPathの値になります。 mt.cgiを他のCGIスクリプトとは別のディレクトリに入れる場合や、SSLを有効にしたURLでmt.cgiを使いたい場合には、AdminCGIPathを利用してください。

デフォルト値： なし

例：

    CGIPath http://www.your-site.com/path/to/mt/
    AdminCGIPath https://www.your-site.com/path/to/mt/

• DataSource
  
Movable Typeのデータベース・ファイルが保存されているdbディレクトリまでのファイルシステム上のパスを指します。Berkeley DBのデータ・ストレージ・オプションを使用している場合を対象にしています。

デフォルト値： ./db

例：

    DataSource ./db

• StaticWebPath
  
Movable Typeのすべてのファイルをcgi-binディレクトリに入れた場合は、スタティック・ファイル(docs、images、styles.css、mt.js)を別の場所に保存して、ウェブサーバーで実行されないようにする必要があります。 詳細は「トラブルシューティング」のセクションを参照してください。

デフォルト値： なし

例：

    StaticWebPath /path/to/static-files/

• TemplatePath
  
tmplディレクトリまでのファイルシステム上のパスを指します。このディレクトリにはMovable Typeアプリケーションのフロントエンド・テンプレートが含まれています。

デフォルト値： ./tmpl

例：

    TemplatePath ./tmpl

• MailTransfer
  
sendmailではなくSMTPを使う場合は、MailTransferの設定値を”smtp”にしてください（下記参照）。 MailTransferで設定できる値: smtp、sendmail、およびdebug (デバッグ用にメール・メッセージを書き出す)

デフォルト値： sendmail

例：

    MailTransfer smtp

• SendMailPath
  
デフォルトでMovable Typeは、3つの場所（/usr/lib/sendmail、/usr/sbin/sendmail、/usr/ucblib/sendmail）でsendmailを探します。 sendmailが別の場所にある場合は、SendMailPathの設定を調整することができます。

デフォルト値： 3つの場所のいずれか

例：

    SendMailPath /usr/sbin/sendmail

• SMTPServer
  
SMTPサーバーのアドレスを示します。MailTransfer smtpと一緒に使います。

デフォルト値： localhost

例：

    SMTPServer smtp.your-site.com

• NoTempFiles
  
デフォルトでMovable Typeは、出力ファイル(たとえば、索引やアーカイブの1ページ)へ書き込むときに、最初はtempファイルにデータを書き出し、次にtempファイルの名前を変更します。 データを書き込むプロセスが突然停止した場合、この設定によってサイトからページが抹消されるのを防ぎます。 この設定ではディレクトリの権限を甘く設定する必要などがあるため、もしこの設定を望まない場合は、NoTempFiles を使ってこの設定をオフにすることもできます。

デフォルト値： 0

例：

    NoTempFiles 1

• WeblogsPingURL
  
XML-RPC weblogs.com pingを送信するときに使うURLを示します。

デフォルト値： http://rpc.weblogs.com/RPC2

例：

    WeblogsPingURL http://some.alternate.weblogs.com.server/path/

• BlogsPingURL
  
XML-RPC blo.gs pingを送信するときに使うURLを示します。

デフォルト値： http://ping.blo.gs/

例：

    BlogsPingURL http://some.alternate.blo.gs.server/path/

• MTPingURL
  
XML-RPC pingをmovabletype.orgに送信するときに使うURLを示します(Recently Updated Keyを持っている場合)。

デフォルト値： http://www.movabletype.jp/update/

例：

    MTPingURL http://some.alternate.movabletype.org.server/path/

• CGIMaxUpload
  
Movable Typeのアップロード機能を使ってファイルをアップロードする場合、サービス拒否攻撃を未然に防ぐために、アップロードできるファイル・サイズの上限を設定します。

デフォルト値： 1000000 (1MB)

例：

    CGIMaxUpload 500000

• DBUmask
  
• HTMLUmask
  
• UploadUmask
  
• DirUmask
  
Movable Typeは、ファイルとディレクトリの作成時に、umaskの設定値を使ってファイルのパーミッションを設定します。 cgiwrapとsuexec下で実行している場合、これらの設定はすべて0022の値にしてください。

デフォルト値： 0111 (DBUmask、HTMLUmask、UploadUmask)、0000 (DirUmask)

例：

    DBUmask 0022

• HTMLPerms
  
• UploadPerms
  
umaskの設定で権限を調整する方法のほかに、HTMLPermsとUploadPermsを使っても、システムで作成されたファイル(出力ファイルとアップロード・ファイルのいずれか)のデフォルトのパーミッションを設定できます。 実際にこの設定を使う場合は、システムが作成するファイルの実行ビットをオンにするときに限られます。たとえば、実行ビットをオンにする必要があるPHPファイルをMovable Typeが生成する場合は、HTMLPermsを0777に設定します。

デフォルト値： 0666

例：

    HTMLPerms 0777

• TempDir
  
ファイルをアップロードするとき、Movable Typeは同名のファイルを検出した場合、プロンプトを表示して確認してから、すでに存在するファイルを上書きするよう設定できます。 このために、Movable Typeはアップロードされたデータを一時ファイルとして書き込む必要があります。 その一時ファイルは、TempDirで指定したディレクトリに保存されます。

デフォルト値： /tmp

例：

    TempDir /tmp/

• EntriesPerRebuild
  
個々のアーカイブ（Individual Entry Archives）を再構築する際、Movable Typeは再構築のプロセスを一定数のエントリーずつに分けて、再構築します。 デフォルトでは、1回に付き40エントリーを再構築し、それが終わると次の40エントリーに取りかかります。 このエントリー数はEntriesPerRebuildで変更可能です。たとえば非常に安定したサーバーを使っている場合は、1回で全エントリーを処理した方が賢明でしょう。

デフォルト値： 40

例：

    EntriesPerRebuild 100

• ImportPath
  
importディレクトリまでのファイルシステムのパスを示します。このパスは、エントリーとコメントをシステムに読み込み（インポート）するときに使います。importは読み込まれたファイルを納めるディレクトリです。

デフォルト値： ./import

例：

    ImportPath ./import

• UseNFSSafeLocking
  
デフォルトでMovable Typeは、Perlのflock()機能を使って読み取り・書き込み時に、データベースをロックします。 NFSでマウントしたディレクトリを使っているシステムでは、Perlのflock() が機能しないことがあります。これは、perlのプログラムでflock(2)の代わりにfnctl(2)を使うと防止できる可能性がありますが、ロックが完全に機能することは保証されません。

したがってNFSを使っているシステムにおいてMovable Typeの実行に問題がある場合は、UseNFSSafeLockingディレクティブを使って、NFSでも効果のある、より簡素化されたファイル・ロックを使うことができます。

デフォルト値： 0 (NFS有効ロックを使わない)

例：

    UseNFSSafeLocking 1

• NoLocking
  
Windowsシステムによっては、flock()とlink()のどちらも備わっておらず、デフォルトのflock()ロックも、NFS有効ロックも使えないことがあります。 そのような場合にはNoLockingオプションをオンにすることができます。 ただし、このオプションの選択は、システムがほかのどの機能もサポートしない場合に限る必要があります。このオプションを使うと、データベースが破損する可能性が高まるので、最後の手段にしておくべきです。 たとえば個人用のサーバーを持っているなどで、一人でシステムを利用している場合には、これは大きな問題にならないはずです。

デフォルト値： 0 (ロック使用)

例：

    NoLocking 1

• NoHTMLEntities
  
デフォルトでMovable Typeは、PerlモジュールのHTML::Entitiesがインストールされていることを仮定し、このモジュールを使い、文字をHTMLエンティティにエンコードします。 しかし、たとえば、ポーランド語やロシア語のように異なる文字エンコードを使う言語の環境では、このモジュールをエンコードに使いたくない場合があります。 そのようなケースでは、NoHTMLEntitiesを1に設定します。

デフォルト値： 0 (HTML::Entitiesがある場合はそれを使用)

例：

    NoHTMLEntities 1

• NoCDATA
  
デフォルトでMovable Typeは、データをXMLにエンコードしているとき、あなたのデータにHTMLタグや、XMLに対し安全でないデータが含まれていないかどうかをチェックし、検出した場合は、データをCDATAタグで囲みます。 ただし、ニュース・アグリゲータの中には、CDATAを他のデータと一緒にすると、問題が生じることがあります。こうした問題がある場合は、NoCDATAを使って特殊文字をエンティティにエンコードすることができます。

デフォルト値： 0 (CDATAを使用)

例：

    NoCDATA 1

• PingTimeout
  
Movable Typeはpingの送信時に、それがトラックバックpingでも更新用pingでも、pingにタイムアウトを設定します。これはpingの返事を長時間待ち続けてシステムがフリーズするのを防ぐためです。 デフォルトの15秒を、PingTimeoutディレクティブで異なる値に変更できます。 値は秒単位です。

デフォルト値： 15

例：

    PingTimeout 5

• PingInterface
  
デフォルトでは送り出されるトラックバックpingと更新pingは、Movable Typeを実行しているサーバーのデフォルトのネットワーク・インタフェース・カード(NIC)を使って、インターネットに送られます。 あまり起きないケースですが、外向きのPingの通信を、別のNICやネットワーク接続で実現することが必要であったり望ましかったりする場合もあります。 こうした状況では、外向きのping通知を送信するために使うNICのIPアドレスを入力します。

このときIP address (xxx.xxx.xxx.xxx)だけを指定することも、IPアドレスとポート番号(xxx.xxx.xxx.xxx:#)を指定することもできます。 ポート番号が指定されなければ、外向きのpingは指定されたIPアドレスから、そのとき空いているポート番号を使って送信されます。 ポート番号が指定されれば、外向きのpingは、指定されたIPアドレスとそのポート番号を使って送信されます。 これは、外向きの接続をフィルタするファイアウォールに特定の発信元からのIP:portアドレスが必要な場合に役立ちます。

注： ポート番号は絶対に必要な場合を除き、指定しないでください。 指定されたポートが使用中であると、外向きのpingはエラー表示されないまま、送信に失敗します。

デフォルト値： なし

例：

    PingInterface 192.168.10.5
    PingInterface 192.168.10.5:8080

• PingProxy
  
Movable Typeを起動するコンピューターが、ファイアウォール内または内部の非公開ネットワークにある場合、プロキシ・サーバーがインターネット接続に必要になることがあります。 PingProxyをそのプロキシ･サーバーのURLアドレスに設定すると、Movable Typeは、指定したプロキシ・サーバーを経由して、すべてのトラックバックpingと更新pingを送信するようになります。

デフォルト値： なし

例：

    PingProxy http://192.168.10.5:3128

• PingNoProxy
  
上記のPingProxyを設定すると、Movable Typeは、PingNoProxyで指定したドメインへ送るpingを除き、トラックバックpingと更新pingを指定したプロキシ・サーバー経由で送信するようになります。

デフォルト値： localhost, 127.0.0.1

例：

    PingNoProxy internal.lan, example.tld

• ImageDriver
  
アップロードされた画像からサムネールを作るのに使う画像ツールキットを指定します。 デフォルトでは、ImageMagickライブラリとImage::MagickというPerlモジュールを使います。これらのツールがない場合は、NetPBMツールがシステムにインストールされていれば、代わりに使用できます。 設定値は、ImageMagickかNetPBMのいずれかです。

デフォルト値： ImageMagick

例：

    ImageDriver NetPBM

• NetPBMPath
  
デフォルトではMovable Typeは、3つの場所（/usr/local/netpbm/bin、/usr/local/bin、/usr/bin）でNetPBMツールを捜します。 NetPBMツールが別の場所にある場合は、NetPBMPathの設定を変更することができます。 パスは、NetPBMバイナリを含むディレクトリまでのパスにしてください。たとえば、pnmscaleバイナリが/home/foo/netpbm/bin/pnmscaleにある場合、NetPBMPathは/home/foo/netpbm/binにします。

デフォルト値： 3つの場所のいずれか

例：

    NetPBMPath /home/foo/netpbm/bin

• CommentScript
  
• TrackbackScript
  
• SearchScript
  
• XMLRPCScript
  
• ViewScript
  
デフォルトでは、Movable Typeがコメントに使うスクリプトはmt-comments.cgi、TrackBackのスクリプトはmt-tb.cgi、検索エンジンのスクリプトはmt-search.cgi、XML-RPCサーバーのスクリプトはmt-xmlrpc.cgi、そしてダイナミック・ウェブログ表示のスクリプトはmt-view.cgiとなっています。 たとえば、mod_perlを使ってMovable Typeを実行している場合、Perlスクリプトに.pl拡張子を要するサーバーを使っている場合など、状況によっては、デフォルトのスクリプト名がそのまま使えないこともあります。 このような状況ではこれらの設定値を変えると、デフォルト・テンプレートとMovable Typeのコードで広く使われるスクリプト名を変更できます。

デフォルト値： CommentScriptはmt-comments.cgi、TrackbackScriptはmt-tb.cgi、SearchScriptはmt-search.cgi、XMLRPCScriptはmt-xmlrpc.cgi、ViewScriptはmt-view.cgi

例：

    CommentScript comments
    TrackbackScript trackback
    SearchScript search
    XMLRPCScript xmlrpc
    ViewScript weblog

• PublishCharset
  
デフォルトでは、ユーザー・プロフィールで「表示する言語」に選んだ言語に対応する、HTTPヘッダーの文字エンコーディングを指します。 この設定を上書きしたいときは、PublishCharsetを、使用したい文字エンコーディングに設定します。 ただし変更すると、Movable Typeシステムを使うすべてのユーザーとすべてのウェブログの設定が変更されるので注意してください。 エンコーディングの一例はShift_JISです。

デフォルト値： 「表示する言語」に対応する文字エンコーディング

例：

    PublishCharset Shift_JIS

• SafeMode
  
「セーフ・モード」がオンになっていると、セキュリティなどの問題についての警告機能がオンになり、テンプレートを.cgiやその他の拡張子を持つファイルにリンクさせる機能などの小規模な機能がオフになります。 セーフ・モードはデフォルトではオンですが、SafeModeを0に設定すると、オフにできます。

デフォルト値： 1

例：

    SafeMode 0

• GlobalSanitizeSpec
  
デフォルトでMovable Typeは、閲覧者が投稿したすべてのデータを無害化（サニタイズ）します。 これは、サイトのセキュリティを脅かす可能性があるコード（HTMLその他）を削除することで実現します。 このサニタイズ機能は、一部のHTMLタグだけが機能するようにし、そのほかのタグや実行命令（たとえばPHPなど）はすべて取り除きます。 GlobalSanitizeSpecの設定では、有効にするHTMLタグおよび属性を指定します。

デフォルト値： a href,b,br/,p,strong,em,ul,li,blockquote

例：

    GlobalSanitizeSpec blockquote,div

• GenerateTrackBackRSS
  
デフォルトでMovable Typeは、各トラックバック・アイテム（エントリー、カテゴリーとも）に対してRSSフィードを自動的に作成･管理し、アイテムに関するトラックバックpingを一覧表示します。 これらのpingはローカル・アーカイブ・パスに保存されます。 この機能をオフにするには、GenerateTrackBackRSSを0にします。 デフォルト設定値は1で、各トラックバック・アイテムに対しRSSファイルを生成します。

デフォルト値： 1

例：

    GenerateTrackBackRSS 0

• ThrottleSeconds
  
Movable TypeはIPベースのコメント帯域制御の設定を使い、コメントを溢れさせる攻撃（1つのエントリーに多量のコメントを送りつけること）に対処しています。 ThrottleSecondsはサイトの閲覧者がコメントを投稿した後に、再投稿できない時間を秒数で指定します。 たとえば、アリスがある時刻にコメントを投稿したと仮定します。すると彼女は、その時刻からこの設定に指定されている秒数の間、同じIPアドレスから別のコメントを投稿することができなくなります。 あなたのウェブログに対しコメントを投稿する人が多くなければ、この設定を上げることができます。

この設定は、あるIPアドレスからウェブログへのコメント投稿を自動禁止するように設定するとき、その措置が取られるまでの秒数の設定にも使います。

デフォルト値： 20

例：

    ThrottleSeconds 60

• SearchTemplatePath
  
これは、検索テンプレートがあるsearch_templatesディレクトリまでのファイルシステム上のパスを指します。 デフォルトは./search_templatesで、これはsearch_templatesディレクトリがmt.cgiファイルと同じディレクトリにあることを意味します。この設定は、search_templatesディレクトリを移動した場合を除き、おそらく変更する必要がないでしょう。

デフォルト値： ./search_templates/

例：

    SearchTemplatePath /home/foo/my/search_templates/

• DefaultTemplate
  
これは、search_templatesディレクトリ（SearchTemplatePathディレクティブを参照）にあるデフォルトの検索テンプレートのファイル名を示します。 代替テンプレート（下記参照）を指定して使う場合は、このデフォルト・テンプレートを使う必要はありません。

デフォルト値： default.tmpl.

例：

    DefaultTemplate my-template.tmpl

• AltTemplate
  
複数のウェブログを設置しているか、いくつかの異なるバージョンのサイトを提供している場合は、代替テンプレートを使って異なるバージョンの検索結果を提供することが望ましい場合もあります。 詳細は、マニュアルの「代替テンプレート」を参照してください。 代替テンプレートは好きなだけ指定できます。

デフォルトでは以下の代替テンプレートが設定されています。

    AltTemplate comments comments.tmpl

これで「新しいコメント検索」のための代替テンプレートが設定できます。

例：

    AltTemplate work work.tmpl

• ExcludeBlogs
  
• IncludeBlogs
  
このIncludeBlogsとExcludeBlogsを使うと、あなたのサイトの検索に含まれるウェブログを制限できます。 IncludeBlogsは検索に含まれるウェブログを指定し、ExcludeBlogsは検索から外されるウェブログを指定します。 両方同時に使わないでください。ExcludeBlogsの内容は、IncludeBlogsの内容によって上書きされます。 デフォルトではすべてのウェブログを検索します。 ウェブログのIDをコンマで区切ります。

デフォルト値： なし

例：

    ExcludeBlogs 1,3,4
    IncludeBlogs 2

• RegexSearch
  
• CaseSearch
  
これらの設定は、サイトの検索についてのデフォルトを指定します。その値は、隠れたフォーム入力（hidden input）を通して、またはユーザーが指定したフォーム入力で、上書きできます。 これらの設定はデフォルトのままに残しておき、ユーザーが自在に変更できる状態にしておくのがよいでしょう。 RegexSearchは正規表現による検索で、CaseSearchは大文字と小文字を区別する検索です。

デフォルト値： 0 (両方ともに)

例：

    RegexSearch 1
    CaseSearch 1

• SearchCutoff
  
• CommentSearchCutoff
  
SearchCutoffは通常の検索において、CommentSearchCutoffは新しいコメントの検索において、デフォルトでさかのぼる検索日数を示します。

SearchCutoffのデフォルトはウェブログのはじめからの（全エントリーを対象とした）検索で、CommentSearchCutoffのデフォルトは、前月以降のコメントからの検索です。

例：

    SearchCutoff 7
    CommentSearchCutoff 7

• MaxResults
  
これは検索で返される結果の最大数を示します。 通常の検索の場合、結果数はウェブログひとつについての数を示します。たとえば、MaxResultsを5に設定すると、あなたのシステム上の各ウェブログは、最大5個までの検索結果が返されるようになります。 新しいコメント検索の場合、最大数は新しいコメントが付けられたエントリーの数になります。

デフォルト値： 上限なし（つまり検索結果がすべて表示されます）

例：

    MaxResults 5

• ResultDisplay
  
これは検索結果の並べ替えの順序を示します。 ascendを使うと、古い方から順にエントリーが表示され、descendを使うと、新しい方から順にエントリーが表示されます。

デフォルト値： descend

例：

    ResultDisplay ascend

• SearchSortBy
  
これは検索結果を並べ替えるとき、どの列を基準にするかを示します。 created_onは投稿日によってエントリーが並べ替えられ、titleはタイトルによって並べ替えられます。 この設定はResultDisplayを使うと、昇順または降順を指定できます。

デフォルト値： created_on

例：

    SearchSortBy title

• ExcerptWords
  
これは、検索結果の中で<$MTEntryExcerpt$>タグを使ったときに表示される概要の文字数を示します。 この設定は検索結果の概要に対して使われるもので、ウェブログ設定の「概要に載せる文字数」とは異なります。

デフォルト値： 40

例：

    ExcerptWords 100

• SearchElement
  
デフォルトでは検索はウェブログのエントリーに対して行われ、コメントに対しては行われません。 コメント検索は、検索対象のテキストが多いので、エントリー検索より時間がかかります。 この設定はentriesのままに残しておき、サイトの閲覧者が自在に変更できる状態にしておくのがよいでしょう。 有効な値は、entries、comments、またはboth（両方）のいずれかです。

デフォルト値： entries

例：

    SearchElement both

• NoOverride
  
デフォルトで検索エンジンは、上記の設定ディレクティブのほとんどを、検索テンプレートの設定で上書きできます。 また、ユーザーが検索文字列の値を変更することでも、これらの設定値を上書きできてしまいます。 特に個人的なウェブログを開設している場合は危険です。たとえ、IncludeBlogsとExcludeBlogsで検索対象のウェブログを制限しても、ユーザーによってその設定が上書きされ、あなたの私的なウェブログが検索されてしまう可能性があります。 NoOverrideを使うと、検索テンプレートやユーザーによる上書きを禁止する設定ディレクティブをコンマで区切って列挙できます。 このように指定しておくと、mt.cfgの設定だけが使われるようになります。

デフォルト値： なし

例：

    NoOverride IncludeBlogs,ExcludeBlogs

• EmailAddressMain
  
たとえば、新しいコメントが投稿されたときに、Movable Typeがメールを送信する場合、「送信者（From:）」にメールアドレスを入力する必要があります。 EmailAddressMainを設定すると、このメールアドレスを設定できます。 設定しない場合、Movable Typeはエントリーの投稿者を使いますが、これがスパム対策フィルターで問題になる可能性があります。
• LaunchBackgroundTasks
  
タスクの中には、デフォルトで、バックグラウンドで実行されているものもあります。 この仕組みによって、Movable Typeがたとえば再構築など重要なタスクを実行している間、ユーザーや別のソフトウエアはアプリケーションを継続して使うことができます。 ただしこの機能はホスティング環境によっては機能しないこともあります。 効果のない機能がある場合は、LaunchBackgroundTasks 0 を設定してみてください。
• RegKeyURL
  
これは、Movable Typeが公開鍵（承認リクエストの確認用）を取得する先のURLを示します。 公開鍵はSignOnPublicKeyによってローカルで上書きできます。
• SignOnPublicKey
  
コメント登録の承認情報を確認するために使うDSA公開鍵を示します。
• CommentSessionTimeout
  
登録されたコメント投稿者のセッションの期限が切れるまでの秒数を指定します。 デフォルトは1時間です。
• EmailVerificationSecret
  
mt-add-notify.cgiをユーザーに公開し、サイト更新通知のためユーザー登録を行っている場合は、これを外部者が推測できない値に設定してください。 この設定によって閲覧者はメールアドレスの認証を求められるので、Movable Typeの通知サインアップ・プロセスにおいてセキュリティが確保されます。