【PHP8.x】SQLite3::OK定数の使い方

Copy
1<?php
2
3// SQLite3 データベースを操作するサンプル
4// SQLite3::OK は、操作が成功したことを示す定数です。
5function checkSQLiteOperationStatus(SQLite3 $db, string $query): bool
6{
7    $result = $db->exec($query);
8
9    // exec() が成功した場合、trueを返す
10    if ($result) {
11        return true;
12    } else {
13        // エラーが発生した場合、エラーコードとメッセージを表示
14        error_log("SQLite error: " . $db->lastErrorMsg());
15        return false;
16    }
17}
18
19// データベースファイルを作成 (または既存のものを開く)
20$db = new SQLite3('my_database.db');
21
22// テーブルを作成
23$createTableQuery = 'CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER)';
24if (checkSQLiteOperationStatus($db, $createTableQuery)) {
25    echo "Table created/checked successfully.\n";
26} else {
27    echo "Table creation/check failed.\n";
28}
29
30
31// データを挿入
32$insertQuery = "INSERT INTO users (name, age) VALUES ('John Doe', 30)";
33if (checkSQLiteOperationStatus($db, $insertQuery)) {
34    echo "Data inserted successfully.\n";
35} else {
36    echo "Data insertion failed.\n";
37}
38
39// データベースを閉じる
40$db->close();
41
42?>

このサンプルコードは、PHPでSQLite3データベースを操作する方法を示しています。SQLite3::OKは、SQLite3の操作が成功したかどうかを判定するために使用できる定数です。厳密な比較(=ではなく==や===)には使用できませんが、操作が成功したかどうかを簡易的にチェックする際に役立ちます。

checkSQLiteOperationStatus関数は、データベース操作（ここではSQLクエリの実行）の成否を確認する関数です。引数としてSQLite3オブジェクトとSQLクエリを受け取ります。$db->exec($query)を実行し、クエリが成功した場合はtrueを返します。エラーが発生した場合は、エラーメッセージをログに出力し、falseを返します。

サンプルコードでは、まずSQLite3オブジェクトを作成してデータベースファイルを開きます（存在しない場合は作成します）。次に、checkSQLiteOperationStatus関数を使って、usersテーブルを作成するSQLクエリを実行します。同様に、データを挿入するSQLクエリも実行します。最後に、$db->close()でデータベース接続を閉じます。

この例ではSQLite3::OKの直接的な利用はありませんが、データベース操作が成功したかどうかを判定し、エラーハンドリングを行う基本的な流れを理解できます。SQLite3::OKは、SQLite3の他の関数が成功を示す特定の整数値を返す場合に、その値と比較するために使用できます。

Copy
1<?php
2
3/**
4 * SQLite3データベースに安全にお金を出し入れするサンプル
5 */
6class MoneyTransaction
7{
8    private SQLite3 $db;
9
10    public function __construct(string $dbPath)
11    {
12        try {
13            $this->db = new SQLite3($dbPath);
14        } catch (Exception $e) {
15            die("データベース接続エラー: " . $e->getMessage());
16        }
17    }
18
19    public function __destruct()
20    {
21        $this->db->close();
22    }
23
24    /**
25     * 指定された金額を入金します。
26     *
27     * @param string $account 口座名
28     * @param float $amount 入金額
29     * @return bool 成否
30     */
31    public function deposit(string $account, float $amount): bool
32    {
33        if ($amount <= 0) {
34            echo "入金額は正の数である必要があります。\n";
35            return false;
36        }
37
38        $sql = "UPDATE accounts SET balance = balance + :amount WHERE account_name = :account";
39        $stmt = $this->db->prepare($sql);
40        $stmt->bindValue(':amount', $amount, SQLITE3_FLOAT);
41        $stmt->bindValue(':account', $account, SQLITE3_TEXT);
42
43        $result = $stmt->execute();
44
45        if ($result === false) {
46            echo "入金処理エラー: " . $this->db->lastErrorMsg() . "\n";
47            return false;
48        }
49
50        return true;
51    }
52
53    /**
54     * 指定された金額を引き出します。
55     *
56     * @param string $account 口座名
57     * @param float $amount 引き出し額
58     * @return bool 成否
59     */
60    public function withdraw(string $account, float $amount): bool
61    {
62        if ($amount <= 0) {
63            echo "引き出し額は正の数である必要があります。\n";
64            return false;
65        }
66
67        // 残高確認
68        $balance = $this->getBalance($account);
69        if ($balance === false || $balance < $amount) {
70            echo "残高不足です。\n";
71            return false;
72        }
73
74        $sql = "UPDATE accounts SET balance = balance - :amount WHERE account_name = :account";
75        $stmt = $this->db->prepare($sql);
76        $stmt->bindValue(':amount', $amount, SQLITE3_FLOAT);
77        $stmt->bindValue(':account', $account, SQLITE3_TEXT);
78
79        $result = $stmt->execute();
80
81        if ($result === false) {
82            echo "引き出し処理エラー: " . $this->db->lastErrorMsg() . "\n";
83            return false;
84        }
85        return true;
86    }
87
88    /**
89     * 口座の残高を取得します。
90     *
91     * @param string $account 口座名
92     * @return float|bool 残高 (失敗時はfalse)
93     */
94    public function getBalance(string $account): float|bool
95    {
96        $sql = "SELECT balance FROM accounts WHERE account_name = :account";
97        $stmt = $this->db->prepare($sql);
98        $stmt->bindValue(':account', $account, SQLITE3_TEXT);
99        $result = $stmt->execute();
100
101        if ($result === false) {
102            echo "残高取得エラー: " . $this->db->lastErrorMsg() . "\n";
103            return false;
104        }
105
106        $row = $result->fetchArray(SQLITE3_ASSOC);
107
108        if ($row === false) {
109            echo "口座が見つかりません。\n";
110            return false;
111        }
112
113        return (float)$row['balance'];
114    }
115}
116
117// データベースファイルのパス
118$dbPath = 'money.db';
119
120// MoneyTransactionクラスのインスタンスを作成
121$transaction = new MoneyTransaction($dbPath);
122
123// テスト用口座
124$account = 'test_account';
125
126// 初期残高
127if ($transaction->getBalance($account) === false) {
128    // 口座が存在しない場合は作成
129    $db = new SQLite3($dbPath);
130    $db->exec("CREATE TABLE IF NOT EXISTS accounts (account_name TEXT PRIMARY KEY, balance REAL)");
131    $stmt = $db->prepare("INSERT INTO accounts (account_name, balance) VALUES (:account, :balance)");
132    $stmt->bindValue(':account', $account, SQLITE3_TEXT);
133    $stmt->bindValue(':balance', 0.0, SQLITE3_FLOAT);
134    $stmt->execute();
135    $db->close();
136}
137
138// 入金処理
139if ($transaction->deposit($account, 100.50)) {
140    echo "入金成功\n";
141}
142
143// 残高表示
144$balance = $transaction->getBalance($account);
145if ($balance !== false) {
146    echo "口座 " . $account . " の残高: " . $balance . "\n";
147}
148
149// 引き出し処理
150if ($transaction->withdraw($account, 50.25)) {
151    echo "引き出し成功\n";
152}
153
154// 残高表示
155$balance = $transaction->getBalance($account);
156if ($balance !== false) {
157    echo "口座 " . $account . " の残高: " . $balance . "\n";
158}
159?>

このPHPサンプルコードは、SQLite3データベースを使ってお金の入出金を行うMoneyTransactionクラスを定義し、その使い方を示しています。

MoneyTransactionクラスは、コンストラクタで指定されたパスのSQLite3データベースに接続し、デストラクタで接続を閉じます。

deposit()メソッドは、指定された口座に指定された金額を入金します。引数には口座名（文字列）と入金額（float型）を指定します。入金額は正の数である必要があります。成功時にはtrue、失敗時にはfalseを返します。

withdraw()メソッドは、指定された口座から指定された金額を引き出します。引数には口座名（文字列）と引き出し額（float型）を指定します。引き出し額は正の数である必要があり、残高が不足している場合は失敗します。成功時にはtrue、失敗時にはfalseを返します。

getBalance()メソッドは、指定された口座の残高を取得します。引数には口座名（文字列）を指定します。成功時には残高（float型）、口座が見つからない場合やエラーが発生した場合はfalseを返します。

サンプルコードでは、MoneyTransactionクラスのインスタンスを作成し、入金、残高確認、引き出しの処理を行い、結果を表示しています。初期残高がない場合は、口座を作成します。SQLインジェクションを防ぐため、プリペアドステートメントを使用しています。SQLITE3_FLOATやSQLITE3_TEXTは、値をSQLに安全に埋め込むためのSQLite3の定数です。このサンプルを通じて、PHPでデータベースを操作し、お金の出し入れを安全に行う方法を学ぶことができます。