位于 ./foo/bar/utility/baz.php 的 Foo\Bar\Baz 类不符合 psr-4 自动加载标准。跳绳

Question

运行composer的update、install、require、dump-autoload等；我突然开始收到黄 色弃用通知，上面写着：

位于 ./foo/bar/utility/baz.php 的 FooBarBaz 类不符合 psr-4 自动加载标准。跳过。

在 Composer 2.0 之前，通常会得到：

弃用通知：位于 ./foo/bar/Baz.php 的 FooBarBaz 类不符合 psr-4 自动加载标准。 Composer v2.0 中将不再自动加载。在 phar:///usr/local/bin/composer/src/Composer/Autoload/ClassMapGenerator.php:201

为什么我会收到此通知或警告？我需要什么来摆脱它并为 Composer 2.0 做好准备？

Answer 1

就我而言，此错误是由文件 ./foo/bar/utility/baz.php 副本出现在升级位置 ./foo/bar/baz.php 引起的，无论出于何种原因。删除后者后，误导性错误就消失了。尽管我花了几个小时盯着小/大写路径名，但该文件最初没有任何问题。

Answer 2

发生这种情况的原因有多种。

重要的是注意错误消息，它通常非常准确指出问题的根源。

路径案例

最常见的原因是，如错误消息所示，Bar.php 路径名的不同组成部分的大小写与完全限定类的大小写不匹配姓名；

foo/bar/Baz.php 与 App\Bar\Baz 不匹配。

只需更新您的应用程序或包，以便每个路径组件与其所拥有的命名空间的大小写相匹配：

Foo\Bar\Baz.php

文件名和类名或命名空间差异

非常仔细地对照命名空间检查路径名。有时，您将类（或名称空间）命名为 FooBar，但其在磁盘上的路径是“foo-bar”，例如。或者只是出于任何原因，您的命名空间与文件的路径名不完全匹配。

这也会触发通知/警告。您需要重命名文件或重命名类（或命名空间）。

通常，更改路径或文件要容易得多，因为更改类或命名空间名称需要重构代码以匹配新名称，而更改路径不需要重构任何内容。

嵌套命名空间和缺少声明

假设您有：

"autoload": {
        "psr-4": {
            "Fizz\Buzz\": "src/"
        }
    },

以及类Dummy，在内部定义src/Buzz：

// src/Buzz/Dummy.php
namespace Fizz\Buzz

class Dummy {}

上面的方法可以工作，但是会像其他方法一样抛出通知。正确的做法是：

// src/Buzz/Dummy.php
namespace Fizz\Buzz\Buzz

class Dummy {}

您不仅需要对受影响的类进行更改，还需要对使用或导入此类的任何其他文件进行更改。 （例如，现在声明 use Fizz\Buzz\Buzz\Dummy;）。