Laravel中Storage::put()在CentOS8服务器存储图片失效如何解决

1. 修正代码逻辑 #

现有代码存在传参错误：调用$image->stream()后没有获取流内容，直接传递Image对象给Storage::put()方法，Windows环境下的IO处理兼容性更高所以能执行，Linux下严格校验资源类型就会失败。
修正后的代码：

$filename = basename($request->tutorialImage);
$image = Image::make($request->tutorialImage)->resize(300, 400);
// 直接传入编码后的图片内容，也可以替换为 $image->stream()->__toString()
Storage::disk('local')->put(
    'files/shares/resizedImages/' . $filename . '-' . 300 . '-' . 400 . '.jpg',
    $image->encode('jpg')
);

额外说明：storage:link命令仅作用于public磁盘对应的storage/app/public目录，你当前使用的local磁盘默认存储路径为storage/app，该命令不影响本次写入逻辑。如果需要图片可公开访问，可将磁盘切换为public。

2. 修正目录权限与所有者 #

仅修改storage根目录权限不生效，需要递归设置子目录权限，同时匹配Web服务的运行用户，CentOS环境下Web运行用户通常为apache或nginx，根据实际服务替换即可：

# 递归设置storage目录权限
chmod -R 755 /你的Laravel项目路径/storage
# 递归设置目录所有者，以nginx为例，apache环境替换为apache:apache
chown -R nginx:nginx /你的Laravel项目路径/storage

不要长期使用777权限，会存在严重安全风险。

3. 处理SELinux拦截问题 #

CentOS默认开启SELinux安全策略，这是权限设为777依旧无法写入的最常见原因：

• 临时关闭SELinux验证是否为此问题：

setenforce 0

验证写入正常后，建议配置SELinux规则放行storage目录写入权限，不需要永久关闭SELinux：

semanage fcontext -a -t httpd_sys_rw_content_t "/你的Laravel项目路径/storage(/.*)?"
restorecon -Rv /你的Laravel项目路径/storage

4. 提前创建多级存储目录 #

Storage::put不会自动创建多级目录，可提前判断并生成目录：

if (!Storage::disk('local')->exists('files/shares/resizedImages')) {
    Storage::disk('local')->makeDirectory('files/shares/resizedImages', 0755, true);
}

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