MODxをダウンロード

http://modxcms-jp.com/news/178.htmlからmodx-1.0.4J.zipをローカルにダウンロードして、ダウンロードしたzipデータをダブルクリックして展開。

インストールに必要なデータをアップロードする

展開して出来たフォルダ内の以下のフォルダ、ファイル群をMODxをインストールしたいサーバ領域にアップロード。

• assets(フォルダ)
• ht.access(ファイル)
• index-ajax.php(ファイル)
• index.php(ファイル)
• install(フォルダ)
• manager(フォルダ)
• sample-robots.txt(ファイル)

インストール開始

アップロードしたWeb領域（ドメイン名/_modx/）にブラウザでアクセスすると以下の画面が表示される。「はい」をクリックしてインストール開始。

新規にインストールするので、デフォルトのまま「新規インストール」をチェックした状態でインストールを進める。

データベースの設定をする

データベースの設定をする。データベースホスト名にはさくらでいう「データベースサーバ」部分を入力し、データベース接続ログイン名は「データベースユーザ名」部分を入力。データベース接続パスワードには「データベース接続パスワード」を入力。

ここをクリックして接続テストを行ってください。というリンクテキストをクリックすると、実際にデータベース側とコンタクトがとれるかどうかを確認することができる。問題がない場合は緑色の文字で「接続できます」と表示される。

でも、このままだと「データベース名」部分がデフォルト値の「modx」のままで、これだと実際にさくらで既に作成済みのデータベース情報と異なるので、この部分（データベース名）を実際のデータベース名に変更する。

Tableプリフィクスの設定により、既存のテーブルと衝突することなく、MODx用のデータベーステーブルを用意することができる。

ここをクリックして、データベースのテストを行ってください。というリンクテキストをクリックして、確認をすることができる。やってみると

… データベースとのマッチング: 問題があります – データベース側の照合順序のデフォルト値が「ujis_japanese_ci」になっています。phpMyAdminが利用できる場合は、該当データベースの「操作」タブで照合順序のデフォルト値を変更してください。

となったので、さくらのサーバコントロールパネルからphpmyadminにアクセスして該当するデータベース（スタンダードプランではデータベースはひとつだけ利用可能）を選択した上で「操作」タブから「照合順序」を「utf8_general_ci」に変更する。（セレクトメニューからutf8_general_ciを選んで「実行する」をクリック）

これで

… データベースとのマッチング: 問題ありません

となったので、インストールを続ける。

管理アカウントの初期設定をする

管理画面で使用する言語のところでEUC-JPを選択すると文字化けするものがあるということが書かれているので、デフォルトのままJapanese-utf8でインストールを続ける。

インストールオプションの選択

デフォルトで各項目（サンプルサイト以外すべて）すべてにチェックが入った状態で「インストール」を実行。

インストール前の確認

オールグリーンで問題なし状態を確認し、一番下のGPL2ライセンスに同意（チェックボックスをチェック状態にする）すると「インストール」ボタンが出現するので、これをクリック。

インストール完了

「インストールは無事に成功しました。」というメッセージを確認して「インストール終了」ボタンをクリック。

これでインストールは終了。

インストール直後の画面（MODxをインストールしたディレクトリ/modx/）にブラウザでアクセスすると、こんな感じ。

.htaccessでRedirect（リダイレクト）

showzine.info/days/というディレクトリを作成し、このディレクトリにshowzine.infoのサブドメインdaysを割り当てる。

この段階ではサブドメインでのURLとルートドメインからディレクトリへのパスの二つのURLで同一のページにアクセスできてしまう。

• http://days.showzine.info/
• http://showzine.info/days/

これはコンテンツがカニバる（共食い）ことになり、SEOの観点からいってよろしくない。異なるURLで内容が同じということが。

なので、正規のURL（この場合はサブドメイン）でのみアクセス可能なように.htaccessでリダイレクト処理をする。借りているレンタルサーバのWebルート/showzine/days/へリダイレクト処理をするので、内容は以下のようになる。

/www/showzine/.htaccess
[shell]
Redirect /days/ “http://days.showzine.info/”
[/shell]

wwwのありなしを301リダイレクトで統一

このままだとwwwのありもなしも、どちらでもアクセスできてしまい、これまたSEOの観点からはよろしくないらしいので、これもどちらかに統一する。今回はwwwなしで。

自分が利用しているさくらインターネットでは「マルチドメインとして使用する」がデフォルトの設定で推奨となっている。（wwwあり、なし、どちらも使えるということ）この設定のまま、以下の記述を/.htaccessに記述する。（パーミッションは644で）

/www/.htaccess
[shell]
RewriteEngine on
RewriteCond %{HTTP_HOST} ^www¥.days¥.showzine¥.info
RewriteRule (.*) http://days.showzine.info/$1 [R=301,L]
[/shell]

リダイレクト処理が効かない場合はさくらのサーバコントロールパネル「運用に便利なツール > ファイルマネージャー」から.htaccessを編集してみる。phpなどのプログラムファイルは文字コードEUC-JPだけど.htaccessはJISらしいということが、ここで分かった。

wwwありで統一したい場合は

[shell]
RewriteEngine on
RewriteCond %{HTTP_HOST} ^days\.showzine\.info
RewriteRule (.*) http://www.days.showzine.info/$1 [R=301,L]
[/shell]

robots.txtでクローラのアクセス制限

つづいて、これもコンテンツがカニバるのを防ぐためにrobots.txtを配置する。

前述の処理で

• http://days.showzine.info/sample.html
• http://showzine.info/days/sample.html

このふたつは同じものだけれども、正規のURLである後者でのみブラウザからアクセスできるようになった。

しかし、クローラに対してはアクセスを全て許可（これがデフォルト）しているので、このままだとどちらも同じ内容なのに別ページ（URLが異なるので）としてインデックスされてしまい、コンテンツの共食いが起きてしまう。（らしい）

このままだと、これまたSEOの観点からよろしくないので、クローラに対しても正規のURLでのみアクセスを許可し、インデックスしてもらうようにクローラに対してのアクセス制御をrotobs.txtで実行する。

robots.txtはサイトのルート（最上位）に置くこと。レンタルサーバで複数ディレクトリを用意し、個別にドメインを割り当てている場合でも、その最上位のWebルートディレクトリ（/）に置くこと。そして、アクセス制限をするディレクトリの指定はWebルート（/www/）からとなる。

自分の場合、レンタルサーバのWebルートには別のドメイン（例えばhogehoge.com）が割り当てられていて、その中にshowzine/やshowzine/days/がある（マルチドメインやサブドメイン割り当て）ので、hogehoge.com/showzine/やhogehoge.com/showzine/days/というURLでアクセス（インデックス）されないように、hogehoge.comから辿った場合のshowzineディレクトリ（内包するディレクトリ含む）にアクセス制限をするため、記述は以下のようになる。

/www/robots.txt
[shell]
User-agent: *
Disallow: /showzine/
Allow: /
[/shell]

これでクローラに対しても

http://days.showzine.info/sample.htmlへのアクセスだけが許可され、http://showzine.info/days/sample.htmlへのアクセスはブロックされるようになった。

ちなみに、robots.txtはあくまでもクローラのアクセスを制限したい場合にのみ設置する必要があり、そうでない場合は設置する必要はない。詳しくはGoogleの解説記事「robots.txt ファイルを使用してページをブロックまたは削除する」を参照のこと。

> robots.txt ファイルが必要となるのは、
> サイトに検索エンジンのインデックスに登録したくないコンテンツが
> 含まれる場合のみです。サイトのすべてのコンテンツを検索エンジンの
> インデックスに登録したい場合は、
> 空であっても robots.txt ファイルは必要ありません。

test.csv
[shell]
かいきいわい,ka,快気祝い,病気の全快を祝うこと。
がいろじゅ,ka,街路樹,道路に沿って植え連ねた樹木。
あいことば,a,合い言葉,味方同士であらかじめ決めてある合図の言葉。
[/shell]

ちょろっと検索するとfgetcsv()関数を使ったやり方が一般的らしくてけっこう出てくるんだけど（実際にそれが一般的なのかは知らない）要素にマルチバイト文字（日本語）が入っていると、これが出力されない（空白）ことが判明。ダブルクォートでそのマルチバイト文字列だけ囲めば大丈夫なことが分かったけど、これは実際の運用においては実用的ではない。（と、オレは思う）

fputcsv()関数というのもあって、これは必要に応じて文字列をダブルクォートで囲ってくれたりして、なかなか便利そうではあるのだけれども、これも文字コードの指定ができないとか、欠点があるらしい。

なので、fopen()関数でCSVデータを開いてとか、最後にfclose()関数で閉じてとか、そういうのを一切しないで、CSVデータ（test.csv）を定数として定義した上で配列としてその内容を格納、それをfor文やforeach文で出力するだけにしてみた。これならマルチバイト文字だけダブルクォートで囲む必要もないので。

まずfor文を使った場合。

[php]
// 用意したCSVデータを定数csvdataとして定義
define(csvdata, "test.csv");

// csvdataの内容をfile()関数を使って配列として$dataに格納
$data = file(csvdata);

for($i = 0; $i < count($data); $i++){
echo $data[$i]."
“;
}
[/php]

つづいてforeach文を使った場合。

[php]
// 用意したCSVデータを定数csvdataとして定義
define(csvdata, "test.csv");

// csvdataの内容をfile()関数を使って配列として$dataに格納
$data = file(csvdata);

// foreachで配列$dataの各要素をループ処理して出力
foreach($data as $value){
echo $value."
“;
}
[/php]

どちらも出力結果は同じ。でも、若干foreach文のほうがシンプルでスッキリしているし、なんかfor文よりも処理速度も速いらしいので（といってもこのサンプルレベルでは関係ないだろうけど）使えるときはこっちのforeach文を積極的に使うことにした。

• 配列の形で用意したデータをCSV形式にして保存する
• 配列の形で用意したデータをCSV形式にしてダウンロード

まず最初の「CSV形式にして保存する」やつからやってみる。

作業の流れと内容。

• データを保存するためのCSVファイル（test.csv）を空で用意しておく
• CSVデータを作成する
• CSVファイルを追記モードで開く
• CSVファイルをロック
• CSVファイルを初期化して中身を空にする（既存の内容に追記していく場合は不要）
• 作成したCSVデータをCSVファイルに書き込む
• CSVファイルを閉じる

データを保存するためのCSVファイル（test.csv）を用意したら、CSVデータを作成したり、その内容をCSVファイルに書き込んだりするphpスクリプトを作成する。（csvtest.php）

csvtest.php
[php]
// CSVファイル名の設定
$csvdata = "test.csv";

// CSVデータの初期化
$csv = "";

// CSVデータの内容
// 配列$dataにデータを格納していく
$data[0] = array("月曜日", "Monday");
$data[1] = array("火曜日", "Tuesday");
$data[2] = array("水曜日", "Wednesday");
$data[3] = array("木曜日", "Thursday");
$data[4] = array("金曜日", "Friday");
$data[5] = array("土曜日", "Saturday");
$data[6] = array("日曜日", "Sunday");

// CSVデータの作成
// 配列$dataのkey[$key]と内容[$value]を取得してforeach文でループ処理
foreach($data as $key => $value){

$csv .= $key . “,”; // CSVデータにkey名と区切り文字カンマを追加
$csv .= $value[0] . “,”; // CSVデータに配列$dataの要素[0]（曜日の日本語）と区切り文字カンマを追加
$csv .= $value[1] . “\n”; // CSVデータに配列$dataの要素[1]（曜日の英語）を追加（末尾なので改行も一緒に追加）

}

// CSVファイルを追記モードで開く
$fp = fopen($csvdata, ‘ab’);

// CSVファイルを排他ロックする
flock($fp, LOCK_EX);

// CSVファイルの中身を空にする
// 既存の内容に追記していく場合は不要
ftruncate($fp, 0);

// CSVデータ$csvの内容をファイルに書き込む
fwrite($fp, $csv);

// CSVファイルを閉じる
fclose($fp);

// 完了メッセージを出力する
echo(“CSVデータの書き込みに成功しました！”);
[/php]

ブラウザでこのphpスクリプトファイルにアクセス。

CSVデータがCSVファイルに無事に書き込まれるとブラウザに「CSVデータの書き込みに成功しました！」と表示される。test.csvを開いてみれば、実際にデータが書き込まれていることを確認することが出来る。

test.csvのパーミッションが適切に設定されていないとPermission deniedでデータをファイルに書き込めない。この場合はパーミッションの設定を書き込み可能に設定すること。

この例では、作成したCSVデータをサーバ上でCSVファイルに保存した。

つぎは、サーバ上に保存ではなく、このCSVデータの内容をそのままCSVファイルとしてローカルにダウンロードする場合のスクリプト。

csvtest2.php
[php]
// CSVファイル名の設定
$csvdata = "test.csv";

// CSVデータの初期化
$csv = "";

// CSVファイルに書き出すCSVデータの内容
// 配列$dataにデータを格納していく
$data[0] = array("月曜日", "Monday");
$data[1] = array("火曜日", "Tuesday");
$data[2] = array("水曜日", "Wednesday");
$data[3] = array("木曜日", "Thursday");
$data[4] = array("金曜日", "Friday");
$data[5] = array("土曜日", "Saturday");
$data[6] = array("日曜日", "Sunday");

// CSVデータの作成
// 配列$dataのkey[$key]と内容[$value]を取得してforeach文でループ処理
foreach($data as $key => $value){

$csv .= $key . “,”; // CSVデータにkey名と区切り文字カンマを追加
$csv .= $value[0] . “,”; // CSVデータに配列$dataの要素[0]（曜日の日本語）と区切り文字カンマを追加
$csv .= $value[1] . “\n”; // CSVデータに配列$dataの要素[1]（曜日の英語）を追加（末尾なので改行も一緒に追加）

}

// MIMEタイプを設定する
header(“Content-Type: application/octet-stream”);

// ダウンロードする際にファイル名を表示する
header(“Content-Disposition: attachment; filename=$csvdata”);

// CSVデータを出力する
echo($csv);
[/php]

ブラウザでこのcsvtest2.phpにアクセスしてみるとtest.csvを保存するかどうするかの確認ウィンドウが表示されるので、ここで「ファイルを保存」を実行。ローカルに保存されたこのファイルの内容を確認してみる。

自宅のOSX環境にはMicrosoftのExelは入っていないので、Googleドキュメントでスプレッドシートとして読み込んで、その内容を確認してみる。

CSVデータとして内容を無事に確認できた。

Tech[Friday]さん、参考にさせてもらいました。
ありがとうございました。

適用したいディレクトリに以下の記述をした.htaccessを置くだけ。
これでsample.html内にとか記述しても
ちゃんと「hello」が出力される。（phpが動くようになる）

[shell]
AddHandler application/x-httpd-php .php .html
[/shell]

環境によっては次の記述でないとダメな場合も。
（違いとか、詳しくはよく分からない）

[shell]
AddType application/x-httpd-php .php .html
[/shell]

自分が最近メインでグイグイと使っているさくらインターネットでは
上記のように簡単には出来ないらしく、ちょいと工夫が必要らしい。

まだ試してないけど、解説している記事があったのでこれもいちおう残しておく。
さくらサーバーで.htmlをphpとして動かす

今回なんでこんなことを調べる必要があったかというと、近々着手する中規模のサイトのリニューアルにからんで、phpは使いたいけど拡張子はhtmlのまま変えたくないというのがあったから。新規サイトならともかく、リニューアルなので、これまでのバックリンクやインデックス状況を失うわけにはいかない。（検索エンジンにしてみれば、拡張子が異なれば、もうそれは別ページとなってしまう）

そのへんについては以下の記事が詳しかったので、これも参考にさせてもらいました。
.htaccess で、拡張子.htmlのままPHPを実行する方法

hogehoge/にサブドメインを付与し、ルートドメインからのディレクトリパスではなく、サブドメインでのURLでのみアクセスさせたいような場合なんかも。

• http://hogehoge.sample.com/
• http://sample.com/hogehoge/

↑前者でのみアクセスさせたいのでhogehoge/にリダイレクト処理を施す。

Webルートから見た場合のhogehoge/に対してリダイレクト処理をしたいので、/www/.htaccessに以下のように記述する。

/www/.htaccess
[shell]
Redirect /hogehoge/ “http://hogehoge.sample.com/”
[/shell]

たとえば

• http://www.days.showzine.info
• http://days.showzine.info

このURLを例として、wwwのありなしを統一してみる。今回はwwwなしで。

さくらインターネットでは「マルチドメインとして使用する」がデフォルトの設定で推奨となっている。（wwwあり、なし、どちらも使えるということ）この設定のまま、以下の記述を/.htaccessに記述する。（パーミッションは644で）

/www/.htaccess
[shell]
RewriteEngine on
RewriteCond %{HTTP_HOST} ^www¥.days¥.showzine¥.info
RewriteRule (.*) http://days.showzine.info/$1 [R=301,L]
[/shell]

リダイレクト処理が効かない場合はさくらのサーバコントロールパネル「運用に便利なツール > ファイルマネージャー」から.htaccessを編集してみる。phpなどのプログラムファイルは文字コードEUC-JPだけど.htaccessはJISだということが、ここで分かった。

wwwありで統一したい場合は

[shell]
RewriteEngine on
RewriteCond %{HTTP_HOST} ^days¥.showzine¥.info
RewriteRule (.*) http://www.days.showzine.info/$1 [R=301,L]
[/shell]

なので、こういう場合はrobots.txtでクローラのアクセスを制限して対処する。ただし、この設定はどんなクローラに対しても必ず有効ということではないらしい。（言うことをきかないクローラも存在するということ）

例として、showzine.info/days/というディレクトリにサブドメイン「days.showzine.info」を割り当てる。これによって以下の二つのURLで現状はアクセスが可能。

• http://days.showzine.info/sample.html
• http://showzine.info/days/sample.html

これを正規のURL（サブドメインのURLである前者）でのみ、クローラがアクセスできるようにrobots.txtを使って設定する。

robots.txtはサイトのルート（最上位）に置くこと。レンタルサーバで複数ディレクトリを用意し、個別にドメインを割り当てている場合でも、その最上位のWebルートディレクトリ（/）に置くこと。そして、アクセス制限をするディレクトリの指定はWebルート（/www/）からとなる。

自分の場合、レンタルサーバのWebルートには別のドメイン（例えばhogehoge.com）が割り当てられていて、その中にshowzine/やshowzine/days/がある（マルチドメインやサブドメイン割り当て）ので、hogehoge.com/showzine/やhogehoge.com/showzine/days/というURLでアクセス（インデックス）されないように、hogehoge.comから辿った場合のshowzineディレクトリ（内包するディレクトリ含む）にアクセス制限をするため、記述は以下のようになる。

/www/robots.txt
[shell]
User-agent: *
Disallow: /showzine/
Allow: /
[/shell]

これでクローラに対して

http://days.showzine.info/sample.htmlへのアクセスだけが許可され、http://showzine.info/days/sample.htmlへのアクセスはブロックされるようになった。

ちなみに、robots.txtはあくまでもクローラのアクセスを制限したい場合にのみ設置する必要があり、そうでない場合は設置する必要はない。詳しくはGoogleの解説記事を参照のこと。

robots.txt ファイルが必要となるのは、
サイトに検索エンジンのインデックスに登録したくないコンテンツが
含まれる場合のみです。サイトのすべてのコンテンツを検索エンジンの
インデックスに登録したい場合は、
空であってもrobots.txtファイルは必要ありません。

必要なものは.htaccessと.htpasswdの2ファイル。このふたつを/home/example/www/hoge/admin/ディレクトリに置く。パーミッションはどちらも644。

.htaccess（パーミッションは644）
[shell]
AuthUserFile /home/example/www/hoge/admin/.htpasswd
AuthType Basic
AuthName “Secret Area”
Require valid-user

deny from all

[/shell]

AuthUserFileはパスワードファイル（.htpasswd）の指定。
サーバのルートディレクトリから「フルパス」で指定しないといけない。
さくらインターネットなら/home/ユーザ名/www/ベーシック認証をかけるディレクトリ名/.htpasswdとなる。

.htpasswd（パーミッションは644）
[shell]
UserName1:PassWord1
UserName2:PassWord2
[/shell]

ユーザ名とパスワードはコロンで繋げる。複数ユーザを登録する場合は改行で記述していく。

パスワードは暗号化したほうがいいので.htaccessファイルを簡単に生成してくれるサービス「.htaccess Editor」を利用する。

「ベーシック認証」のところでユーザ名とパスワードを入力。「.htpasswdを作成」をクリックすると、ユーザ名と暗号化されたパスワードをコロンで繋いだ文字列が出力されるので、これを.htpasswdファイルにペースト。

これで自分で入力したユーザ名とパスワードによるベーシック認証が有効になる。

ディレクトリおよびファイルのパーミッション
705もしくは755
（これはphpとかも同じ）

ファイルの拡張子はcgi
sample.cgi

改行コードはLF
（ローカルからFTP等でアップロードする場合はASCIIモードで）

ファイルの文字エンコーディングはEUC-JP
（さくらのサーバの設定なのでこれもcgiとかに限らず）

以上に注意してサンプルを作成し、ブラウザでアクセスしてみた。

cgi/sample.cgi
[perl]
#!/usr/bin/perl

print “Hello”;

[/perl]

エラーになる。

500 Internal Server Error

エラーっつってもこれだけじゃ何が悪いのかわからん。

こんなに短いただのprint文で文法を間違えているとも思えないけど一応「perl -c ファイル名.cgi」をシェル上で実行してsyntaxの確認。

[shell]
%perl -c sample.cgi
sample.cgi syntax OK
[/shell]

問題なさそう。

そもそも何がいけないのか、その原因が知りたいので、Apacheのエラーログを見られないかどうか調べる。

直接ログファイルにはアクセスできないけど、さくらでは管理画面でエラーログの内容を見ることができるらしいことを知る。管理画面の左カラムにある「アプリケーションの設定」から「アクセスログの設定」を選び、遷移先ページのメインカラム真ん中へんにある「エラーログの表示」から「エラーログ」というリンク文字列をクリック。ここでエラーログの内容を知ることができる。（「最新の情報に更新」をクリックして、都度エラーログを確認できる）

エラーの内容は

Premature end of script headers:

だった。

これは何か特定の問題を示すエラーではないらしいんだけど、なんかしらの問題でちゃんと結果が出力されないときに出るものらしい。らしいがつづくけど。

とにかくエラーの内容が分かったので「Premature end of script headers:」で検索。

Premature end of script headersの解決法-超簡易版

この記事をひとつずつ確認し、終わりのほうにあった

[perl]
print “Content-type:text/html\n\n”
[/perl]

で解決。（お世話になりました。ありがとうございました。）

よくわかんないんだけど「Content-type: text/html」のあとに改行がふたつ（\n\n）あると解決できることがわかった。

以上を踏まえて以下のようにしたら、とりあえずエラーは出なくなり、Helloの文字列も表示されるようになった。

[perl]
#!/usr/bin/perl

print “Content-type:text/html\n\n”;
print “Hello”;
[/perl]

これだけだとあまりにも簡単すぎて不安なので、最近買った参考書にあったサンプルスクリプトを試してみる。

[perl]
#!/usr/bin/perl

print “Content-type:text/html\n\n”;

@words = (‘こんにちは’, ‘ハロー’, ‘ニイハオ’);
srand(time|$$);
$word = $words[rand(@words)];

print <<"EOL";



ようこそ
$word


EOL
[/perl]

大丈夫だった。

ちなみに、Content-typeの指定がなくて、ただ改行を冒頭で出力しているだけだと、エラーにはならないけどhtmlソースがそのまんま表示される。当然のことながら。

このサンプルでいうと、たとえば次のようにして「Content-type: text/html」部分をヒアドキュメントの中で出力してもいいみたい。（でも、Content-type: text/htmlの下に一行ブランクの行がないとだめだった。ブランクがないとこれはこれでまたエラーになる。やっぱり「改行がふたつ」必要なんだろうか、、よくわからんけど）

[perl]
!/usr/bin/perl

@words = (‘こんにちは’, ‘ハロー’, ‘ニイハオ’);
srand(time|$$);
$word = $words[rand(@words)];

print <<"EOL";
Content-type: text/html

ようこそ
$word


EOL
[/perl]

とりあえずこれで実行環境は用意できたので、明日からその参考書をグイグイやってperl、cgiに触れてみることにする。仮想マシンにインストールしてあるUbuntuでやろうかとも思ってたんだけど、ここで使えるようにセットアップするのは、それはそれでまた色々準備が必要のようなので、今回は見送り。