首页 > PHP 阅读:2

PHP声明参数类型

在 PHP 5 中已引入函数的参数类型声明,如果给定的值不是一个合法的参数类型,那么在 PHP 5 中会出现一个 Fatal error,在 PHP 7 中则会抛出一个 TypeError exception。

在 PHP 7 中增加了参数可声明的类型种类,如表所示。

参数可声明的类型
类型 说明 PHP 版本
class/interface name(类,接口) 参数必须是指定类或接口的实例 PHP 5.0.0
Array 参数为数组类型 PHP 5.1.0
Callable 参数为有效的回调类型 PHP 5.4.0
Bool 参数为布尔型 PHP 7.0.0
Float 参数为浮点型 PHP 7.0.0
Int 参数为整型 PHP 7.0.0
String 参数为字符串 PHP 7.0.0
class/interface name(类,接口) 参数必须是指定类或接口的实例 PHP 5.0.0
Array 参数为数组类型 PHP 5.1.0

指定参数类型为 class 类型的实例如下:
<?php
class C{}
class D extends C{}      //类D继承自类C
class E{}
functionf(C $c){
    echo get_class($c)."\n";
}
f(new C);
f(new D);
f(new E);
?>
执行以上程序的结果是:

C D
Fatal error: Uncaught TypeError: Argument 1 passed to f() must be an instance of C, instance of E given, called in /Library/WebServer/Documents/book/str.php on line 293 and defined in /Library/WebServer/Documents/book/str.php:287 Stack trace: #0 /Library/WebServer/Documents/book/str.php(293): f(Object(E)) #1 {main} thrown in /Library/WebServer/Documents/book/str.php on line 287

类型转换

默认情况下,当传递的参数不是函数指定的参数类型时,PHP 会尝试将所传参数转换成指定参数类型。例如,一个函数希望得到一个字符串类型的参数,但假如给其提供的是一个整型参数,PHP 就会自动将其转换成字符串类型,或者一个函数希望得到一个整型参数,但却给它传递了一个浮点型的参数。

示例如下:
<?php
function test(int $a, string $b, string $c){
    echo ($a + $b);
    echo " the string is $c";
}
test(3.8,2,'hello');
?>
执行以上代码的打印结果为:

5 the string is hello

注意,在将浮点型转成整型时,只取其中的整数部分。

严格模式

在 PHP 7 中,可以使用declare(strict_types=1)设置严格模式,这样只有在传递的参数与函数期望得到的参数类型一致时才能正确执行,否则会抛出错误。只有一种情况例外,就是当函数期望得到的是一个浮点型数据而提供的是整型时,函数也能正常被调用。

请看如下示例:
<?php
declare(strict_types=1);
function test(int $a, int $b, string $c){
    echo ($a + $b);
    echo " the string is $c";
}
test(3.8,2,'hello');
?>
此处 declare 声明了 PHP 为严格模式,而传入的参数与函数期望得到的参数类型不一致,所以会报错,如下所示:

Fatal error: Uncaught TypeError: Argument 1 passed to test() must be of the type integer, float given, called in /Library/WebServer/Documents/book/str.php on line 285 and defined in /Library/WebServer/Documents/book/str.php:281 Stack trace: #0 /Library/WebServer/Documents/book/str.php(285): test(3.8, 2, 'hello') #1 {main} thrown in /Library/WebServer/Documents/book/str.php on line 281