この記事を開いてくださったこと、心から感謝しています。プログラムの結果を、外へ届ける方法を知りたいと考えている人も、きっと多いはずです。
結論から言うと、文章をメールで届けたいときはSendMail、ファイルをFTPサーバーへ送りたいときはSendFTPです。届けるものが、文章かファイルかで、選ぶ関数が分かれます。
また、エラーコードや、送る量の上限など、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、SendMail、SendFTP、端末の許可設定の確認方法、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
SendMailとSendFTPは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。1つは文章をメールで送る関数で、もう1つはファイルをFTPで送る関数です。
SendMailは、題名と本文をメールで送る
SendMailは、題名と本文を指定して、メールを送る関数です。書き方はbool型の関数で、引数は、題名と本文の2つの文字列です。
公式の説明では、メールが送信の待ち行列に入れば、trueを返します。入れられなければ、falseを返します。相手に届いたかどうかは、ページには、記載なしでした。
- 題名と本文を、メールで送る
- 戻り値は、bool型
- 待ち行列に入ればtrue
SendFTPは、ファイルをFTPサーバーへ送る
SendFTPは、ファイルをFTPサーバーへ送る関数です。引数は、ファイル名と、送り先のFTPのフォルダです。フォルダは省略でき、その場合は設定のフォルダが使われます。
公式の説明では、失敗したときはfalseを返す、と書かれています。成功したときの戻り値については、ページには、記載なしでした。
- ファイルを、FTPで送る
- 送り先のフォルダは、省略できる
- 失敗したときは、false
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | SendMail | SendFTP |
|---|---|---|
| 送るもの | 題名と本文 | ファイル |
| 引数 | 題名、本文 | ファイル名、送り先 |
| 戻り値 | bool | 失敗でfalse |
| テスターでの動作 | 動かない | 動かない |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
SendMailは、どんな場面で使うのか?
SendMailは、プログラムの結果を、文章にして、メールで受け取りたいときに使います。公式の説明から、条件と動き方を確認します。
端末の設定で、送信が禁止されている場合がある
公式の説明では、メールの送信は、端末の設定で禁止できます。また、設定で、メールアドレスを空にしておくこともできます。
それらの場合に、端末が何をするかは、ページには、記載なしでした。送る前に、設定を確かめる作り方が、安心です。これは、公式の説明をもとにした、筆者の考えです。
- 端末の設定で、禁止できる
- アドレスを空にできる
- そのときの動きは、記載なし
公式サンプルは、先に許可を確かめる
公式サンプルは、まず、端末の許可を調べる関数で、メールの許可を確かめます。許可がなければ、エラーを表示して、そこで終わります。
許可があれば、エラーの記録をリセットしてから、SendMailを呼びます。失敗したときは、直前のエラーの番号を、表示します。通知の別の方法は、AlertとSendNotificationの記事で整理しています。
- 先に、メールの許可を確かめる
- エラーの記録を、リセットする
- 失敗したら、エラーの番号を表示する
送る量や、仕組みの細かい点は、記載がない
SendMailのページには、題名や本文の長さの上限、送る回数の制限は、書かれていません。サーバーの種類や、暗号化の方法も、記載なしでした。
添付ファイルを付ける引数も、ありません。待ち行列に入れたあとの再送の扱いも、記載なしです。使う前に、自分の環境で、小さく試しましょう。
- 長さの上限は、記載なし
- 送る回数の制限も、記載なし
- 再送の扱いも、記載なし
SendFTPは、どんな場面で使うのか?
SendFTPは、プログラムが作ったファイルを、自分のサーバーへ送りたいときに使います。公式の説明から、条件を確認します。
送れるファイルは、決まった場所のものだけ
公式の説明では、送れるファイルは、端末のフォルダの中の、MQL5のfilesフォルダか、その中のサブフォルダに置いたものです。それ以外の場所のファイルは、対象外です。
また、FTPのアドレスやパスワードが、設定に入っていなければ、何も送られません。設定は、端末の設定画面の、FTPのタブで行います。
- MQL5のfilesフォルダの中に置く
- アドレスとパスワードが必要
- 設定は、FTPのタブで行う
公式サンプルも、先に許可を確かめる
公式サンプルは、SendMailと同じ流れです。まず、FTPの許可を確かめ、なければエラーを表示して終わります。許可があれば、ファイル名と送り先を指定して、SendFTPを呼びます。
サンプルでは、送り先に、何も指定しない値を渡しています。その場合は、設定のフォルダが使われる、と読み取れます。失敗したら、エラーの番号を表示します。
- 先に、FTPの許可を確かめる
- 送り先は、何も指定しない値
- 失敗したら、エラーの番号を表示する
通信の細かい点は、記載がない
SendFTPのページには、通信の方式や、暗号化の有無は、書かれていません。ファイルの大きさの上限や、タイムアウトも、記載なしでした。
送り先のフォルダの書き方や、ファイル名にサブフォルダを含められるかも、記載なしです。ファイルが開かれているときの動きも、確認できませんでした。
- 通信の方式は、記載なし
- 大きさの上限は、記載なし
- フォルダの書き方も、記載なし
端末の許可設定は、どう確かめるのか?
2つの関数は、使う前に、端末の許可を確かめるのが基本です。公式の定数のページに、確かめるための項目があります。
2つの許可を、別々に調べられる
端末の情報を調べる関数に、決まった定数を渡すと、許可の状態が分かります。メール用と、FTP用の2つが、別々に用意されています。
| 定数 | 意味 |
|---|---|
| メールの許可 | 設定のSMTPサーバーとログインで、メールを送れるか |
| FTPの許可 | 設定のFTPサーバーとログインで、レポートを送れるか |
※公式の定数のページの内容を、筆者が整理しました。
許可が変わるタイミングは、記載がない
プログラムの実行中に、許可の値が変わるのか、テスターでどう動くのかは、ページには、記載なしでした。念のため、送る直前に確かめる作り方が、安心です。
- 実行中に変わるかは、記載なし
- テスターでの値も、記載なし
- 送る直前に、確かめる
どう使い分ければよいのか?
2つは、送るものが違う関数です。文章を知らせたいのか、ファイルを渡したいのかで、使い分けます。
文章で知らせたいなら、SendMailを選ぶ
プログラムの状態を、短い文章で受け取りたいときは、SendMailが向いています。題名と本文だけで済むので、仕組みが分かりやすい点が、長所です。
FX口座・ツールの比較一覧もあわせて確認してみてください。
ファイルを渡したいなら、SendFTPを選ぶ
プログラムが作ったファイルを、自分のサーバーへ置きたいときは、SendFTPが向いています。filesフォルダの中に作ったファイルが、対象になります。
- 作ったファイルを、サーバーへ置きたい
- filesフォルダの中に、ファイルがある
- FTPの設定を、済ませてある
どちらもテスターでは、動かない点に注意する
どちらの関数も、公式の説明では、ストラテジーテスターでは動きません。テスターでの戻り値は、ページには、記載なしでした。
そのため、テスターで試した結果だけで、送れるかどうかは判断できません。実際の端末で、確かめる必要があります。
- どちらも、テスターでは動かない
- テスターでの戻り値は、記載なし
- 実際の端末で、確かめる
2つを組み合わせる考え方もある
たとえば、プログラムが作った記録のファイルをSendFTPで送り、送れたかどうかの知らせを、SendMailで受け取る、という組み合わせも考えられます。これは、2つの関数の説明から、筆者が考えた使い方の例です。
ただし、公式のページには、2つを組み合わせる使い方の説明は、記載なしでした。送る順番や、失敗したときの扱いは、自分の環境で試して、決める必要があります。
組み合わせると、確認する点が増えます。まずは、1つずつ動くことを確かめてから、つなげると、原因が分かりやすくなります。
- ファイルはSendFTPで送る
- 知らせはSendMailで受け取る
- 組み合わせの説明は、記載なし
実際に使うとき、どんな順番で進めればよいのか?
最後に、2つの関数を使うときの、確認の順番を整理します。許可の確認から始めるのが安心です。
まずは、端末の設定を済ませる
最初に、端末の設定画面で、メールのアドレスや、FTPのサーバーとログインを入れます。入れたあとで、許可を確かめる関数で、状態を見ます。
- 設定画面で、必要な項目を入れる
- 許可の関数で、状態を見る
- falseなら、設定を見直す
次に、小さなスクリプトで試す
公式サンプルのように、スクリプトで、短い文章や小さなファイルを送ってみます。失敗したときは、エラーの番号を表示して、確かめます。
- 短い文章で、試す
- 小さなファイルで、試す
- エラーの番号を、確かめる
最後に、EAやインジケーターへ組み込む
動きが分かってから、自分のプログラムに組み込みます。送る回数が多くなりすぎないよう、条件を絞る工夫も、大切です。
音で知らせる方法は、MessageBoxとPlaySoundの記事も参考になります。









もう1つのコツは、失敗したときの処理を、必ず用意しておくことです。送れなかった場合でも、プログラム全体が止まらないように作ると、安心です。
- 許可を、先に確かめる
- 失敗したときの処理を、用意する
- 記載なしの点は、小さく試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
SendMailがtrueなら、相手に届いているのか?
いいえ、公式の説明では、trueは、待ち行列に入ったことを示します。届いたかどうかは、ページには、記載なしでした。
- trueは、待ち行列に入った印
- 届いたかは、記載なし
SendFTPで、どこのファイルでも送れるのか?
いいえ、公式の説明では、MQL5のfilesフォルダか、その中のサブフォルダのファイルに限られます。それ以外の場所は、対象外です。
- filesフォルダの中だけ
- サブフォルダも、対象
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?」
文章を届けたいならSendMail、ファイルを渡したいならSendFTPです。どちらも許可を先に確かめ、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










