Laravel文件可见性怎么设_Laravel权限配置【教程】-php教程-PHP中文网

$visible 和 $hidden 不能用于 api 字段控制，因其作用于模型全局序列化，会污染日志、队列、缓存等所有场景；应改用 resource 类的 only() 和 makevisible() 在响应层动态、精准控制字段输出。

laravel文件可见性怎么设_laravel权限配置【教程】

别用 $visible 或 $hidden 控制 API 字段可见性——它们不是为 HTTP 响应设计的，强行用会污染日志、队列、缓存等所有序列化场景。

为什么 $visible 和 $hidden 不能当 API 字段开关用

这两个属性作用于模型实例的全局序列化行为（比如 toArray()、toJson()），一旦设置，所有调用处都生效：

控制器返回 JSON 时字段被砍掉
队列任务里 Log::info($user) 打印出空 email 字段，排查时完全看不出问题
Telescope 记录的模型快照也缺字段，调试变困难
新增数据库字段默认不输出，必须手动加进 $visible 数组，漏一个就永远不可见
$visible 和 $hidden 互斥：$visible 存在时，makeVisible() 完全失效

真正可控的字段过滤：Resource 类里的 `only()` 和 `makeVisible()`

把字段控制权收回到响应生成点，谁负责输出，谁决定字段：

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

在 UserResource 的 toArray() 里写 $this->resource->only(['id', 'name', 'avatar_url'])
需要临时暴露敏感字段？$this->resource->makeVisible('api_token')，只影响当前响应
按权限动态控制：auth()->user()->can('view_email', $user) ? ['email'] : []，拼进 only() 数组
避免在模型里写 $casts = ['email' => 'encrypted'] —— 加密/脱敏应由资源或服务层处理

文件存储中的 visibility 是另一回事，别和模型属性混淆

文件系统的 visibility 指的是访问权限（public/private），和模型字段是否出现在 API 响应里毫无关系：

Storage::getVisibility('file.jpg') 返回 'public' 或 'private'
storePublicly('avatars', 's3') 会自动设为 public 可见性，生成可直链的 URL
本地驱动下，public 对应文件权限 0644、目录 0755，可在 config/filesystems.php 的 permissions 里调整
php artisan storage:link 是必须步骤，否则 public/storage 到 storage/app/public 的符号链接不存在，前端无法访问