PHP スカラー型と戻り値の型宣言

PHP 7 新特性PHP 7 の新機能


スカラー型宣言

デフォルトでは、すべての PHP ファイルは弱い型チェックモードです。

PHP 7 にはスカラー型宣言の機能が追加されました。スカラー型宣言には 2 つのモードがあります:

  • 強制モード (デフォルト)
  • 厳密モード

スカラー型宣言の構文形式:

declare(strict_types=1); 

コード内で strict_types の値 (1 または 0) を指定します。1 は厳密な型チェックモードを表し、関数呼び出しと return 文に適用されます。0 は弱い型チェックモードを表します。

使用できる型パラメータは次のとおりです:

  • int

  • float

  • bool

  • string

  • interfaces

  • array

  • callable

強制モードの例

例

<?php
// 強制モード
function sum(int ...$ints)
{
   return
array_sum($ints);
}

print(
sum(2, '3', 4.1));
?>

上記のプログラムを実行した出力結果は次のとおりです:

9

例では、パラメータ 4.1 を整数 4 に変換してから加算します。

厳密モードの例

例

<?php
// 厳密モード
declare(strict_types=1);

function
sum(int ...$ints)
{
   return
array_sum($ints);
}

print(
sum(2, '3', 4.1));
?>

上記のプログラムは厳密モードを採用しているため、パラメータに整数でない型が含まれるとエラーになります。実行出力結果は次のとおりです:

PHP Fatal error:  Uncaught TypeError: Argument 2 passed to sum() must be of the type integer, string given, called in……

戻り値の型宣言

PHP 7 では戻り値の型宣言のサポートが追加されました。戻り値の型宣言は、関数の戻り値の型を指定します。

宣言できる戻り値の型は次のとおりです:

  • int

  • float

  • bool

  • string

  • interfaces

  • array

  • callable

戻り値の型宣言の例

この例では、戻り値が整数であることが要求されます:

例

<?php
declare(strict_types=1);

function
returnIntValue(int $value): int
{
   return
$value;
}

print(
returnIntValue(5));
?>

上記のプログラムを実行した出力結果は次のとおりです:

5

戻り値の型宣言のエラー例

例

<?php
declare(strict_types=1);

function
returnIntValue(int $value): int
{
   return
$value + 1.0;
}

print(
returnIntValue(5));
?>

上記のプログラムは厳密モードを採用しているため、戻り値は int でなければなりませんが、計算結果は float であるためエラーになります。実行出力結果は次のとおりです:

Fatal error: Uncaught TypeError: Return value of returnIntValue() must be of the type integer, float returned...

void 関数

新しい戻り値の型 void が導入されました。戻り値の型が void として宣言されたメソッドは、return 文を完全に省略するか、空の return 文を使用します。void 関数の場合、NULL は有効な戻り値ではありません。

戻り値の型には void もあります。戻り値の型が void と定義された関数は return 値を返すことができず、null を返すこともできません。

void 関数は return 文を省略するか、空の return 文を使用できます。

例

<?php
function swap(&$left, &$right) : void
{
    if ($left === $right) {
        return;
    }

    $tmp = $left;
    $left = $right;
    $right = $tmp;
}

$a = 1;
$b = 2;
var_dump(swap($a, $b), $a, $b);

上記の例の出力結果:

null
int(2)
int(1)

PHP 7 新特性PHP 7 の新機能

その他の拡張