本地包需在项目composer.json的repositories中配置path类型及相对路径，require中声明包名；启用symlink须设preferred-install为source并初始化git；autoload映射错误或未执行dump-autoload会导致类找不到。

本地包怎么配进项目 composer.json？

直接在项目根目录的 composer.json 里加 repositories 段，类型设为 path，url 填相对路径（比如 "../my-utils"），再在 require 里写对应包名（如 "vendor/my-utils": "*"）。url 不能用绝对路径，Windows 下也别写 C: 开头；本地包自己的 composer.json 必须有合法 name 和 version（哪怕写 "dev-main"），否则 Composer 匹配失败。

为什么 composer install 后没生成软链接？

默认行为是硬拷贝——整个本地包被复制进 vendor/，改源码不会实时生效。要启用 symlink，必须两步到位：
• 运行 composer config --local preferred-install '{"*": "source"}'
• 在本地包根目录初始化 Git：git init && git add . && git commit -m "init"
Windows 用户还得确认开了开发者模式或以管理员身份运行终端，否则系统拒绝创建符号链接。

btpanel phpsite 宝塔面板PHP网站

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

下载

composer require 能不能跳过 repositories 直接写路径？

不能。require 字段只认包名，不接受文件路径。你写 composer require ../my-local-package 会报错 Could not parse version constraint。必须先配好 repositories，再执行 composer require vendor/name，让 Composer 自动关联到你声明的 path 仓库。

装完类找不到，是不是 autoload 没配对？

很可能是。本地包的 composer.json 里 autoload 配置必须正确，比如 PSR-4 映射要覆盖实际源码路径："autoload": {"psr-4": {"MyVendor\": "src/"}}。改完本地包的 autoload 后，别忘了在项目根目录运行 composer dump-autoload 刷新自动加载映射——否则即使路径对了，new MyVendorSomeClass() 仍会报 Class not found。

路径、Git 初始化、autoload 刷新这三处最容易漏掉，缺一不可。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！