如何在Composer中自动加载PHP包的工具函数

看起来你遇到的核心问题是包内composer.json的自动加载配置有语法错误，导致utilities.php没被Composer自动引入。咱们一步步来搞定它：

首先先修正你当前composer.json里的几个语法问题：

• files: 这个键名的写法不对，应该是带双引号的 "files"
• psr-0 区块的配置缺了闭合的引号和大括号："PackageName_": "src 要改成 "PackageName_": "src"

修正后的包内composer.json自动加载配置 #

把autoload区块改成下面这样就对了：

{
  "name": "packageauthor/packagename",
  ...
  "autoload": {
    "files": ["src/utilities.php"],
    "psr-0": {
      "PackageName_": "src"
    },
    "psr-4": {
      "PackageName\\": "src"
    }
  }
}

为什么这样配置能解决问题？ #

Composer的files自动加载机制会把你指定的文件自动加入到生成的vendor/autoload.php里——不管是你的包内部代码，还是安装了这个包的父项目，只要引入了vendor/autoload.php，utilities.php里的函数就会被自动加载，再也不用手动写require_once了。

接下来要做的操作 #

1. 在你的包根目录运行这个命令，重新生成自动加载文件：

composer dump-autoload

这一步是让Composer识别你更新后的配置。

2. 到父项目里更新依赖，让新的自动加载配置生效：

composer update packageauthor/packagename

如果是本地开发的包，也可以直接在父项目里运行composer dump-autoload来刷新自动加载缓存。

验证效果 #

• 包内的SomeClass.php可以删掉手动的require_once 'utilities.php';了，直接用use function引入函数就行：

namespace PackageName;

use function PackageName\utilities\functionName;

class SomeClass {
    function methodName() {
        functionName();
    }
}

• 父项目的index.php现在也能直接调用工具函数，不会再报致命错误了：

require_once 'vendor/autoload.php';

use PackageName\SomeClass;
use function PackageName\utilities\functionName;

new SomeClass(); // 正常运行
functionName(); // 现在也能正常执行啦

额外提醒 #

完全不需要在父项目的composer.json里额外配置files字段，因为包的自动加载配置会被Composer自动合并到整个项目的自动加载体系中——这才是Composer包开发的最佳实践，把包的自动加载逻辑封装在自己的composer.json里，不用使用者额外折腾。

内容的提问来源于stack exchange，提问作者user2791747