PHP 8：将“资源”分配为属性、参数或返回类型

如何解决PHP 8：将“资源”分配为属性、参数或返回类型

我正在将我的项目从 PHP 7.0 更新到 PHP 8.0，但我不知道是否允许明确指定 resource 作为数据类型：

属于类属性，
方法/函数参数，
由方法/函数返回,

我现在知道的是：

resource 是构建 mixed type 的类型之一，
一些内部函数，如 fopen，返回类型 resource。

直到现在我读到：

关于迁移到 PHP 8 的所有官方手册：PHP: Migrating from PHP 5.5.x to PHP 5.6.x,...,PHP: Migrating from PHP 7.4.x to PHP 8.0.x;
PHP.Watch: PHP Versions 上的全部内容；
Lindevs: PHP 上的全部内容。

我是不是在某处遗漏了什么？

感谢您抽出宝贵时间。

为了更清楚，这是我想在我的项目中使用 resource 数据类型的方式（psr-7 实现）：

<?PHP

namespace MyPackages\Http\Message;

use Psr\Http\Message\StreamInterface;

/**
 * Stream.
 */
class Stream implements StreamInterface {

    /**
     * A stream,e.g. a resource of type "stream".
     *
     * @var resource
     */
    private resource $stream;

    /**
     * @param string|resource $stream A filename,or an opened resource of type "stream".
     * @param string $accessMode (optional) Access mode. 'r': Open for reading only.
     */
    public function __construct(string|resource $stream,string $accessMode = 'r') {
        $this->stream = $this->buildStream($stream,$accessMode);
    }

    /**
     * Build a stream from a filename or an opened resource of type "stream".
     *
     * Not part of psr-7.
     *
     * @param string|resource $stream Filename,or resource.
     * @param string $accessMode Access mode.
     * @return resource
     * @throws \RuntimeException If the file cannot be opened.
     * @throws \invalidargumentexception If the stream or the access mode is invalid.
     */
    private function buildStream(string|resource $stream,string $accessMode): resource {
        if (is_string($stream)) {
            //... some validations ...

            /*
             * Open the file specified by the given filename.
             * E.g. create a stream from the filename.
             * E.g. create a resource of type "stream" from the filename.
             */
            try {
                $stream = fopen($stream,$accessMode);
            } catch (\Exception $exception) {
                throw new \RuntimeException('The file "' . $stream . '" Could not be opened.');
            }
        } elseif (is_resource($stream)) {
            if ('stream' !== get_resource_type($stream)) {
                throw new \invalidargumentexception('The provided resource must be an opened resource of type "stream".');
            }
        }

        return $stream;
    }
}

解决方法

不，您不能使用 resource 输入提示。

这是 2015 年提出的 RFC，这是带有实现的 PR，这是其上的 thread of discussion。

要点是 PHP 社区希望摆脱资源，因为它们代表了一种较旧的做事方式。此外，resource 过于笼统，基本上等同于 object，它没有提供太多好处（如果有的话）。

来自讨论：

这样做的原因是资源类型不合时宜 PHP 没有对象的时代，但仍然需要确定类型的数据不透明。资源类型是一种只存在于在内部函数之间混洗 C 指针。它没有语义价值。因为资源现在是多余的，鉴于存在对象，它们的时间不多了，它们将在某些时候被替换观点。为资源添加类型声明意味着代码使用如果我们将任何现有的资源使用替换为对象，防止从资源迁移

安德里亚·福尔德斯

和

长期计划是进行类似于 GMP 的过渡经历：它自 PHP 5.6 起使用 GMP 对象并使用资源之前。

...

除了 Andrea 所说的（导致问题的资源类型提示应该我们选择迁移到对象），我也认为资源类型提示本身提供的价值相对较小。它只说你是接受一些资源。但是，资源很多。这是一个文件吗处理？是数据库连接吗？它是流式散列上下文吗？它不说。

尼基塔波波夫