Composer 通过 autoload.files 可无条件自动加载指定 PHP 文件，需在 composer.json 中配置相对路径并运行 composer dump-autoload；文件仅初始化时加载一次，应仅含函数/常量定义，避免执行逻辑与语法错误。

Composer 可以通过 autoload.files 配置项自动加载指定的 PHP 文件（比如存放全局函数的 functions.php），这些文件会在每次 Composer 自动加载初始化时被无条件引入一次，适合放纯函数定义、常量或辅助代码。

在 composer.json 中配置 files autoload

编辑项目根目录下的 composer.json，在 autoload 字段中添加 files 数组，列出需自动加载的文件路径（相对于 composer.json 所在目录）：

{
  "autoload": {
    "files": [
      "src/helpers/functions.php",
      "src/constants.php"
    ]
  }
}

修改后运行：

composer dump-autoload

这样每次执行 require 'vendor/autoload.php' 时，上述文件就会被立即执行并载入函数/常量。

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

注意路径和执行时机

files 列表中的路径必须是真实存在的 PHP 文件，且不能包含语法错误，否则整个自动加载会失败；它们只会在 Composer 的 autoloader 初始化时加载一次，不会按需加载（即不支持“懒加载”）。

• 路径推荐用相对路径，避免硬编码绝对路径
• 文件内不要写执行逻辑（如 echo、new 实例等），只放函数声明、const 定义等无副作用代码
• 如果文件依赖其他类或函数，确保其加载顺序合理（files 按数组顺序依次引入）

开发中调试是否生效

可临时在 functions.php 里加一句 echo "functions loaded\n";，然后运行一个简单脚本测试：

<?php
require 'vendor/autoload.php';
// 若看到输出，说明 files 已生效
my_helper_function(); // 假设这是 functions.php 里定义的函数
?>

若没输出或报错，检查路径是否拼写正确、是否执行了 dump-autoload、是否有 PHP 语法问题。

基本上就这些 —— 不复杂但容易忽略路径和执行时机这两个关键点。