Composer如何引入本地文件夹中的PHP包（path源配置）-composer-PHP中文网

唯一有效的本地包引入方式是在根目录composer.json的repositories中添加type为"path"的条目；其他方式如改require块、加file://前缀或仅修改autoload均无效。

composer如何引入本地文件夹中的php包（path源配置）

直接在项目根目录的 composer.json 的 repositories 数组里加一条 "type": "path" 配置，是唯一能生效的方式；其他任何塞进 require、加 file://、改 autoload 的做法，全都不起作用。

这不是网络问题，而是本地包没被 Composer “看见”。常见原因有：

repositories 根本没配，或者配错位置（比如写在 require 里面、缩进不合法、JSON 语法错误）
本地包目录下的 composer.json 缺 name 字段，或大小写/斜杠和 require 中写的不一致（acme/utils ≠ Acme/Utils）
本地包没写 version，而你 require 的是具体版本号如 "1.0.0" —— path 仓库只认 *、dev-main、dev-develop 这类通配或分支别名
没在 repositories 顶部加 "packagist.org": false，Composer 卡在远程源超时，本地源根本没被扫描

硬写绝对路径在 Windows 和 Linux/macOS 上极易失效。关键原则是：路径必须指向一个**含合法 composer.json 的目录**，且格式要符合 JSON 规范。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

推荐用相对路径："url": "../my-local-package" 或 "url": "./packages/helper"，从项目根目录的 composer.json 所在位置算起
绝对路径在 Windows 必须用 C:/Users/xxx（正斜杠），不能用 C:\Users\xxx（反斜杠会被 JSON 解析为转义）
严禁加 file:// 前缀——Composer 会直接忽略该仓库
路径中含空格或中文？尽量避免；若必须，确保整个字符串被双引号包裹，且无非法字符

这不是自动加载缓存的问题，而是符号链接没刷新。path 类型包默认走 symlink，但链接只在 composer install 或 composer update vendor/name 时建立/更新。

首次引入后，运行 composer install 或 composer update vendor/name
后续修改本地包源码，**必须再运行 composer update vendor/name**（指定包名更快，避免全量更新）
composer dump-autoload 完全无效——它只刷新类映射，不重建链接或复制文件
想确认是否真链接成功：执行 ls -la vendor/vendor/name（Linux/macOS）或 dir vendor\vendor\name（Windows），输出应显示指向你本地路径的符号链接

最易被忽略的一点是：CI/CD 环境下 path 仓库必然失败，因为路径不存在；协作时若误提交到 Git，别人 composer install 就会卡住或报错。上线前务必移除 repositories 中的 path 配置。