如何确定Laravel包开发所需的Composer依赖？

嘿，这个问题问到点子上了——不少刚上手Laravel包开发的朋友都会在依赖这块犯迷糊，我来一步步给你捋清楚：

1. 全局助手函数的归属问题 #

你说的storage_path()、config()这类全局助手函数，其实并不属于单独的illuminate/*组件包，它们是Laravel核心框架（也就是laravel/framework）特有的内容。Laravel框架在初始化的时候，会加载vendor/laravel/framework/src/Illuminate/Foundation/helpers.php这个文件，里面定义了这些全局助手。

那为什么你在包开发时有时候能直接用？因为你的包是在Laravel项目环境下测试的，框架已经帮你加载了这些函数。但如果把包放到非Laravel环境（比如纯Lumen或者自定义PHP项目），直接调用这些函数就会报错，因为它们不存在。

2. 为什么不直接依赖laravel/framework？ #

这涉及到包开发的一个核心原则：松耦合与轻量化。

• 如果你直接依赖整个Laravel框架，你的包会被迫引入框架的所有依赖，体积会变得很大，而且只能在完整的Laravel项目中使用，没法适配Lumen或者其他基于Illuminate组件的轻量项目。
• 只依赖你真正需要的illuminate/*组件，能让你的包更灵活，适用场景更广。比如只需要服务提供者就依赖illuminate/support，需要控制台命令就依赖illuminate/console，这样其他项目只要用到这些组件就能复用你的包。

3. 安全使用全局助手的替代方案 #

如果你的包需要用到config()、storage_path()这类功能，又不想依赖整个框架，有两种靠谱的方式：

方案一：先检查函数是否存在 #

如果你确定包大概率会在Laravel环境运行，但想兼容非Laravel场景，可以先做存在性判断：

$appName = function_exists('config') ? config('app.name') : 'Default App';
$storagePath = function_exists('storage_path') ? storage_path('logs') : __DIR__ . '/../storage/logs';

方案二：改用对应的Facade或类方法 #

Laravel的全局助手本质上是对应Facade或服务容器实例的快捷方式，你可以直接调用底层的类来实现相同功能，只需要依赖illuminate/support：

• config('key') → Illuminate\Support\Facades\Config::get('key')
• storage_path('path') → Illuminate\Support\Facades\App::make('path.storage') . '/path'（或者用Illuminate\Filesystem\Filesystem类来处理路径）

这样你的包只需要依赖illuminate/support，就能安全实现相同功能，同时保持兼容性。

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