【PHP8.x】PDO::CASE_UPPER定数の使い方

Copy
1<?php
2
3/**
4 * PDO::CASE_UPPER 定数の使用例を示すスクリプトです。
5 *
6 * この定数は、PDOでデータベースからデータをフェッチする際に、
7 * カラム名を大文字に変換するために使用されます。
8 * PDO::ATTR_CASE 属性に設定することで効果を発揮します。
9 */
10
11try {
12    // 1. データベース接続設定
13    // 単体で動作させるため、インメモリのSQLiteデータベースを使用します。
14    $dbFile = ':memory:';
15
16    // 2. PDOオプションを設定
17    // PDO::CASE_UPPER を PDO::ATTR_CASE に設定し、カラム名を大文字にします。
18    $options = [
19        PDO::ATTR_CASE         => PDO::CASE_UPPER,        // カラム名を大文字に変換
20        PDO::ATTR_ERRMODE      => PDO::ERRMODE_EXCEPTION, // エラー発生時に例外をスロー
21        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // デフォルトのフェッチモードを連想配列に
22    ];
23
24    // 3. データベースに接続
25    $pdo = new PDO("sqlite:$dbFile", null, null, $options);
26    echo "データベースに接続しました。\n";
27
28    // 4. サンプルテーブルを作成
29    $pdo->exec("
30        CREATE TABLE IF NOT EXISTS products (
31            id INTEGER PRIMARY KEY AUTOINCREMENT,
32            product_name TEXT NOT NULL,
33            price REAL
34        );
35    ");
36    echo "products テーブルを作成しました。\n";
37
38    // 5. サンプルデータを挿入
39    $pdo->exec("INSERT INTO products (product_name, price) VALUES ('Laptop', 1200.50);");
40    $pdo->exec("INSERT INTO products (product_name, price) VALUES ('Mouse', 25.00);");
41    echo "サンプルデータを挿入しました。\n";
42
43    // 6. データをフェッチし、カラム名を確認
44    echo "\nフェッチしたデータ:\n";
45    $stmt = $pdo->query("SELECT id, product_name, price FROM products;");
46    $products = $stmt->fetchAll();
47
48    foreach ($products as $product) {
49        echo " - ";
50        // フェッチしたデータのキー名（カラム名）を出力
51        foreach ($product as $key => $value) {
52            echo "{$key}: {$value} | ";
53        }
54        echo "\n";
55    }
56
57    echo "\n↑ カラム名 (ID, PRODUCT_NAME, PRICE) が全て大文字になっていることが確認できます。\n";
58
59} catch (PDOException $e) {
60    // データベース接続やクエリ実行中のエラーを捕捉
61    echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
62    exit(1);
63} catch (Exception $e) {
64    // その他の一般的なエラーを捕捉
65    echo "一般的なエラーが発生しました: " . $e->getMessage() . "\n";
66    exit(1);
67}
68
69?>

PDO::CASE_UPPERは、PHPのPDO（PHP Data Objects）拡張機能に定義されている定数の一つです。この定数自体は、引数を取らず、特定の値を返すこともありません。その主な役割は、データベースからデータを取得する際に、フェッチされる結果セットのカラム名をすべて大文字に変換するようPDOに指示することです。

具体的には、PDOインスタンスを生成する際のオプションとして、PDO::ATTR_CASE属性にPDO::CASE_UPPERを設定して使用します。これにより、例えばデータベースにproduct_nameというカラム名があっても、PHP側でデータを受け取る際にはPRODUCT_NAMEとして扱われるようになります。この機能は、異なるデータベースシステム間でのカラム名の表記ゆれを吸収したい場合や、アプリケーション内でカラム名を統一的に扱いたい場合に特に有用です。

提示されたサンプルコードでは、インメモリのSQLiteデータベースに接続し、productsテーブルを作成しています。データベース接続時にPDO::ATTR_CASEにPDO::CASE_UPPERを設定しているため、SELECT文でデータを取得した際に、元のid、product_name、priceといったカラム名が、それぞれID、PRODUCT_NAME、PRICEという大文字のキーとしてフェッチされる様子が確認できます。エラーが発生した場合には、try-catchブロックによって適切に捕捉し、メッセージを表示する仕組みも含まれています。

Copy
1<?php
2
3/**
4 * 指定された文字列の最初の文字を大文字に変換します。
5 *
6 * この関数は、PHPの組み込み関数 `ucfirst()` を使用して、
7 * 文字列の最初の文字のみを大文字にし、それ以降の文字は変更しません。
8 *
9 * @param string $inputString 変換する文字列。
10 * @return string 最初の文字が大文字になった文字列。
11 */
12function capitalizeFirstLetter(string $inputString): string
13{
14    // PHPの組み込み関数 `ucfirst()` は、与えられた文字列の最初の文字を大文字にします。
15    // 例: "hello world" は "Hello world" になります。
16    return ucfirst($inputString);
17}
18
19// --- サンプル使用例 ---
20
21$text1 = "hello php";
22$text2 = "programming is fun";
23$text3 = "another test string";
24$text4 = ""; // 空文字列の例
25$text5 = "123 starts with number"; // 数字で始まる文字列の例
26
27echo "元の文字列: \"" . $text1 . "\" -> 変換後: \"" . capitalizeFirstLetter($text1) . "\"\n";
28echo "元の文字列: \"" . $text2 . "\" -> 変換後: \"" . capitalizeFirstLetter($text2) . "\"\n";
29echo "元の文字列: \"" . $text3 . "\" -> 変換後: \"" . capitalizeFirstLetter($text3) . "\"\n";
30echo "元の文字列: \"" . $text4 . "\" -> 変換後: \"" . capitalizeFirstLetter($text4) . "\"\n"; // 空文字列はそのまま
31echo "元の文字列: \"" . $text5 . "\" -> 変換後: \"" . capitalizeFirstLetter($text5) . "\"\n"; // 数字で始まる場合は変化なし
32
33?>

このPHPサンプルコードは、与えられた文字列の最初の文字だけを大文字に変換する方法を示しています。capitalizeFirstLetterという名前のカスタム関数が定義されており、変換したい文字列を引数$inputStringとして受け取ります。

この関数はPHPの組み込み関数であるucfirst()を利用しています。ucfirst()関数は、引数で渡された文字列の最初の文字を大文字に変換し、それ以降の文字は元の状態を保ちます。例えば、「hello php」という文字列を与えると、「Hello php」というように、先頭の「h」だけが大文字になります。そして、変換された文字列を戻り値として返します。

コードの後半では、このcapitalizeFirstLetter関数の具体的な使用例がいくつか示されています。通常の文字列はもちろん、空文字列を与えた場合は何も変換されずそのまま返されます。また、数字で始まる文字列（例：「123 starts with number」）を与えた場合も、最初の文字が数字であるため変化しません。この関数は、表示用の文字列を整形する際や、入力されたデータの一貫性を保つためなど、さまざまな場面で役立ちます。