Yii2接收Android端Base64图片上传失败：file_put_contents报错求助

我来帮你搞定这个问题！你遇到的错误其实是路径别名用错了，再加上几个关键细节没处理到位，咱们一步步来解决：

1. 修正路径别名（核心问题） #

你用的@web是Web访问的URL路径（比如http://yourdomain.com），但file_put_contents需要的是服务器本地文件系统的绝对路径。Yii2里对应的正确别名是@webroot，它指向Web根目录的本地绝对路径（比如/var/www/html/web）。所以第一步要把路径改成：

$savePath = Yii::getAlias('@webroot/uploads/img.png');

2. 确保uploads目录存在且有写入权限 #

如果web/uploads目录不存在，或者服务器进程没有写入权限，也会报找不到目录的错误。可以在代码里自动递归创建目录：

$uploadDir = Yii::getAlias('@webroot/uploads');
// 检查目录是否存在，不存在则创建，权限设为0755（可根据服务器配置调整）
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

另外，要确保服务器的Web进程（比如www-data、apache）对这个目录有写入权限，你可以通过服务器终端执行chown -R www-data:www-data /path/to/web/uploads来设置权限。

3. 移除Base64内容的前缀（常见坑） #

Android端传过来的Base64字符串通常会带前缀，比如data:image/png;base64,，直接解码会导致图片损坏或者写入失败。所以要先移除这个前缀：

// 检查并移除Base64前缀
if (str_starts_with($detail, 'data:image/')) {
    $detail = preg_replace('#^data:image/[^;]+;base64,#', '', $detail);
}

注：PHP 8.0+可以用str_starts_with，低于8.0版本的话可以用substr($detail, 0, 11) === 'data:image/'来判断。

4. 避免文件名重复（优化建议） #

固定用img.png会导致后续上传的图片覆盖之前的内容，最好生成唯一文件名，比如用时间戳+随机字符串：

$extension = 'png'; // 根据实际图片格式调整
$fileName = uniqid() . '.' . $extension;
$savePath = Yii::getAlias("@webroot/uploads/{$fileName}");

完整代码示例 #

把上面的步骤整合起来，最终代码如下：

// 处理Base64前缀
if (str_starts_with($detail, 'data:image/')) {
    $detail = preg_replace('#^data:image/[^;]+;base64,#', '', $detail);
}

// 确保上传目录存在
$uploadDir = Yii::getAlias('@webroot/uploads');
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0755, true);
}

// 生成唯一文件名
$fileName = uniqid() . '.png';
$savePath = Yii::getAlias("@webroot/uploads/{$fileName}");

// 写入文件
$success = file_put_contents($savePath, base64_decode($detail));

// 可选：获取Web访问路径，用于后续展示
$webUrl = Yii::getAlias("@web/uploads/{$fileName}");

这样调整后，应该就能正常完成Base64图片的上传了～

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