PHP 对象/枚举/资源/Callback / Callable

Object 对象

对象初始化

要创建一个新的对象 object，使用 new 语句实例化一个类：


<?php
class foo
{
    function do_foo()
    {
        echo "Doing foo."; 
    }
}

$bar = new foo;
$bar->do_foo();
?>

详细讨论参见手册中类与对象章节。

转换为对象

如果将一个对象转换成对象，它将不会有任何变化。如果其它任何类型的值被转换成对象，将会创建一个内置类 stdClass 的实例。如果该值为 null，则新的实例为空。 array 转换成 object 将使键名成为属性名并具有相对应的值。注意：在这个例子里，使用 PHP 7.2.0 之前的版本，数字键只能通过迭代访问。


<?php
$obj = (object) array('1' => 'foo');
var_dump(isset($obj->{'1'})); // PHP 7.2.0 后输出 'bool(true)'，之前版本会输出 'bool(false)' 
var_dump(key($obj)); // PHP 7.2.0 后输出 'string(1) "1"'，之前版本输出  'int(1)' 
?>

对于其他值，会包含进成员变量名 scalar。


<?php
$obj = (object) 'ciao';
echo $obj->scalar;  // 输出 'ciao'
?>

Enum 枚举

枚举基础

枚举是在类、类常量基础上的约束层，目标是提供一种能力：定义包含可能值的封闭集合类型。


<?php
enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
}

function do_stuff(Suit $s)
{
    // ...
}

do_stuff(Suit::Spades);
?>

类型转换

将 enum 转换为 object 不会有变化。将 enum 转换为 array，纯粹枚举会创建单个 name 键的数组；回退枚举创建带 name 和 value 键的数组。其他类型转换都会导致错误。

Resource 资源类型

资源 resource 是一种特殊变量，保存了到外部资源的一个引用。资源是通过专门的函数来建立和使用的。所有这些函数及其相应资源类型见附录。

参见 get_resource_type()。

转换为资源

由于资源类型变量保存有为打开文件、数据库连接、图形画布区域等的特殊句柄，因此将其它类型的值转换为资源没有意义。

释放资源

引用计数系统是 Zend 引擎的一部分，可以自动检测到一个资源不再被引用了（和 Java 一样）。这种情况下此资源使用的所有外部资源都会被垃圾回收系统释放。因此，很少需要手工释放内存。

Callback / Callable 类型

回调可以通过 callable 类型声明来表示。

一些函数如 call_user_func() 或 usort() 可以接受用户自定义的回调函数作为参数。回调函数不止可以是简单函数，还可以是对象的方法，包括静态类方法。

传递

PHP是将函数以string形式传递的。可以使用任何内置或用户自定义函数，但除了语言结构例如：array()，echo，empty()，eval()，exit()，isset()，list()，print 或 unset()。

一个已实例化的 object 的方法被作为 array 传递，下标 0 包含该 object，下标 1 包含方法名。在同一个类里可以访问 protected 和 private 方法。

静态类方法可以不实例化 object 传递，只需要在下标为 0 的位置传递类名而不是 object ，或者传递 'ClassName::methodName'。

回调参数不仅可以使用普通的用户自定义函数，也接受匿名函数和箭头函数。

注意:

从 PHP 8.1.0 开始，还可以使用 [First-class 可调用语法](https://www.php.net/manual/zh/functions.first_class_callable_syntax.php) 创建匿名函数。

通常情况下，任何实现了 __invoke() 的对象都可以传入回调参数。

示例 #1 回调函数示例


<?php 

// 回调函数示范
function my_callback_function() {
    echo 'hello world!';
}

// 回调方法示范
class MyClass {
    static function myCallbackMethod() {
        echo 'Hello World!';
    }
}

// 类型 1：简单的回调
call_user_func('my_callback_function'); 

// 类型 2：静态类方法回调
call_user_func(array('MyClass', 'myCallbackMethod')); 

// 类型 3：对象方法回调
$obj = new MyClass();
call_user_func(array($obj, 'myCallbackMethod'));

// 类型 4：静态类方法回调
call_user_func('MyClass::myCallbackMethod');

// 类型 5：父级静态类回调
class A {
    public static function who() {
        echo "A\n";
    }
}

class B extends A {
    public static function who() {
        echo "B\n";
    }
}

call_user_func(array('B', 'parent::who')); // A，从 PHP 8.2.0 起弃用。

// 类型 6：实现 __invoke 的对象用于回调
class C {
    public function __invoke($name) {
        echo 'Hello ', $name, "\n";
    }
}

$c = new C();
call_user_func($c, 'PHP!');
?>

示例 #2 使用 Closure 的示例


<?php
// 闭包
$double = function($a) {
    return $a * 2;
};

// 这是数字范围
$numbers = range(1, 5);

// 这里使用闭包作为回调，
// 将范围内的每个元素数值翻倍
$new_numbers = array_map($double, $numbers);

print implode(' ', $new_numbers);
?>

以上示例会输出：

2 4 6 8 10

>注意: 在函数中注册有多个回调内容时(如使用 call_user_func() 与 call_user_func_array())，如在前一个回调中有未捕获的异常，其后的将不再被调用。