Composer怎么开发带有配置文件的扩展包-composer-PHP中文网

应将配置文件放在扩展包的 config/ 目录下（如 config/my-package.php），并通过框架的发布机制（如 laravel 的 php artisan vendor:publish）或手动引入，使主项目识别并加载。

composer怎么开发带有配置文件的扩展包

Composer 本身不处理配置文件加载，它只管把代码复制进 vendor。配置文件要生效，得靠框架（如 Laravel、ThinkPHP）或你手动在主项目中引入。所以“放哪”不重要，“怎么让框架读到”才是关键。

常见做法是把配置文件放在扩展包的 config/ 目录下，比如 config/my-package.php，内容为标准 PHP 数组返回：

<?php return [
    'enabled' => true,
    'timeout' => 30,
];

但仅放进去没用——必须显式发布或合并。不同框架机制不同，不能假设自动加载。

Laravel 要求你在服务提供者（ServiceProvider）中调用 publishes() 并注册 loadRoutesFrom() 或 mergeConfigFrom()，否则 php artisan vendor:publish 根本找不到你的配置。

必须满足以下条件：

composer.json 中 "type" 设为 "laravel-package"（非必需但利于生态识别）
服务提供者类里重写 boot() 方法，写明：$this->publishes([__DIR__.'/../config/my-package.php' => config_path('my-package.php')], 'my-package');
同时在 register() 或 boot() 中加：$this->mergeConfigFrom(__DIR__.'/../config/my-package.php', 'my-package');，否则首次运行时配置为空
主项目 config/app.php 的 providers 数组需手动添加该服务提供者（除非用了自动发现，且 composer.json 的 extra.laravel.providers 正确声明）

ThinkPHP 没有 publish 机制，依赖服务提供者中的 register() 方法手动加载。它不自动扫描 config/ 目录，也不读取 extra 配置。

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

典型写法是在服务提供者的 register() 中写：

$this->app->config->load(__DIR__.'/../config/my-package.php', 'my_package');

注意三点：

根本不是缓存问题，而是配置压根没被加载。Composer 安装后不会执行任何 PHP 逻辑，服务提供者不注册，配置就永远静默失效。

排查顺序如下：

确认主项目 composer.json 的 require 已写对包名，且已执行 composer update vendor/name（不是 install）
检查服务提供者是否在主项目配置中注册；Laravel 可运行 php artisan package:discover 强制刷新自动发现缓存
在服务提供者 boot() 或 register() 开头加 throw new \Exception('loaded');，看是否抛异常——不抛说明根本没被实例化
Windows 下 symlink 失败会导致 vendor/vendor/name 是复制体而非链接，改配置文件后实际改的是源目录，但主项目读的是旧副本；用 dir vendor\vendor\name 看是否为“快捷方式”类型