PHPでプログラミングをしていると、変数の型を確認する必要がある場面に遭遇することがあります。特に「スカラー値」かどうかを判定したい時に便利なのが is_scalar() 関数です。この記事では、PHPの is_scalar() 関数について、初心者にも分かりやすく詳しく解説します。
is_scalar関数とは？
is_scalar() 関数は、指定された値がスカラー値（scalar value）かどうかを判定するPHPの組み込み関数です。スカラー値とは、単一の値を持つデータ型のことを指します。
基本的な構文
is_scalar(mixed $value): bool
- 引数: 判定したい値
- 戻り値: スカラー値の場合は
true、そうでなければfalse
スカラー値に含まれるデータ型
is_scalar() 関数が true を返すのは、以下の4つのデータ型のみです：
1. 文字列（string）
var_dump(is_scalar("Hello World")); // bool(true)
var_dump(is_scalar('')); // bool(true)
2. 整数（integer）
var_dump(is_scalar(42)); // bool(true)
var_dump(is_scalar(-100)); // bool(true)
var_dump(is_scalar(0)); // bool(true)
3. 浮動小数点数（float）
var_dump(is_scalar(3.14)); // bool(true)
var_dump(is_scalar(-2.5)); // bool(true)
4. 真偽値（boolean）
var_dump(is_scalar(true)); // bool(true)
var_dump(is_scalar(false)); // bool(true)
スカラー値ではないデータ型
以下のデータ型は is_scalar() 関数で false を返します：
配列（array）
var_dump(is_scalar([])); // bool(false)
var_dump(is_scalar([1, 2, 3])); // bool(false)
オブジェクト（object）
$obj = new stdClass();
var_dump(is_scalar($obj)); // bool(false)
NULL
var_dump(is_scalar(null)); // bool(false)
リソース（resource）
$file = fopen('test.txt', 'r');
var_dump(is_scalar($file)); // bool(false)
実用的な使用例
例1: 関数の引数チェック
function processValue($value) {
if (!is_scalar($value)) {
throw new InvalidArgumentException('引数はスカラー値である必要があります');
}
// スカラー値の処理を続行
return "処理された値: " . $value;
}
// 使用例
try {
echo processValue("テスト"); // 正常に動作
echo processValue([1, 2, 3]); // 例外が発生
} catch (InvalidArgumentException $e) {
echo $e->getMessage();
}
例2: データベース値の検証
function sanitizeForDatabase($data) {
$cleanData = [];
foreach ($data as $key => $value) {
if (is_scalar($value)) {
// スカラー値のみエスケープ処理
$cleanData[$key] = htmlspecialchars($value, ENT_QUOTES, 'UTF-8');
} else {
// 非スカラー値は除外またはエラー処理
throw new Exception("非スカラー値が検出されました: $key");
}
}
return $cleanData;
}
例3: 配列の中身をチェック
function checkArrayContents($array) {
$scalarCount = 0;
$nonScalarCount = 0;
foreach ($array as $item) {
if (is_scalar($item)) {
$scalarCount++;
} else {
$nonScalarCount++;
}
}
return [
'scalar_items' => $scalarCount,
'non_scalar_items' => $nonScalarCount
];
}
// 使用例
$mixedArray = [
'name' => 'John',
'age' => 30,
'scores' => [85, 92, 78],
'active' => true,
'profile' => new stdClass()
];
$result = checkArrayContents($mixedArray);
print_r($result);
// 出力: Array ( [scalar_items] => 3 [non_scalar_items] => 2 )
他の型判定関数との比較
PHPには多くの型判定関数があります。is_scalar() と他の関数の違いを理解しておきましょう：
| 関数 | 判定対象 | 例 |
|---|---|---|
is_scalar() | スカラー値全般 | string, int, float, bool |
is_string() | 文字列のみ | “Hello” |
is_int() | 整数のみ | 42 |
is_float() | 浮動小数点数のみ | 3.14 |
is_bool() | 真偽値のみ | true, false |
is_array() | 配列のみ | [1, 2, 3] |
is_object() | オブジェクトのみ | new stdClass() |
注意点とベストプラクティス
1. NULLはスカラー値ではない
// よくある間違い
$value = null;
if (is_scalar($value)) {
// この処理は実行されない
echo "スカラー値です";
}
2. 文字列化可能なオブジェクトでも false
class ToString {
public function __toString() {
return "文字列化されたオブジェクト";
}
}
$obj = new ToString();
var_dump(is_scalar($obj)); // bool(false)
var_dump(is_scalar((string)$obj)); // bool(true)
3. 型の厳密な判定が必要な場合
// より厳密な判定が必要な場合
function isStrictScalar($value) {
return is_scalar($value) && !is_bool($value);
}
// 真偽値を除外したい場合
function isValueScalar($value) {
return is_string($value) || is_int($value) || is_float($value);
}
まとめ
is_scalar() 関数は、PHPで変数がスカラー値（string、int、float、bool）かどうかを判定する便利な関数です。データバリデーション、引数チェック、配列処理などで活用することで、より堅牢なPHPアプリケーションを構築できます。
重要なポイント：
- スカラー値は string、int、float、bool の4つのみ
- 配列、オブジェクト、NULL、リソースは非スカラー値
- 他の型判定関数と組み合わせてより細かい制御が可能
これらの知識を活用して、型安全なPHPコードを書いていきましょう！
