【毎度ありがとうメール for PayPal】　オンラインマニュアル
　インストール

動作環境

【毎度ありがとうメール for PayPal】はPHPバージョン7がインストールされているWebサーバーで動きます。確認はバージョン7.2.8で行っています。確かめてはいませんが、多くのレンタルサーバーで動くはずです。
管理画面はGoogle Chromeで動作確認しています。

対応している決済

PayPalの【ウェブペイメントスタンダード－購読と定期支払い】に対応しています。【ショッピングカート】や【今すぐ購入ボタン】などの他の決済には対応していません。
PayPal資金（残高）、PayPalを介したクレジットカード支払、デビットカード支払、銀行口座からの支払に対応しています。メールでの支払いなどには対応していません。

メール送信のタイミング

ここでは【https://sample.desu/ppmaido/】にインストールしているとします。
PayPalで購読と定期支払いを利用すると、登録、支払、解除といったアクションが起こります。

購読者がPayPalのボタンから【購読・定期支払い】の申し込みをします。
申し込みと同時に、PayPalから【https://sample.desu/ppmaido/backend.php】に購読者のデータが送信されます。
PayPalからデータを受け取った【https://sample.desu/ppmaido/backend.php】は、データが改ざんされていないか確認するため、送られてきたデータをPayPalに送り返し、結果を待ちます。
PayPalが正しいという結果を送り返してくれば、【毎度ありがとうメール for PayPal】に登録した【登録完了後に送信する】に設定したメールが購読者へ送信されます。
PayPalが正しくないという結果を送り返してくれば、処理は終了します。
購読者データがcsvファイルに保存されます。
試用期間1（PayPalでは試用期間）を設定し、かつ金額を設定している場合、試用期間1が始まると、PayPalから【https://sample.desu/ppmaido/backend.php】に決済のデータが送信されます。
PayPalからデータを受け取った【https://sample.desu/ppmaido/backend.php】は支払が正しく行われているか確認し、更にデータが改ざんされていないか確認するため、送られてきたデータをPayPalに送り返し、結果を待ちます。
PayPalから正しいという結果が送り返されてくれば、購読者が入力したメールアドレスに、【毎度ありがとうメール for PayPal】に登録した【試用期間1決済完了後送信するメール】に設定した内容でメールが送信されます。
ただし、試用期間の金額を無料にしている場合、決済が行われないので、PayPalからデータが送られてきません。そのためメール送信は行われません。
PayPalが正しくないという結果を送り返してくれば、処理は終了します。
決済データがcsvファイルに保存されます。
試用期間1（PayPalでは試用期間）終了後、試用期間2（PayPalでは別の試用期間）の設定をしている場合、試用期間2が始まるとPayPalが自動で決済を行います。同時にPayPalから【https://sample.desu/ppmaido/backend.php】にデータが送信されます。
PayPalからデータを受け取った【https://sample.desu/ppmaido/backend.php】は支払が正しく行われているか確認し、更にデータが改ざんされていないか確認するため、送られてきたデータをPayPalに送り返し、結果を待ちます。
PayPalから正しいという結果が送り返されてくれば、購読者が入力したメールアドレスに、【毎度ありがとうメール for PayPal】に登録した【試用期間2決済完了後送信するメール】に設定した内容でメールが送信されます。
ただし、試用期間の金額を無料にしている場合、決済が行われないので、PayPalからデータが送られてきません。そのためメール送信は行われません。
PayPalが正しくないという結果を送り返してくれば、処理は終了します。
正規支払（PayPalではサイクル）が始まると、PayPalが決済を自動で行います。同時にPayPalから【https://sample.desu/ppmaido/backend.php】にデータが送信されます。
PayPalからデータを受け取った【https://sample.desu/ppmaido/backend.php】は支払が正しく行われているか確認し、更にデータが改ざんされていないか確認するため、送られてきたデータをPayPalに送り返し、結果を待ちます。
PayPalから正しいという結果が送り返されてくれば、【毎度ありがとうメール for PayPal】ではデータの確認と正規支払に設定したメール送信と初めての正規支払に設定したメール送信（正規支払の第1回のみ）を行います。
PayPalが正しくないという結果を送り返してくれば、処理は終了します。
購読者が購読を解除するまで、設定した正規支払の期間に従ってPayPalが定期的に決済を行います。決済がある度にPayPalから【https://sample.desu/ppmaido/backend.php】にデータが送信されます。
【毎度ありがとうメール for PayPal】ではPayPalからデータが送られてくるたびにデータの確認と正規支払に設定したメール送信を行います。
購読者が購読を解除した場合、PayPalから【https://sample.desu/ppmaido/backend.php】にキャンセルのデータが送信されます。同時にPayPalから【https://sample.desu/ppmaido/backend.php】にデータが送信されます。
PayPalからデータを受け取った【https://sample.desu/ppmaido/backend.php】はデータが改ざんされていないか確認するため、送られてきたデータをPayPalに送り返し、結果を待ちます。
PayPalから正しいという結果が送り返されてくれば、【毎度ありがとうメール for PayPal】では【キャンセル時に送信するに設定したメールが購読者へ送信されます。

購入者ファイル

項目名	説明
商品ID	PayPalで入力した商品IDが保存されます。
商品名	PayPalで入力した商品名が保存されます。
姓	PayPal決済時に入力した名前が保存されます。
名	PayPal決済時に入力した名前が保存されます。
メールアドレス	PayPal決済時に入力したメールアドレスが保存されます。
注文ID	PayPalで発行された注文IDが保存されます。
親注文ID	決済された注文IDの親IDが保存されます。
支払額	購入者が支払った金額が保存されます。
ステータス	登録、試用1、試用2、通常、キャンセルのうち、いずれかが保存されます。
購入日時
PayPal発行ユーザー	PayPalが発行するユーザー管理ID、パスワードを利用する場合、保存されます。
PayPal発行パスワード	PayPalが発行するユーザー管理ID、パスワードを利用する場合、保存されます。

ネットワークのトラブルなどで、100%メールが送信されるとは限りません。
メールが送信されなかった場合の連絡先などを、決済前の画面や決済後の画面に必ず表示し、購入者が困らないようにしてください。

インストール前のPHP調査

PHPバージョンの確認

【毎度ありがとうメール for PayPal】は、PHPバージョン7で動作します。 PHPバージョン5でも動作しますが、PHPバージョン7で動かされることをお勧めします。
バージョン5で動かされる場合、バージョン5.4以下ではパスワードの暗号化保存ができませんので、バージョン5.5以上のご利用を強くお勧めします。
一度PHPのバージョンを5.5以上にした後は、PHPのバージョンを5.4以下にすることはできません。ログインできなくなります。

動いているPHPのバージョンが分からない場合は、次の方法で確認してください。

【毎度ありがとうメール for PayPal】をインストールするディレクトリを作成します。
作成したディレクトリに付属の【phpinfo.php】をアップロードします。
ブラウザからアクセスします。
【PHP Version】の項目です。7.x.xx（xは任意の数字）ならバージョン7です。

サーバーによっては、ディレクトリごとにバージョンを切り替えることもできます。
バージョン7以外のPHPでプログラミングされた他のソフトウェアを動かしておられる場合は、ディレクトリごとにバージョンを切り替えられるかどうか、お使いのサーバーのマニュアルをご覧いただくか、サーバー管理会社に問い合わせてください。

PHPモードの確認

【毎度ありがとうメール for PayPal】は、PHPがセーフモードでも動作はします。しかし機能に制限が出てきます。
PHP配布元が言っているように、PHPのセーフモードは非推奨です。通常モードで動かすことをお勧めします。
特にロリポップをお使いの場合はご注意ください。デフォルトでセーフモードが動いているようです。
お使いのサーバーでどちらが動いているか分からない場合は、次の方法で確認してください。

作成したディレクトリに付属の【phpinfo.php】をアップロードします。
ブラウザからアクセスします。
【safe_mode】が【Off】になっていれば通常モードで動いています。【On】の場合はセーフモードです。
お使いの環境によっては【safe_mode】項目自体がないこともあります。その場合は【Off】と考えてください。

サーバーによっては、サーバーの管理画面からセーフモード/通常モードを切り替えることもできます。
詳しくは、各サーバーのマニュアルをご覧いただくか、サーバー管理会社に問い合わせてください。
【php.ini】が使えるサーバーでは、【php.ini】の設定を変えると通常モードで動かすことができる場合があります。
【php.ini】に【safe_mode=false】を書き加えてサーバーにアップロードしてください。【php.ini】は【.php】ディレクトリにある場合が多いです。

PHP版の確認

PHPにはCGI版とモジュール版（スクリプト版）の2種類があります。
セキュリティと扱いやすさの観点から、CGI版PHPで動かされることをお勧めします。
モジュール版PHPはたとえ後述するデータディレクトリをWebから参照できないディレクトリに移動させたとしても、CGI版PHPに比べるとセキュリティが甘くなります。モジュール版のご利用は、真にやむを得ない方のみにしてください。
どうしてもモジュール版で動かさざるを得ない方は、必ずモジュール版のインストールを行い、リスクを理解した上で自己責任で運用してください。
モジュール版（スクリプト版）PHP使用時の注意点もご参照ください。

CGI版PHPとモジュール版PHP共に、購入者データを難読化して保存することで、万が一csvファイルが外部に流出しても解読を難しくすることもできます。詳しくは購入者データの難読化をご覧ください。

サーバー、あるいは同じサーバーでもアカウントやドメインによってCGI版のPHPが動いていたり、モジュール版のPHPが動いていたりします。お使いのサーバーでどちらが動いているか分からない場合は、次の方法で確認してください。

作成したディレクトリに付属の【phpinfo.php】をアップロードします。
ブラウザからアクセスします。
【Server API】に【CGI】という文字が含まれていれば（ex. cgi-fcgi など）、CGI版が動いています。
【Server API】に【Apache】という文字が含まれていれば（ex. apache2filter、apache2handler など）、モジュール版が動いています。

【CGI】も【Apache】も含まれていない場合

【毎度ありがとうメール for PayPal】をインストールするディレクトリを作成します。
作成したディレクトリに付属の【insunins.php】を（【PayPalMaido】ディレクトリの直下にあります）アップロードします。
ブラウザからアクセスします。
【お使いのPHP】に表示される文字に従ってください。

モジュール版（スクリプト版）PHP使用時の注意点

モジュール版（スクリプト版）PHPをご利用の方は必ずWebから参照できない（Webより上位の）ディレクトリへデータディレクトリ（【data】と【body】ディレクトリ）を移動させてください。
インストールの場合：モジュール版PHP インストール
運用中のディレクトリを移動させる場合：既存データディレクトリをWebから参照できないディレクトリへ移動させる
サーバー移転の場合：他サーバーや他ドメインへの移転
など、状況に応じた手順をこのマニュアルに書いていますのでご参照ください。

【毎度ありがとうメール for PayPal】は幾つかの理由から、データベースシステムではなくファイルシステムを採用しており、パーミッションの設定で機密情報を守っています。
ですがモジュール版PHPの場合、ディレクトリやファイルのパーミッションをどの様に設定しても外部からファイルの中身、つまりお客様の大切な情報が見えてしまいます。

今まではレンタルサーバーで提供されているのはCGI版PHPが圧倒的多数でしたが、最近はモジュール版PHPも再度提供され始めてきました。（今までもやむを得ない事情でモジュール版PHPを利用される場合の注意点をマニュアルに記載しておりましたが、読まずにモジュール版を利用されている方がおられたようです。）

このような事情から、幾つかのレンタルサーバーを調べたところ、Webから参照できない（Webより上位の）ディレクトリを開放しているレンタルサーバーも確認できました。 Webから（外部から）参照できないディレクトリにデータを置くことにより、今より安全に運用できるようになります。
モジュール版PHPをご利用の方は、必ずデータディレクトリをWebから参照できないディレクトリへ移動させてお使いください。

Webから参照できないディレクトリが利用できるかどうかはレンタルサーバーによって異なりますので、お使いのレンタルサーバーにご確認ください。
レンタルサーバーによってはWebから参照できないディレクトリが利用できないケースもあると思われます。利用できない場合はCGI版PHPでご利用ください。

またモジュール版PHPの利用にはディレクトリとファイルの所有者、パーミッションの理解が必要になります。モジュール版PHPは所有者、パーミッションについて理解しておられる方のみお使いください。

インストール

ここでは仮に【sample.desu】ディレクトリに、【ppmaido】ディレクトリを作成してインストールするとします。
実際には、【sample.desu】はご自分の環境のディレクトリへ置き換えて見ていただき、【ppmaido】はお好きなディレクトリ名にしてください。

ソフトウェアをインストールする際の基本ですが、【毎度ありがとうメール for PayPal】が他のソフトウェアの配下に入らないようにディレクトリを作ってインストールしてください。特にWordPressをお使いの方はご注意ください。 WordPressを公開ディレクトリ直下にインストール、【毎度ありがとうメール for PayPal】をWordPressの下にインストールして手に負えなくなったり、誤動作させておられる方が多くいらっしゃるようです。

駄目なケース

公開ディレクトリ
WordPressのphpファイル群
WordPressの.htaccessファイル（RewriteRuleが書かれている）
└WordPressが作成するディレクトリ
└毎度ありがとうメールインストールディレクトリ

良いケース

公開ディレクトリ
└WordPressインストールディレクトリ
　└WordPressのphpファイル群
　└WordPressの.htaccessファイル（RewriteRuleが書かれている）
　　└WordPressが作成するディレクトリ
└毎度ありがとうメールインストールディレクトリ

詳しくはWordPressのインストールディレクトリをご参照ください。
既に公開ディレクトリ直下にWordPressをインストールされている場合は、WordPressを移動させてから【毎度ありがとうメール for PayPal】をインストールしてください。
どうしてもWordPressの下に【毎度ありがとうメール for PayPal】をインストールなさる場合は、自己責任でお願いします。

CGI版PHP インストール

CGI版PHPでも【モジュール版PHP インストール】を行うと更に安全に運用できます。また【新旧を切り替えてバージョンアップ】を行う際、パーミッションを設定するディレクトリとファイルが少なく済むので少し手間が省けます。
ですが少しハードルが高いので、ご無理なようでしたらこちらのCGI版PHPのインストールを行ってください。パーミッションの設定を間違えなければ問題ありません。

ダウンロードしたファイル【PayPalMaido.zip】を解凍します。
FTPソフトを立ち上げて、サーバーに接続します。【毎度ありがとうメール for PayPal】をインストールするディレクトリを作成します。
ブラウザからアクセスが許されていて、かつPHPが動作するディレクトリの下へ作成してください。具体的にどのディレクトリの下へ作成したらよいかはサーバーによって異なりますので、各サーバーのマニュアルをご覧ください。 PHPやCGIを設置するディレクトリとして説明されているはずです。
もしインストール前のPHP調査がまだの場合、【ppmaido】ディレクトリに対してPHPバージョンの確認、 PHPモードの確認、PHP版の確認を行い、動作環境を整えてください。
【ppmaido】ディレクトリに、解凍したファイルのうち、【PayPalMaido】ディレクトリ以下の全てのファイルをアップロードします。
パーミッションの設定をします。
ファイルの中身が外部に晒されるのを避けるため、次のディレクトリとファイルのパーミッションを変更してください。
　・【body】、【data】ディレクトリを【700】にしてください。
　中には【700】では動作しないサーバーもあります。その場合は、他のパーミッションを試してみてください。
　その場合は、なるべく厳しいパーミッションに設定してください。
　ブラウザから【data】ディレクトリの下の【buyer.csv】にアクセスして、アクセス拒否されることを確認してください。
　・【data】ディレクトリの下の全ファイルを【600】に設定し、動くようなら【600】で動かしてください。
ログイン画面が表示されるか確認してください。
表示されないようなら【エラー時】を御覧ください。

【毎度ありがとうメール for PayPal】は自動バックアップ機能は備えていません。定期的に【data】ディレクトリのファイルをバックアップしてください。
バージョンアップする時は、サーバーの【body】、【data】ディレクトリのファイルを上書きしないようにお気をつけください。

モジュール版PHP インストール

------------------------------
モジュール版PHPをご利用の方
必ずこちらの方法でインストールしてください。
モジュール版（スクリプト版）PHP使用時の注意点を必ずご確認ください。
------------------------------
CGI版PHPをご利用の方
こちらの【モジュール版PHP インストール】の方がより安全に運用できますが、無理にこの方法でインストールなさる必要はありません。【CGI版PHP インストール】で大丈夫です。
【モジュール版PHP インストール】でインストールされる場合、Webから参照できないディレクトリが利用できるかどうかはレンタルサーバーによって異なりますので、お使いのレンタルサーバーにご確認ください。
------------------------------

一旦Webから参照可能なディレクトリへインストールした後、付属の【insunins.php】を使ってデータディレクトリ（【body】、【data】ディレクトリ）のみWebから参照できない（Webより上位の）ディレクトリへ移動してパーミッションを設定します。

ダウンロードしたファイル【PayPalMaido.zip】を解凍します。
FTPソフトを立ち上げて、サーバーに接続します。【毎度ありがとうメール for PayPal】をインストールするディレクトリを作成します。
ブラウザからアクセスが許されていて、かつPHPが動作するディレクトリの下へ作成してください。具体的にどのディレクトリの下へ作成したらよいかはサーバーによって異なりますので、各サーバーのマニュアルをご覧ください。 PHPやCGIを設置するディレクトリとして説明されているはずです。
もしインストール前のPHP調査がまだの場合、【ppmaido】ディレクトリに対してPHPバージョンの確認、 PHPモードの確認、PHP版の確認を行い、動作環境を整えてください。
【ppmaido】ディレクトリに、解凍したファイルのうち、【PayPalMaido】ディレクトリ以下の全てのファイルをアップロードします。
パーミッションを設定します。
・【data】、【body】ディレクトリを【707】に（レンタルサーバーによっては【777】に）設定してください。
・【data】ディレクトリの下のファイルを【604】や【606】に（レンタルサーバーによっては【664】や【666】に）設定してください。
テキストエディタを立ち上げ、データディレクトリを置くWebから参照できないディレクトリのフルパスを記述して、ファイル名【datapath.txt】で保存します。
【/home/userid/data/ppmdata】にする場合、【/home/userid/data/ppmdata/】と書いて保存します。最後の【/】は付けてください。
ファイルの文字コードは【UTF-8】にしてください。
【datapath.txt】をサーバーの【data】ディレクトリにアップロードします。
ブラウザでログイン画面を表示します。
ブラウザに【ディレクトリオープンエラー】が表示されるかもしれませんが、そのまま次に進んでください。
上のURL＋insunins.phpにアクセスします。
ログインURLが【https://sample.desu/ppmaido/】あるいは【https://sample.desu/ppmaido/index.php】の場合【https://sample.desu/ppmaido/insunins.php】にアクセスします。
画面に表示される現在の【datapath.txt】の値が正しいか確認します。
【コピーする】ボタンをクリックします。
【datapath.txt】に記述したディレクトリに【body】、【data】ディレクトリとそれ以下の全てのファイルがコピーされていることをFTPから確認してください。
もし所有者とパーミッションの関係が正しくなければ、【insunins.php】でディレクトリとファイルのパーミッションを入力、【設定する】ボタンをクリックして再設定してください。
ログイン画面が表示されるか確認してください。
表示されないようなら【エラー時】をご覧ください。
設定を始めた後で【/home/userid/data/ppmdata】ディレクトリのファイルに保存されているか念の為確認してください。FTPでファイルの更新日時から確認できます。
【datapath.txt】に設定されているパスは、【毎度ありがとうメール for PayPal】の管理画面【管理者情報など】－【【datapath.txt】に設定されたデータディレクトリのフルパス】で確認できます。

【insunins.php】を使わず、FTPでディレクトリとファイルをコピーする方法もありますが、その場合ディレクトリとファイルの所有者は通常FTPユーザーとなります。
モジュール版PHPの場合、設定するパーミションが変わってくるためセキュリティが甘くなります。
CGI版PHPの場合、所有者もパーミッションも変わらないため、セキュリティが甘くなることはありません。

【毎度ありがとうメール for PayPal】は自動バックアップ機能は備えていません。定期的に【data】ディレクトリのファイルをバックアップしてください。
モジュール版PHPの場合、FTPからバックアップできない可能性がありますので、ご自身で可能な方法を調べてください。

既存データディレクトリをWebから参照できないディレクトリへ移動させる

既にインストールして運用なさっている状態で、データディレクトリをWebから参照できないディレクトリ（Webより上位のディレクトリ）に移動させたい場合の手順です。

------------------------------
モジュール版PHPをご利用の方
必ずこちらの方法で移動させてください。
モジュール版（スクリプト版）PHP使用時の注意点を必ずご確認ください。
------------------------------
CGI版PHPをご利用の方
データディレクトリをWebから参照できないディレクトリに移動させた方がより安全ですが、ディレクトとファイルのパーミッションを正しく設定しておられるなら、無理にデータディレクトリを移動させる必要はありません。
移動される場合、Webから参照できないディレクトリが利用できるかどうかはレンタルサーバーによって異なりますので、お使いのレンタルサーバーにご確認ください。
------------------------------

現在運用しているWebから参照可能なディレクトリから、付属の【insunins.php】を使ってデータディレクトリ（【body】、【data】ディレクトリ）のみWebから参照できない（Webより上位の）ディレクトリへ移動してパーミッションを設定します。

【毎度ありがとうメール for PayPal】のバージョンが3.00以上であることを確認します。
バージョン2.xxなら、バージョン3.xxへバージョンアップしてから以下の作業を行ってください。
【毎度ありがとうメール for PayPal】をインストールしているサーバーにFTPで接続し、サーバーのファイルをローカルにダウンロード（バックアップ）します。
【body】、【data】ディレクトリ下のファイルは確実にバックアップしてください。
モジュール版PHP インストールの6～15を行います。
【毎度ありがとうメール for PayPal】をインストールしているディレクトリの【body】、【data】ディレクトリ以下の全てのファイルが削除されているか確認してください。 Webから参照できないディレクトリではなく、【毎度ありがとうメール for PayPal】をインストールしているディレクトリです。残っているようならFTPから削除してください。
ただし、【data】ディレクトリ下の【datapath.txt】は削除しないでください。
モジュール版PHPをご利用の場合 -----------------------
マニュアルに沿っていない使い方をされていた場合は、所有者とパーミッションの関係でどうしても削除できないファイルが残る場合があります。万一ファイルが残った場合は、レンタルサーバーへお願いして削除してもらってください。残ったファイルは当然外部に晒されますので確実に削除してください。
--------------------------------------------------------

バージョンアップ

バージョンアップは決済の少ない時間帯に行われることをお勧めいたします。

バージョンの表記とバージョンアップについて

ソフトウェアのバージョンは通常【1.2.03.04】のように表示し、【メジャーバージョン.マイナーバージョン.リビジョン.ビルド】を表します。

メジャーバージョン：根本的な変更
マイナーバージョン：大幅な仕様変更・機能追加
リビジョン：仕様変更・機能追加
ビルド：修正パッチ

ですが【毎度ありがとうメール for PayPal】ではそこまで厳密に表記していません。メジャーバージョンとマイナーバージョン、リビジョンとビルドをそれぞれ一緒に表記しているイメージです。
例えばバージョン1.02の場合、1がメジャーバージョンとマイナーバージョン（以下メジャーバージョン）、02がリビジョンとビルド（以下リビジョン）となります。

メジャーバージョンが同じ場合
リビジョンの番号が最新（最大）の物でバージョンアップしてください。最新のリビジョンに過去の変更分が全て含まれています（迷われないように最新のバージョンしかダウンロードできないようにしております）。
ex.) 最新バージョンが1.09で1.02をお使いの場合、1.09をダウンロード、バージョンアップしてください。
負担が少なく、間違いも少ないと考えられるバージョンアップ方法を2つ記載しておきます。
- 現在インストールしているシステムファイルを上書きしてバージョンアップ
- 新旧を切り替えてバージョンアップ
それぞれメリット・デメリットがありますので、ご自身に合う方法を選択してください。
載せている2つの方法が絶対ではありませんので、ご自身のやりやすい方法でバージョンアップしてください。
メジャーバージョンが異なる場合
新バージョンご購入時あるいはお手続き時にメールでご案内している方法と、ダウンロード画面の説明をご参照ください。

現在インストールしているシステムファイルを上書きしてバージョンアップ

メリット
基本的には新しいバージョンのファイルをサーバーに上書きアップロードするだけなので簡単です。
デメリット
新しいバージョンが動かなかった場合、元のバージョンに戻すのにやや時間がかかる上、本当に元に戻ったか確認するのも手間がかかります。

ご購入時にメールでお知らせいたしましたダウンロードページから、バージョンアップ用のファイルをダウンロードします。既に運用中のデータファイルを上書きしないようにファイルを抜いてありますので、必ずバージョンアップ用のファイルをダウンロードしてください。
ダウンロードしたファイルを解凍します。
FTPソフトを立ち上げて、【PayPa毎度ありがとうメール】をインストールしたサーバーに接続します。
バックアップのため、サーバーの【ppmaido】ディレクトリのファイルをローカルにダウンロードします。
特に【data】ディレクトリは確実にバックアップしてください。
古いバージョンの【PayPalMaido.zip】も、新しいバージョンが正常に動いていることが確認できるまで消さずに取っておいてください。
【ppmaido】ディレクトリに、新しいバージョンのファイルをアップロードします。
バージョン1からのバージョンアップの場合、【追加データファイル】にあるデータファイルもサーバーの【data】ディレクトリへアップロードし、パーミッションを【data】ディレクトリにある他のファイルと同じパーミッションに設定してください。
もし動作しない場合は、PCにバックアップしたPHPファイルをサーバーに書き戻してください。
この場合、【body】、【data】ディレクトリのファイルはアップロードしないようにしてください。サーバーのデータファイルの方が新しい場合、書き戻してしまうとデータが古くなってしまうことを避けるためです。

新旧を切り替えてバージョンアップ

メリット
新しいバージョンが動かなかった場合、ディレクトリ名の変更だけで元のバージョンに戻すことができます。
デメリット
新しいバージョンをインストールして、パーミッションなどを設定しないといけないので手間がかかります。
（既存データディレクトリをWebから参照できないディレクトリへ移動させている場合は、パーミッションを設定するディレクトリとファイルが少なく済みます。）

沢山手順がありますが大まかな流れは、
古いバージョンのファイル群をサーバーにコピーしてパーミッションなどを設定、
片方だけバージョンアップ、
になります。

ご購入時にメールでお知らせいたしましたダウンロードページから、最新バージョンのバージョンアップ用ファイルをダウンロードします。既に運用中のデータファイルを上書きしないようにファイルを抜いてありますので、必ずバージョンアップ用のファイルをダウンロードしてください。
ダウンロードしたファイルを解凍します。
FTPソフトを立ち上げて、【PayPa毎度ありがとうメール】をインストールしているサーバーに接続します。
【PayPa毎度ありがとうメール】をインストールしているディレクトリ【ppmaido】と同じ階層に【ppmaido_new】ディレクトリを作成します。
【ppmaido】にPHP設定やサーバー設定（ex. PHPのバージョン、CGIで動かす、php.iniなど）をしている場合は、【ppmaido_new】にも設定します。
PHPバージョンの確認、PHPモードの確認、PHP版の確認を行って、【ppmaido】と【ppmaido_new】のPHPの環境が同じであることを確認してください。
もし【ppmaido】と【ppmaido_new】でPHPの環境を変えたい（ex. PHPのバージョンを変えたい）場合はこの限りではありません。
サーバーの【ppmaido】下の全ディレクトリと全ファイルをローカルにダウンロードします。
【ppmaido_new】ディレクトリへ、ダウンロードした全ディレクトリと全ファイルをアップロードします。
ここまでの作業で、【ppmaido】のファイルとディレクトリを丸ごと【ppmaido_new】へコピーしています。
【ppmaido_new】のディレクトリとファイルのパーミッションを、【ppmaido】と同じに設定します。
ここまでの作業で、【ppmaido】と【ppmaido_new】ディレクトリが全く同じになっているはずです。
【ppmaido_new】にダウンロード・解凍した最新バージョンのバージョンアップ用ファイルをアップロードします。
【ppmaido_new】へログインし、ライセンス登録の項目を確認してください。
インストールURLは【ppmaidol_new】ではなく、【ppmaido】で設定してください。
ざっとでいいので、動作を確認してください。
動いているようなら【ppmaido】を【ppmaido_old】に、【ppmaido_new】を【ppmaido】に変更します。
これで新しいバージョンに切り替わりますので、正しく動くかきちんと確認してください。
もし正常に動かない場合は、【ppmaido】を【ppmaido_new】へ、【ppmaido_old】を【ppmaido】に変更すれば、元に戻すことができます。
もし作業の途中で決済があった場合や、動かなくて【ppmaido_old】と【ppmaido_new】を切り替えながら運用した場合、データファイルの同期も行ってください。
データファイルは【data】ディレクトリ下のディレクトリとファイルになります。

他サーバーや他ドメインへの移転

------------------------------
モジュール版PHPをご利用の方
モジュール版（スクリプト版）PHP使用時の注意点を必ずご確認ください。
------------------------------

インストール前のPHP調査に従い、移転先サーバーのPHPバージョンの確認、PHPモードの確認、PHP版の確認を行います。
移転元サーバーの【毎度ありがとうメール for PayPal】をローカルにダウンロードします。
Webから参照できないディレクトリにデータディレクトリを置いている場合は、これらもダウンロードします。
CGI版PHP インストールの2～3に従い、移転先サーバーに移転元からダウンロードした【毎度ありがとうメール for PayPal】をアップロードします。
モジュール版PHPの場合もここの作業は同じです。
ご購入時にメールでお知らせいたしましたダウンロードページから、最新バージョンのバージョンアップ用ファイルをダウンロードし、解凍します。
既に運用中のデータファイルを上書きしないようにファイルを抜いてありますので、必ずバージョンアップ用のファイルをダウンロードしてください。
最新バージョンのバージョンアップ用ファイルを移転先サーバーへアップロードします。
Webから参照できないディレクトリにデータディレクトリを置いていた場合は、移転元からダウンロードしたWebから参照できないディレクトリにあったファイルを、移転先のサーバーの【毎度ありがとうメール for PayPal】をインストールしたディレクトリにアップロードします。
CGI版PHPの場合 ------------------------
CGI版PHP インストールの5～6を行います。
Webから参照できないディレクトリにデータディレクトリを置く場合は、CGI版PHP インストールではなく、次のモジュール版PHPの場合の作業を行ってください。
モジュール版PHPの場合 ------------------------
モジュール版PHP インストールの5～15を行います。
URLが変わっている場合は次の2つを行ってください。
移転先サーバーの【PayPa毎度ありがとうメール】にログインし、【管理者情報など】－【PayPa毎度ありがとうメールのインストールURL】を変更します。必ず【PayPa毎度ありがとうメール】の管理画面から変更してください。直接csvファイルを変更した場合はライセンスが認証されません。
PayPalにログインし、【IPN通知の設定】の【通知URL】を、新しいURLに変更してください。ただしPayPalの仕様上、運用中の定期購読のIPN通知URLは変更できないそうです（2017年5月現在）。つまり現在支払が行われている商品の決済データ送信先を新しいURLに変更できないだけでなく、購読を削除しないと古いURLへデータが送信され続けます。詳しくはPayPalへお尋ねください。
移転先サーバーで【毎度ありがとうメール for PayPal】が安定して動作していることが確認できたら、移転元の【毎度ありがとうメール for PayPal】をアンインストールします。

アンインストール

CGI版PHP アンインストール

CGI版PHPで動かしている場合、モジュール版PHP インストールを行い、Webから参照できないディレクトリにデータディレクトリを置いていたとしても、FTPで全てのファイルをサーバーから削除することでアンインストールできます。

サーバーにFTPで接続し、【毎度ありがとうメール for PayPal】をインストールしたディレクトリごと削除します。
Webから参照できないディレクトリにデータディレクトリを置いている場合は、このディレクトリも削除します。

モジュール版PHP アンインストール

インストールの手順通りにインストールなさった場合、【毎度ありがとうメール for PayPal】をインストールしたディレクトリはFTPから削除できますが、Webから参照できないディレクトリはFTPから削除できないかもしれません（所有者とパーミッションの関係、サーバーの設定によります）。
Webから参照できないディレクトリは【insunins.php】で削除、インストールディレクトリはFTPから削除してください。

ブラウザでログイン画面を表示します。
上のURL＋insunins.phpにアクセスします。
ログインURLが【https://sample.desu/ppmaido/】あるいは【https://sample.desu/ppmaido/index.php】の場合【https://sample.desu/ppmaido/insunins.php】にアクセスします。
画面に表示される現在の【datapath.txt】の値がWebから参照できないディレクトリになっているか確認します。
【一覧取得】をクリックします。
削除して大丈夫なら【削除する】ボタンをクリックします。
削除できないファイルが残った場合、【insunins.php】からディレクトリのパーミッションを777に変更して再度削除してみてください。
それでも残るようなら、レンタルサーバー会社に頼んで削除してもらってください。
サーバーにFTPで接続し、【毎度ありがとうメール for PayPal】をインストールしたディレクトリに移動します。
【毎度ありがとうメール for PayPal】をインストールしたディレクトリごと削除します。

サポートについて

どうしてもインストールができないなどインストールでお困りになった場合は、インストール代行も行っています。
また運用開始後に、新しい商品を登録したけど動作しない、サーバー移転したら動かなくなった、など問題が生じた場合は、個別技術サポートをご利用ください。

【毎度ありがとうメール for PayPal】 オンラインマニュアル インストール

最新バージョンについて