BeyondCode/Expose 项目PHAR安装指南修正说明

问题背景

在使用BeyondCode/Expose项目时，用户slaFFik发现官方文档中关于PHAR(Php Archive)安装方式的命令存在错误。该问题主要影响Mac ARM64架构(M1/M2芯片)用户，使用PHP 8.2.28环境。

具体问题分析

官方文档当前提供的安装流程存在两个关键问题：

1. 文件命名不一致：通过curl下载PHAR文件时，默认保存为expose文件(无.phar扩展名)，但后续移动文件时却引用了expose.phar文件名，导致命令执行失败。

2. 命令不匹配：文档中sudo mv expose.phar /usr/local/bin/expose命令与实际情况不符，因为下载的文件名是expose而非expose.phar。

解决方案

针对这一问题，有两种可行的修正方案：

方案一：修改curl命令

curl -s https://expose.dev/install | php -d allow_url_fopen=1 -d detect_unicode=0 -- --install-dir=./ --filename=expose.phar

方案二：修改mv命令

sudo mv expose /usr/local/bin/expose

额外发现

另一位用户schonhoff还指出了项目dashboard中Composer安装命令的错误。官方文档中展示的是：

composer global require expose/expose

而正确的命令应该是：

composer global require exposedev/expose

项目维护者响应

项目维护者mechelon已经确认并修复了这些问题。这表明BeyondCode/Expose团队对用户反馈响应迅速，重视文档的准确性。

给开发者的建议

1. 在安装开源工具时，应仔细阅读文档但也要保持怀疑态度
2. 遇到安装问题时，可检查命令中的文件名是否与实际下载文件一致
3. 对于Composer包安装，确认包名称的正确性很重要
4. 发现问题时及时向项目方反馈，帮助改善开源生态

通过这次事件，我们看到了开源社区协作的力量，也提醒我们在技术文档编写时要更加严谨，特别是涉及具体命令时应该经过充分测试。