树莓派装 composer 卡在 downloading 是因默认境外源、arm 性能弱、sd 卡 io 差，必须强制 prefer-dist、并发设 3、换阿里云镜像、禁用 git clone 才可稳定运行。
树莓派上装 Composer 为什么总卡在 downloading？
因为默认源走境外 CDN，树莓派 ARM 架构 + 4G 内存 + SD 卡 IO 性能弱，composer install 容易超时或 OOM。必须关掉 git clone、强制用 dist、限并发、换镜像——不是可选项，是硬性前提。
- 先确认 PHP CLI 可用：
php -v（需 ≥7.4，推荐 PHP 8.2+；树莓派 OS Bookworm 自带 PHP 8.2） - 检查必要扩展：
php -m | grep -E "openssl|curl|zip|mbstring"，缺哪个就sudo apt install php-<em>扩展名</em> - 禁用 git 克隆（避免编译慢）：
composer config -g prefer-dist true - 设最大并发为 3（树莓派 4B/4GB 建议值）：
composer config -g parallel-downloads 3 - 换阿里云镜像（比 ustc 更稳）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
ARM 系统下不能直接用官方 installer 脚本？
可以，但别用 curl | php 一键方式——它默认校验 SHA-384，而树莓派 OpenSSL 版本旧时可能报 hash_file(): Unknown hashing algorithm: sha384 错误。手动分步更可控。
- 下载安装器：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 跳过校验（仅限内网可信环境）：
php composer-setup.php --quiet --install-dir=/usr/local/bin --filename=composer - 或手动校验（推荐）：从 官网查最新 SHA-384 值，再运行：
php -r "if (hash_file('sha384', 'composer-setup.php') === '<em>官网给出的哈希值</em>') { echo 'OK'; } else { echo 'FAIL'; }" - 移动并赋权：
sudo mv /usr/local/bin/composer /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer
SD 卡寿命和 Composer 缓存怎么平衡？
Composer 默认把 zip 包和元数据缓存在 ~/.composer/cache，频繁写入会加速 microSD 卡磨损。不清理不行，全放内存又怕重启丢数据。
- 把缓存软链到 RAM 盘（安全且有效）：
sudo mkdir -p /mnt/ramdisk && sudo mount -t tmpfs -o size=256M tmpfs /mnt/ramdisk && ln -sf /mnt/ramdisk/composer ~/.composer/cache - 开机自动挂载：把上面
mount行加进/etc/fstab（注意权限和 uid） - 禁用插件自动更新（减少后台写）：
composer config -g disable-tls false不要设 true；反而要确保disable-tls是 false，否则某些国内镜像会因证书问题 fallback 到慢路径 - 每次
composer install加--no-dev --no-autoloader --no-scripts，尤其部署到设备时
物联网项目里 require 的包为何总装不上？
不是网络问题，大概率是包本身不兼容 ARM 或含 x86-only 扩展（比如某些图像处理库、Swoole 预编译二进制）。Composer 不报错，但 vendor/autoload.php 引入时报 undefined symbol 或 failed to open stream。
- 优先选纯 PHP 实现的替代包：比如用
spatie/image替代intervention/image（后者依赖系统 ImageMagick） - 检查包是否声明支持
arm64或arm：composer show vendor/package --all | grep platform - 避免
require-dev里的工具链类包（如phpunit/phpunit）进生产环境，用--no-dev隔离 - 若必须用含扩展的包（如
ext-mbstring已启用），确认树莓派系统已装对应 lib：sudo apt install php-mbstring
树莓派跑 Composer 不是“能不能”，而是“怎么控住资源边界”。重点不在装上，而在让每次 install 可预测、可复现、不伤卡。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
