返回对 PHP 中对象的引用

Question

我正在使用 PHP 5.2.14 和 PearLog 1.12.3。 Log.php 中的单例方法的最新文档(PEARLog) 指出：

您必须使用 $var = &Log::singleton() 语法。 前面没有与号 (&) 方法名称，你不会得到 参考;您将获得一份副本。

但是，这样做会产生以下警告：

严格注意：只有变量才应该 通过引用分配

---

此函数的来源是：

public static function singleton($handler, $name = '', $ident = '',
                                 $conf = array(), $level = PEAR_LOG_DEBUG)
{
    static $instances;
    if (!isset($instances)) $instances = array();

    $signature = serialize(array($handler, $name, $ident, $conf, $level));
    if (!isset($instances[$signature])) {
        $instances[$signature] = Log::factory($handler, $name, $ident,
                                              $conf, $level);
    }

    return $instances[$signature];
}

---

如果我删除 &并使用 just:

$var = Log::singleton()

那么我就不再收到警告了。另外，如果我这样做

$var = Log::singleton();
$var2 = Log::singleton();

，那么 $var === var2 的计算结果为 true。

---

问题：API 文档和警告哪个是正确的？ （如果函数返回一个对象，它不是一个引用吗？为什么我需要 & 符号？

Answer 1

PHP5 中对象传递的方式发生了根本性的改变。在 PHP4 中，它们总是按值传递，这意味着返回对象的函数或方法实际上是传递回对象的副本。这导致了“&”的使用运算符，强制函数通过引用返回对象。在 PHP5 中，对象始终通过引用传递。要创建对象的副本，您必须使用克隆运算符。

快速查看日志包的源代码后发现它保持了与 PHP4 的兼容性。我认为您不需要＆符号。 PHP5 将返回该对象的引用。您对“$var === $var2”的测试已证明该方法返回一个对象，并且该对象是对一个对象的引用。如果它们是对象的副本，则身份比较将评估为 false。

Answer 2

警告是正确的，API 文档已过时，自 PHP5 起通过引用返回对象。

Answer 3

在 PHP 5 中，处理引用的方式在 PHP 中发生了一些变化。现在，他们希望被调用函数决定按引用或按值返回，而不是调用者。
但通常 PHP 可以自己解决这个问题 - 就像你的情况一样，它确实检测到这两个是同一个对象。

有关 E_STRICT 的更多信息，请查看手册：http://www. php.net/manual/en/language.references.whatdo.php以及pear函数应该如何实现：http://www.php.net/manual/en/language.references.return.php 。 （在我看来，pear 的大部分部分都已经过时了，zend 框架现在涵盖了 pear 的大部分内容。）

编辑：引用的大型示例：

error_reporting(E_STRICT);
ini_set('display_errors', 1);

class Settings
{
    private static $_instance;

    public static function getInstance()
    {
        if(self::$_instance == null)
        {
            self::$_instance = new Settings();
        }

        return self::$_instance;
    }

    public static function &getInstanceByRef()
    {
        if(self::$_instance == null)
        {
            self::$_instance = new Settings();
        }

        return self::$_instance;
    }

    private $counter = 0;

    private function Settings()
    {
    }

    public function getCounter()
    {
        return $this->counter;
    }

    public function setCounter($value)
    {
        $this->counter = $value;
    }
}

$settings1 = Settings::getInstance();
$settings2 = Settings::getInstance();

echo $settings1->getCounter(); // 0
echo $settings2->getCounter(); // 0

$settings1->setCounter(42);

echo $settings1->getCounter(); // 42
echo $settings2->getCounter(); // 42

$settings3 = &Settings::getInstanceByRef(); // ref to private static $_instance !
$settings4 = &Settings::getInstanceByRef(); // ref to private static $_instance !

echo $settings3->getCounter(); // 42
echo $settings4->getCounter(); // 42

$settings3 = 5;
$settings5 = Settings::getInstance();
echo $settings5; // 5 

正如您所见，即使没有引用， getInstance 也会被作为引用处理。如果要使用引用，则调用者和被调用函数都必须标记为引用。

作为警告：通过引用返回可能会导致很难发现错误：通过引用返回允许我覆盖保存 var 的私有实例。 PHP 中的预期行为是 $settings3 为 5，但不是私有静态 $_instance；这可能会导致非常不可预测的代码。