PHP関数パラメータータイプ仕様ガイド：コード品質を改善するための実用的なヒント

M66 2025-07-28

PHPの関数パラメーターのデフォルトタイプを指定すると、コードの読みやすさと保守性を向上させるだけでなく、タイプチェックメカニズムを強化して、タイプエラーを効果的に防止します。このようにして、PHP開発者は、予想される入力タイプの関数をより明確に定義し、ランタイムエラーを減らすことができます。

PHP 7.0から始めて、開発者は関数定義のパラメーターについてタイプを直接宣言し、戻り値タイプを設定できます。構文は次のとおりです。

 function funcName(type $paramName, type $paramName2): type
{
    // コード本体
}

このタイプの宣言は、 int 、 string 、 bool 、 array 、 floatなどの基本的なタイプをカバーでき、クラスまたはインターフェイスタイプにも使用できます。

デフォルトのタイププロンプトを使用して、関数パラメーターを文字列に強制する方法を示す実用的な例を次に示します。

 function toUpperCase(string $name): string
{
    return strtoupper($name);
}

この関数では、文字列型パラメーターを渡す必要があります。そうしないと、関数の入力が常に期待を満たすようにタイプエラーがトリガーされます。

PHPは、デフォルト値のパラメーターのタイププロンプトの指定もサポートしています。たとえば、次の関数には、オプションの整数型パラメーターが含まれています。

 function greet(string $name, int $age = 0): void
{
    // コード本体
}

$ ageパラメーターが提供されていない場合でも、関数はタイプの一貫性を維持しながらデフォルト値0を使用します。

PHP関数パラメーターのデフォルトタイプを指定することにより、コードの品質を効果的に改善し、潜在的なタイプエラーを減らすことができます。このアプローチは、中規模および大規模なプロジェクトにとって特に重要であり、チームメンバーがコードの意図をより速く、維持と拡大しやすく理解するのに役立ちます。