【PHP8.x】ATTACH定数の使い方

Copy
1<?php
2
3/**
4 * SQLite3データベースファイルを作成し、別のデータベースファイルをアタッチするサンプル。
5 * システムエンジニアを目指す初心者向けに、SQLite3::exec() メソッドを使った
6 * ATTACH DATABASE コマンドの基本的な使い方を示します。
7 */
8function manageAttachedSQLiteDatabases(): void
9{
10    // メインのデータベースファイル名
11    $mainDbFile = 'main_database.db';
12    // アタッチする（追加する）データベースファイル名
13    $attachedDbFile = 'attached_database.db';
14    // アタッチしたデータベースに付けるエイリアス名
15    $attachedDbAlias = 'secondary';
16
17    // 既存のデータベースファイルを削除（テスト実行を容易にするため）
18    if (file_exists($mainDbFile)) {
19        unlink($mainDbFile);
20    }
21    if (file_exists($attachedDbFile)) {
22        unlink($attachedDbFile);
23    }
24
25    echo "--- SQLite3 ATTACH DATABASE サンプル開始 ---\n";
26
27    try {
28        // 1. メインのSQLite3データベースに接続または作成します。
29        // SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE は、読み書きモードで開き、
30        // ファイルが存在しない場合は作成することを意味します。
31        $mainDb = new SQLite3($mainDbFile, SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE);
32        echo "メインデータベース '{$mainDbFile}' を開きました。\n";
33
34        // メインデータベースにテーブルを作成し、データを挿入します。
35        $mainDb->exec('CREATE TABLE IF NOT EXISTS main_table (id INTEGER PRIMARY KEY, name TEXT)');
36        $mainDb->exec("INSERT INTO main_table (name) VALUES ('メインレコード1')");
37        $mainDb->exec("INSERT INTO main_table (name) VALUES ('メインレコード2')");
38        echo "メインデータベースに 'main_table' を作成し、データを挿入しました。\n";
39
40        // 2. アタッチする（追加される）データベースファイルを作成します。
41        // ここでは、アタッチされるデータベース自体もSQLite3::openで作成します。
42        // 必要に応じて、このファイルはすでに存在していても構いません。
43        $attachedDb = new SQLite3($attachedDbFile, SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE);
44        $attachedDb->exec('CREATE TABLE IF NOT EXISTS secondary_table (id INTEGER PRIMARY KEY, value TEXT)');
45        $attachedDb->exec("INSERT INTO secondary_table (value) VALUES ('アタッチレコードA')");
46        $attachedDb->exec("INSERT INTO secondary_table (value) VALUES ('アタッチレコードB')");
47        $attachedDb->close(); // アタッチ前に一度閉じる（ファイルロックの問題を避けるため、推奨されます）
48        echo "アタッチされるデータベース '{$attachedDbFile}' を作成し、'secondary_table' を作成しました。\n";
49
50        // 3. メインデータベースに別のデータベースファイルをアタッチします。
51        // SQLiteのATTACH DATABASEコマンドは、指定されたデータベースファイルを現在の接続に追加し、
52        // エイリアス（別名）を使ってそのデータベース内のテーブルにアクセスできるようにします。
53        $attachSql = "ATTACH DATABASE '{$attachedDbFile}' AS {$attachedDbAlias};";
54        $mainDb->exec($attachSql);
55        echo "データベース '{$attachedDbFile}' をエイリアス '{$attachedDbAlias}' としてアタッチしました。\n";
56
57        // 4. メインデータベースとアタッチされたデータベースの両方からデータを取得します。
58        // エイリアス（例: secondary.secondary_table）を使って、アタッチされたデータベースのテーブルにアクセスできます。
59        echo "\n--- メインデータベース ('{$mainDbFile}') のデータ ---\n";
60        $resultMain = $mainDb->query('SELECT * FROM main_table');
61        while ($row = $resultMain->fetchArray(SQLITE3_ASSOC)) {
62            echo "ID: {$row['id']}, Name: {$row['name']}\n";
63        }
64        $resultMain->finalize(); // 結果セットのリソースを解放
65
66        echo "\n--- アタッチされたデータベース ('{$attachedDbFile}', エイリアス: {$attachedDbAlias}) のデータ ---\n";
67        $resultAttached = $mainDb->query("SELECT * FROM {$attachedDbAlias}.secondary_table");
68        while ($row = $resultAttached->fetchArray(SQLITE3_ASSOC)) {
69            echo "ID: {$row['id']}, Value: {$row['value']}\n";
70        }
71        $resultAttached->finalize(); // 結果セットのリソースを解放
72
73        // 5. 不要になったらデータベースのアタッチを解除します (オプション)。
74        // DETACH DATABASE コマンドでアタッチを解除します。
75        $detachSql = "DETACH DATABASE {$attachedDbAlias};";
76        $mainDb->exec($detachSql);
77        echo "\nデータベース '{$attachedDbAlias}' のアタッチを解除しました。\n";
78
79    } catch (Exception $e) {
80        echo "エラーが発生しました: " . $e->getMessage() . "\n";
81    } finally {
82        // データベース接続がまだ開いている場合は閉じます。
83        if (isset($mainDb) && $mainDb instanceof SQLite3) {
84            $mainDb->close();
85            echo "メインデータベース '{$mainDbFile}' の接続を閉じました。\n";
86        }
87        echo "\nサンプル実行が完了しました。\n";
88        echo "生成されたファイル: {$mainDbFile}, {$attachedDbFile} は削除されずに残っています。\n";
89        echo "必要に応じて手動で削除してください。\n";
90    }
91}
92
93// 上記で定義した関数を実行します。
94manageAttachedSQLiteDatabases();

このサンプルコードは、PHPのSQLite3拡張機能を使用して、複数のSQLiteデータベースファイルを一つの接続内で連携させる「アタッチ」機能の使い方を解説しています。具体的には、SQLite3::exec()メソッドを使い、SQLのATTACH DATABASEコマンドを実行して、メインのデータベースに別のデータベースファイルを追加（連結）します。

この機能により、メインのデータベース接続を通じて、アタッチされたデータベース内のテーブルにもエイリアス（別名）を指定してアクセスできるようになります。サンプルでは、メインデータベースとアタッチされるデータベースそれぞれにテーブルを作成し、データを挿入した後、両方のデータベースからデータを参照する一連の流れが示されています。不要になったアタッチは、DETACH DATABASEコマンドで解除できます。この機能は、関連するデータを複数のファイルに分割しつつ、必要に応じて統合的に扱いたい場合に活用できます。

提供されたリファレンス情報にあるSQLite3::ATTACHという定数は、標準のPHP SQLite3クラスには直接定義されていませんが、このコードはSQLiteデータベースのATTACH機能そのものをPHPから操作する方法を示しています。

Copy
1<?php
2
3/**
4 * 指定されたファイルを添付してメールを送信する関数。
5 * システムエンジニアを目指す初心者向けに、PHPの組み込み関数と推奨スタイルで記述されています。
6 *
7 * @param string      $to         宛先メールアドレス
8 * @param string      $from       差出人メールアドレス
9 * @param string      $subject    メールの件名
10 * @param string      $message    メール本文（プレーンテキスト）
11 * @param string      $filePath   添付するファイルのパス
12 * @param string|null $fileName   添付ファイル名 (省略時は $filePath のファイル名を使用)
13 * @return bool メール送信が成功した場合は true、失敗した場合は false
14 */
15function sendEmailWithAttachment(
16    string $to,
17    string $from,
18    string $subject,
19    string $message,
20    string $filePath,
21    ?string $fileName = null // PHP 7.1以降のNULL許容型
22): bool {
23    // 添付ファイルの存在と読み取り可能性をチェック
24    if (!file_exists($filePath) || !is_readable($filePath)) {
25        error_log("Error: Attachment file not found or not readable: " . $filePath);
26        return false;
27    }
28
29    $fileName = $fileName ?? basename($filePath); // ファイル名が指定されていない場合はパスから抽出
30    $fileContent = file_get_contents($filePath);
31    $encodedFileContent = chunk_split(base64_encode($fileContent)); // ファイル内容をBase64エンコード
32
33    // 添付ファイルのMIMEタイプを判別（fileinfo拡張機能が推奨されます）
34    // fileinfoが利用できない場合は一般的なバイナリタイプを使用
35    $fileMimeType = (extension_loaded('fileinfo') && function_exists('mime_content_type'))
36                    ? mime_content_type($filePath)
37                    : 'application/octet-stream';
38
39    // メールコンテンツの各部分を区切るためのユニークな境界文字列を生成
40    $boundary = md5(time());
41
42    // メールヘッダーの準備
43    $headers = [
44        "From: $from",
45        "MIME-Version: 1.0",
46        "Content-Type: multipart/mixed; boundary=\"$boundary\"" // 複数のパートを持つメール形式を指定
47    ];
48    $headersString = implode("\r\n", $headers);
49
50    // メール本文の構築
51    // 1. プレーンテキストパート
52    $body = "--$boundary\r\n";
53    $body .= "Content-Type: text/plain; charset=\"UTF-8\"\r\n";
54    $body .= "Content-Transfer-Encoding: 8bit\r\n\r\n";
55    $body .= "$message\r\n\r\n";
56
57    // 2. 添付ファイルパート
58    $body .= "--$boundary\r\n";
59    $body .= "Content-Type: $fileMimeType; name=\"$fileName\"\r\n";
60    $body .= "Content-Transfer-Encoding: base64\r\n";
61    $body .= "Content-Disposition: attachment; filename=\"$fileName\"\r\n\r\n"; // 添付ファイルとして扱う
62    $body .= "$encodedFileContent\r\n\r\n";
63
64    $body .= "--$boundary--"; // 全体の終わりを示す境界
65
66    // PHPの mail() 関数を使用してメールを送信
67    // この関数はサーバーのメール設定に依存するため、より堅牢なメール送信にはPHPMailerなどのライブラリが推奨されます。
68    return mail($to, $subject, $body, $headersString);
69}
70
71// --- 使用例 ---
72// システムエンジニアを目指す初心者が動作を確認しやすいように、具体的な使用例を示します。
73
74// 1. テスト用のダミーファイルを作成します。
75$dummyFileName = "sample_document.txt";
76file_put_contents($dummyFileName, "これはPHPスクリプトから送信されるテスト添付ファイルの内容です。\n");
77
78// 2. メール送信に必要な情報を設定します。
79// ★★★ これらのプレースホルダーを実際のメールアドレスに置き換えてください ★★★
80$recipientEmail = "your_recipient@example.com"; // 受信者のメールアドレス
81$senderEmail = "your_sender@example.com";       // 送信者のメールアドレス（サーバーから許可されているアドレス）
82$emailSubject = "PHPからの添付ファイル付きテストメール";
83$emailBody = "こんにちは。\n\nこのメールはPHPスクリプトから自動的に送信されました。添付ファイルをご確認ください。\n\nよろしくお願いいたします。";
84$attachmentFilePath = $dummyFileName; // 添付するファイルのパス
85
86// 3. sendEmailWithAttachment 関数を実行し、メールを送信します。
87if (sendEmailWithAttachment($recipientEmail, $senderEmail, $emailSubject, $emailBody, $attachmentFilePath)) {
88    echo "メールが添付ファイル付きで正常に送信されました。\n";
89} else {
90    echo "メールの送信に失敗しました。サーバーのメール設定（sendmailなど）やPHPのエラーログを確認してください。\n";
91}
92
93// 4. 作成したダミーファイルを削除してクリーンアップします。
94if (file_exists($dummyFileName)) {
95    unlink($dummyFileName);
96}
97
98?>

このPHPコードは、指定されたファイルを添付してメールを送信する sendEmailWithAttachment という関数を定義し、その使用例を示したものです。

この関数は、宛先、差出人、件名、本文、添付するファイルのパスを引数として受け取ります。オプションで、メールに表示されるファイル名を指定することも可能です。関数の内部では、まずファイルが存在し読み取り可能かを確認します。次に、ファイルの内容をメールで安全に送信できるよう「Base64」という形式にエンコードします。メール本文と添付ファイルを一つのメールにまとめるため、「multipart/mixed」というMIME規格に従って、メールのヘッダー情報と本文を組み立てます。本文パートと添付ファイルパートは、それぞれ境界文字列によって区切られます。

すべての準備が整うと、PHPの標準関数である mail() を使用してメールを送信します。この関数は、メール送信処理が成功した場合は true を、失敗した場合は false を戻り値として返します。このサンプルは、PHPで添付ファイル付きメールを送信する基本的な仕組みを理解するのに役立ちます。