GoDaddy虚拟主机中Composer执行删除/移动命令报错排查

背景 #

我通过PuTTY经SSH在GoDaddy共享主机（PHP 8.2版本，已开启SSH访问）安装了Composer 2.6.5，安装过程无报错，执行的命令如下：

cd ~
curl -sS https://getcomposer.org/installer | php
mv composer.phar composer
chmod +x composer

但尝试用Composer安装或更新Drupal模块（比如composer require drupal/views_bulk_operations）时，出现文件删除权限错误：

In Filesystem.php line 288:
  Could not delete /home/username/public_html/drupal/sites/default/default.services.yml:

疑问解答 #

1. 该问题是否由共享主机的文件系统限制导致？ #

是。共享主机为了保障多用户环境的安全性，会严格限制文件的所有权和权限范围。出现删除文件失败的情况，大概率是当前SSH用户对目标文件没有写入/删除权限，或者文件的所有者是Web服务器进程（如apache、nginx）而非SSH登录用户。

2. 检查和修改文件/目录权限的SSH命令 #

• 查看权限与所有者：

# 查看单个文件的权限、所有者及所属组
ls -l /home/username/public_html/drupal/sites/default/default.services.yml

# 查看目标目录下所有文件的详细权限信息
ls -la /home/username/public_html/drupal/sites/default/

• 调整文件权限：

# 给目标文件添加所有者可写权限
chmod u+w /home/username/public_html/drupal/sites/default/default.services.yml

# 若需要递归给目录下所有文件添加所有者可写权限（谨慎使用，避免过度开放）
chmod -R u+w /home/username/public_html/drupal/sites/default/

注意：共享主机通常不允许普通用户使用chown命令修改文件所有者，因为服务器会统一管理用户权限池。如果调整权限后仍无法解决问题，需要联系主机商确认文件所有权是否正确配置。

3. 是否需要确认或更新其他服务器端依赖？ #

需要做以下排查：

• 检查解压工具：
  Composer依赖7z、gzip、tar等解压工具，可通过以下命令检查是否存在：

which 7z gzip tar unrar unzip xz

如果某个工具缺失，可联系GoDaddy主机商安装；临时方案可尝试添加--no-scripts参数执行Composer命令，但可能导致模块安装不完整，不推荐长期使用。

• 检查PHP配置：
  执行php -i > phpinfo.txt生成PHP配置文件，查看其中的disable_functions、open_basedir项：
  • 确认exec、shell_exec等Composer需要的函数未被禁用；
  • 确认Drupal安装目录在open_basedir允许的访问范围内。

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