MochiuWiki : SUSE, EC, PCB

「PHPの基礎 - メール」の版間の差分

← 古い編集
ビジュアルウィキテキスト
 
(同じ利用者による、間の5版が非表示)
1行目: 1行目:
== 概要 ==
== 概要 ==
<code>mail</code>関数または<code>mb_send_mail</code>関数を使用して、メールを送信する手順を記載する。<br>
<code>mail</code>関数または<code>mb_send_mail</code>関数を使用して、メールを送信する手順を記載する。<br>
<br><br>
== php.iniの設定 ==
<code>mail</code>関数または<code>mb_send_mail</code>関数では、php.iniファイルで設定したSMTPサーバ名とポート番号の値を読み込んで使用する。<br>
そのため、php.iniファイルの該当箇所を適切な値に設定する必要がある。<br>
<br>
php.iniファイルの[mail function]において、以下の設定を記述する。<br>
* SMTP
*: SMTPサーバのホスト名またはIPアドレスを指定する。
*: もし、ローカル環境のメール送信用サーバを使用する場合、<code>localhost</code>でもよい。
* smtp_port
*: メールの送信時に使用するポート番号を指定する。
*: 標準のポート番号は<code>25</code>番であるが、迷惑メール対策で<code>Outbound Port25 Blocking</code>が実施されている場合は、<code>587</code>番等を使用する。
*: 使用するメールサーバに合わせて設定すること。
* sendmail_from
*: Windowsで使用する場合、<code>sendmail_from</code>にメール送信元のメールアドレスを設定できる。
*: 設定する場合は、先頭のセミコロン(;)を外してメールアドレスを設定する。
[mail function]
; For Windows only.
SMTP = <SMTPサーバのホスト名またはIPアドレス>
smtp_port = <ポート番号>
; For Windows only.
;sendmail_from = me@example.com
; For Unix only.  You may supply arguments as well (default: "sendmail -t -i").
;sendmail_path =
; Force the addition of the specified parameters to be passed as extra parameters
; to the sendmail binary. These parameters will always replace the value of
; the 5th parameter to mail(), even in safe mode.
;mail.force_extra_parameters =
<br>
以下に、設定例を示す。<br>
[mail function]
; For Win32 only.
SMTP = smtp.example.jp
smtp_port = 25
; For Win32 only.
sendmail_from = peke@example.jp
<br>
設定変更後は、Apache等のWebサーバを再起動する。<br>
<br><br>
<br><br>


96行目: 139行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<br><br>
== IMAP ==
==== PHP標準のIMAPモジュール (ビルトインのIMAPモジュール) ====
IMAPプロトコルは、1980年代に開発された比較的古いプロトコルである。<br>
しかし、現在でも多くのメールサーバでサポートされている。<br>
<br>
PHP標準のIMAPモジュール (ビルトイン済み) は、PHPの公式拡張であるが長年更新が少なく、レガシーな実装が残っている。<br>
このモジュールはPHPのc-clientライブラリに依存しているため、システムレベルでのインストールが必要となる。<br>
<br>
PHP標準のIMAPモジュールの特徴として、基本的なIMAP操作のみであり、エラーハンドリングが古い方式、日本語等のエンコーディング処理が複雑である。<br>
<br>
<syntaxhighlight lang="php">
// PHP標準のIMAPモジュール
$inbox  = imap_open("{imap.example.com:993/imap/ssl}INBOX", "<ユーザ名>", "<パスワード>");
$emails = imap_search($inbox, 'ALL');
</syntaxhighlight>
<br>
IMAPモジュールの代替手段の充実しており、Composer経由で利用できる現代的なメールライブラリが多数存在する。<br>
以下に示すライブラリは、PHPのビルトインIMAPよりも使用しやすく、メンテナンスも活発である。<br>
* php-imap/php-imap
* Webklex/php-imap
* ddeboer/imap
<br>
しかし、PHPでは、IMAPモジュールの必要性は以前と比べて低くなっている。<br>
現在では、以下に示す理由からIMAPを使用しないほうがよい。<br>
* セキュリティ面での考慮が必要になる。
* 依存関係の管理が複雑になる。
* システムレベルでの追加ライブラリのインストールが必要である。
* クロスプラットフォームでの一貫性の問題がある。
<br>
==== IMAPの代替 ====
代替可能なものとして、以下に示すようなものが存在する。<br>
* REST APIを使用したメールサービスの利用
* Gmail API
* Microsoft Graph API (Office 365/Exchange)
* メールサービスプロバイダのSDK活用
* キューイングシステムとの連携
<br>
したがって、以下に示すような場合を除き、IMAPモジュールは使用しないことを推奨する。<br>
* レガシーシステムとの互換性が必要な場合
* 直接IMAPサーバーとの通信が絶対に必要な場合
* 特定のIMAPプロトコル機能に依存している場合
<br>
==== php-imap/php-imapライブラリ (Composer) ====
<u>IMAPを使わざるを得ない場合の最善の選択肢として、php-imap/php-imapを使用することを推奨する。</u><br>
<br>
php-imap/php-imapライブラリは、現代的なPHPの機能を活用した積極的にメンテナンスされているライブラリである。<br>
Composerでインストール可能であり、PHPのビルトインIMAPモジュールをラップする形で実装されている。<br>
<br>
php-imap/php-imapの特徴として、以下に示すものが挙げられる。<br>
* 現代的な例外処理
* より直感的なAPI
* 添付ファイル処理の改善
* エンコーディング処理の自動化
* タイプヒントのサポート
* より良いドキュメント
<br>
<syntaxhighlight lang="php">
<?php
// Composerで使用されるPHPのパッケージ管理システムに関連する重要な記述
// 必要なクラスファイルを自動的にrequire/includeする
require 'vendor/autoload.php';
use PhpImap\Mailbox;
use PhpImap\Exceptions\ConnectionException;
use PhpImap\Exceptions\InvalidParameterException;
/*
  * メール処理を行うクラス
  */
class MailProcessor
{
    private $mailbox;
    private $server;
    private $username;
    private $password;
    /**
    * コンストラクタ
    *
    * @param string $server IMAPサーバーアドレス (例: imap.example.com)
    * @param string $username ユーザー名
    * @param string $password パスワード
    */
    public function __construct(string $server, string $username, string $password)
    {
      $this->server = $server;
      $this->username = $username;
      $this->password = $password;
    }
    /**
    * メールボックスへの接続を確立
    *
    * @throws ConnectionException 接続エラー時
    * @return bool 接続成功時にtrue
    */
    public function connect(): bool
    {
      try {
          // IMAPサーバへの接続文字列を構築
          $imapPath = sprintf('{%s:993/imap/ssl}INBOX', $this->server);
          // メールボックスオブジェクトを初期化
          $this->mailbox = new Mailbox($imapPath, $this->username, $this->password,
                                      __DIR__ . '/attachments', // 添付ファイル保存ディレクトリ
                                      'UTF-8'                  // 文字エンコーディング
          );
          // 接続
          $this->mailbox->checkMailbox();
          return true;
      }
      catch (ConnectionException $e) {
          throw new ConnectionException('メールサーバーへの接続に失敗しました: ' . $e->getMessage());
      }
    }
    /**
    * メールを検索して取得
    *
    * @param string $criteria 検索条件 (例: 'ALL', 'UNSEEN', 'FROM "someone@example.com"')
    * @return array 検索結果のメール情報配列
    */
    public function searchMails(string $criteria = 'ALL'): array
    {
      try {
          // メールを検索
          $mailsIds = $this->mailbox->searchMailbox($criteria);
          $results = [];
          foreach ($mailsIds as $mailId) {
            try {
                $email = $this->mailbox->getMail($mailId);
                $results[] = [
                        'id' => $mailId,
                        'subject' => $email->subject,
                        'from' => $email->fromAddress,
                        'date' => $email->date,
                        'body' => $email->textPlain,
                        'hasAttachments' => $email->hasAttachments()
                ];
            }
            catch (\Exception $e) {
                // 個別のメール取得エラーをログに記録し、処理を継続
                error_log("メールID {$mailId} の取得に失敗: " . $e->getMessage());
                continue;
            }
          }
          return $results;
      }
      catch (InvalidParameterException $e) {
          throw new InvalidParameterException('無効な検索条件が指定されました: ' . $e->getMessage());
      }
    }
    /**
    * メールボックスの接続を終了
    */
    public function disconnect(): void
    {
      if ($this->mailbox) $this->mailbox->disconnect();
    }
}
</syntaxhighlight>
<br>
<syntaxhighlight lang="php">
// 使用例
try {
    // メールプロセッサのインスタンスを生成
    $processor = new MailProcessor(
        'imap.example.com',
        '<ユーザー名>',
        '<パスワード>'
    );
    // 接続
    $processor->connect();
    // 未読メールを検索
    $unreadMails = $processor->searchMails('UNSEEN');
    // 結果を処理
    foreach ($unreadMails as $mail) {
      echo "Subject: " . $mail['subject'] . "\n";
      echo "From: " . $mail['from'] . "\n";
      echo "Date: " . $mail['date'] . "\n";
    }
}
catch (ConnectionException $e) {
    // 接続エラーの処理
    error_log("接続エラー: " . $e->getMessage());
    exit(1);
}
catch (InvalidParameterException $e) {
    // パラメータエラーの処理
    error_log("パラメータエラー: " . $e->getMessage());
    exit(1);
}
catch (\Exception $e) {
    // その他の予期せぬエラーの処理
    error_log("予期せぬエラー: " . $e->getMessage());
    exit(1);
}
finally {
    // 確実に接続を終了
    if (isset($processor)) {
        $processor->disconnect();
    }
}
</syntaxhighlight>
<br>
==== 推奨されるアプローチ ====
新規システムを設計する場合は、以下に示す順序で検討することが推奨される。<br>
# クラウドメールサービスのAPIを使用
#* Gmail API
#* Microsoft Graph API
#* その他のモダンなメールサービスAPI
#: <br>
# メールサービスプロバイダのAPIが使用できない場合
#* SMTP/IMAPの代わりにRESTful APIを提供する中間サービス
#*: 例: Mailgun、SendGrid、Amazon SES等
#: <br>
# IMAPを使わざるを得ない場合
#* php-imap/php-imapを使用
#*: より現代的なライブラリとして保守されているため
<br>
上記の理由から、可能であれば、よりモダンなAPIベースのソリューションを検討することが推奨される。<br>
<br><br>
== APIベースのソリューション ==
==== Google Gmail API ====
Composerで必要なライブラリをインストールする。<br>
composer require google/apiclient
<br>
<syntaxhighlight lang="php">
// クライアントの初期化
$client = new Google_Client();
$client->setApplicationName('Your Application Name');
$client->setScopes([Google_Service_Gmail::GMAIL_READONLY]);
$client->setAuthConfig('path/to/credentials.json'); // Google Cloud Consoleから取得した認証情報
// OAuth2認証フロー
if (!isset($_SESSION['access_token'])) {
    // 認証URLの生成
    $authUrl = $client->createAuthUrl();
    header('Location: ' . $authUrl);
    exit;
}
else {
    $client->setAccessToken($_SESSION['access_token']);
    // トークンの有効期限が切れている場合は更新
    if ($client->isAccessTokenExpired()) {
      $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
      $_SESSION['access_token'] = $client->getAccessToken();
    }
}
// Gmail APIの利用
$gmail = new Google_Service_Gmail($client);
// メール一覧の取得
$optParams = [
    'maxResults' => 10,      // 取得する件数
    'labelIds' => ['INBOX']  // INBOXのメールを取得
];
$messagesList = $gmail->users_messages->listUsersMessages('me', $optParams);
foreach ($messagesList->getMessages() as $message) {
    // 個別のメッセージIDを取得
    $messageId = $message->getId();
    // 個別のメッセージの詳細を取得
    $message = $gmail->users_messages->get('me', $messageId);
    // メッセージの内容を取得
    $headers = $messageDetail->getPayload()->getHeaders();
    // 件名、送信者等の情報を取得
    $subject = '';
    $from = '';
    foreach ($headers as $header) {
      if ($header->getName() == 'Subject') {
          $subject = $header->getValue();
      }
      if ($header->getName() == 'From') {
          $from = $header->getValue();
      }
    }
    echo "ID: {$messageId}\n";
    echo "Subject: {$subject}\n";
    echo "From: {$from}\n";
}
</syntaxhighlight>
<br>
* 検索条件を指定してメッセージを取得する場合
<syntaxhighlight lang="php">
$optParams = [
    'q' => 'from:example@gmail.com',  // 検索クエリ
    'maxResults' => 5
];
// 昨日以降のメール
$optParams = ['q' => 'after:' . date('Y/m/d', strtotime('-1 day'))];
// 未読メール
$optParams = ['q' => 'is:unread'];
// 特定の件名のメール
$optParams = ['q' => 'subject:"Meeting Invitation"'];
// 添付ファイルがあるメール
$optParams = ['q' => 'has:attachment'];
</syntaxhighlight>
<br>
* メッセージの詳細情報の取得例
<syntaxhighlight lang="php">
function getEmailContent($gmail, $messageId)
{
    $message = $gmail->users_messages->get('me', $messageId, ['format' => 'full']);
    $payload = $message->getPayload();
    // メール本文の取得
    $body = '';
    if ($payload->getBody()->getData()) {
      $body = base64url_decode($payload->getBody()->getData());
    }
    else {
      // マルチパートの場合
      $parts = $payload->getParts();
      foreach ($parts as $part) {
          if ($part->getMimeType() === 'text/plain') {
            $body = base64url_decode($part->getBody()->getData());
            break;
          }
      }
    }
    return [
      'id' => $messageId,
      'threadId' => $message->getThreadId(),
      'labelIds' => $message->getLabelIds(),
      'body' => $body,
      // その他必要な情報
    ];
}
// base64url_decode関数の定義
function base64url_decode($data)
{
    return base64_decode(str_pad(strtr($data, '-_', '+/'), strlen($data) % 4, '=', STR_PAD_RIGHT));
}
</syntaxhighlight>
<br>
<u>※注意</u><br>
<u>メールを取得する場合には、以下に示す事柄に注意すること。</u><br>
* レート制限に注意する。
* 必要な権限（スコープ）が設定されていることを確認する。
* 大量のメールを処理する場合はページネーションを使用する。
<br>
==== Microsoft Graph API ====
Composerで必要なライブラリをインストールする。<br>
composer require microsoft/microsoft-graph
<br>
<syntaxhighlight lang="php">
// アプリケーションの登録情報
$clientId    = 'YOUR_CLIENT_ID';
$clientSecret = 'YOUR_CLIENT_SECRET';
$tenantId    = 'YOUR_TENANT_ID';
$redirectUri  = 'YOUR_REDIRECT_URI';
// OAuth2認証の設定
$provider = new \League\OAuth2\Client\Provider\GenericProvider([
    'clientId'                => $clientId,
    'clientSecret'            => $clientSecret,
    'redirectUri'            => $redirectUri,
    'urlAuthorize'            => "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/authorize",
    'urlAccessToken'          => "https://login.microsoftonline.com/$tenantId/oauth2/v2.0/token",
    'urlResourceOwnerDetails' => '',
    'scopes'                  => 'Mail.Read'
]);
// アクセストークンの取得
if (!isset($_SESSION['access_token'])) {
    // 認証コードの取得
    if (!isset($_GET['code'])) {
      $authUrl = $provider->getAuthorizationUrl();
      header('Location: ' . $authUrl);
      exit;
    }
    // 認証コードを使用してアクセストークンを取得
    $accessToken = $provider->getAccessToken('authorization_code', [
      'code' => $_GET['code']
    ]);
    $_SESSION['access_token'] = $accessToken->getToken();
}
$accessToken = $_SESSION['access_token'];
// Graph APIの利用
$graph = new Graph();
$graph->setAccessToken($accessToken);
try {
    $messages = $graph->createRequest("GET", "/me/messages")->execute();
}
catch (\Microsoft\Graph\Exception\GraphException $e) {
    // エラー処理
    error_log('Graph API Error: ' . $e->getMessage());
}
</syntaxhighlight>
<br><br>
{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}


__FORCETOC__
__FORCETOC__
[[カテゴリ:Web]]
[[カテゴリ:Web]]
「https://mochiu.net/index.php/PHPの基礎_-_メール」から取得