Learn-skills.dev php-laravel-audit
Laravel 框架特效安全审计工具。针对 Laravel 常见鉴权/CSRF/Session/模型填充/Blade 渲染等框架特性进行白盒静态审计,并将风险映射到你现有通用漏洞类型体系(AUTH/CSRF/LOGIC/XSS/CFG 等)。
install
source · Clone the upstream repo
git clone https://github.com/NeverSight/learn-skills.dev
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NeverSight/learn-skills.dev "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/skills-md/0xshe/php-code-audit-skill/php-laravel-audit" ~/.claude/skills/neversight-learn-skills-dev-php-laravel-audit && rm -rf "$T"
manifest:
data/skills-md/0xshe/php-code-audit-skill/php-laravel-audit/SKILL.mdsource content
PHP Laravel 框架安全审计(php-laravel-audit)
分析 Laravel 项目源码中的“框架特效安全机制”和“常见踩坑模式”,重点覆盖:
- 鉴权与路由保护(middleware/auth/Policies/Gates)
- CSRF 与 token 保护(VerifyCsrfToken、except 列表、API 与 Cookie 认证差异)
- Session 与 Cookie 安全(session_regenerate_id、cookie flags、remember 机制的风险点)
- Eloquent mass assignment 与 request-to-model 写入缺陷(Model::create/fill/update 与
链)$request->all() - Blade 模板渲染中的 raw 输出与表达式执行风险(
、{!! !!}
以及未转义输出)@php - Laravel signed URL 与路由签名校验是否闭环(Signed middleware 与生成位置)
输入
用户提供:
:Laravel 项目源码根目录 可选:source_path
:输出目录路径(默认output_path
){source_path}_audit
输出目录
输出到:
{output_path}/framework_audit/ laravel_{timestamp}.md
框架识别(必做)
必须给出你识别该项目为 Laravel 的证据点(不允许空口断言):
依赖composer.json- 典型目录:
、app/
、routes/config/ - 核心入口:
、public/index.phpbootstrap/app.php
风险类型映射(必做)
每条发现都必须写明:
- 适用的通用类型码:
/AUTH
/CSRF
/LOGIC
/XSS
/CFG
/SESS
等(从你的FILE
可用类型码中选)shared/SEVERITY_RATING.md - 这条 Laravel 风险为什么落到该通用类型码(用一句话解释映射逻辑)
必审清单(必做:逐项检查并输出结果)
1) 鉴权与权限保护(AUTH)
必须定位并输出以下证据:
- 受保护路由进入点:
与routes/web.php
中的routes/api.php
/middleware('auth')
/middleware('can')Route::middleware([{value}])->group({value}) - 权限逻辑:
/Gate::
/Policy
/authorize
/can
的位置证据->can({value}) - 风险判断:是否存在“已登录但无资源级归属校验”的模式(例如只判断 user 存在,不判断 owner)
- 路由命名与资源绑定:是否存在 Route Model Binding 但未做归属校验
输出要求:
- 若发现缺失:必须给出“缺失位置 + 可能被绕过的请求类型(GET/POST/API)+ 修复建议”
- 若未发现:也必须输出“未发现的判定依据”(例如 except/guard 为空、敏感路由均有 middleware 等)
2) CSRF 与 token 保护(CSRF)
必须定位:
- CSRF middleware:
或等价中间件VerifyCsrfToken - except 列表:哪些路由被排除
- API 与 Cookie 认证差异:若项目对 API 使用 Cookie/session,需要确认 API 路由是否仍受 CSRF 保护
输出要求:
- 必须覆盖“可能绕过分支”:例如仅部分方法不校验、仅某些 Content-Type 不校验、仅在 AJAX 时跳过等
3) Session 与 Cookie 安全(SESS)
必须定位:
- 登录后会话固定防护:是否存在
或 Laravel 对应机制证据session_regenerate_id - Cookie flags:
/HttpOnly
/Secure
的配置位置(SameSite
或自定义中间件)config/session.php - logout:退出是否清理 session
4) Eloquent mass assignment(LOGIC)
必须定位并输出数据流链证据:
- request 输入获取:
、$request->all()
、$request->input({value})json_decode({value}) - 写入模型点:
/Model::create({value})
/Model::update({value})
/$model->fill({value})->save() - 模型填充策略:
/$fillable
的配置位置$guarded
判定规则:
或等价输入直接进入$request->all()
,且模型缺少针对敏感字段的 denylist(或create/fill/update
过宽),则输出风险$fillable
5) Blade raw 输出(XSS)
必须定位并输出:
- raw 输出:
、{!! {value} !!}
以及任何“跳过转义”的指令或回调@php - 用户输入来源:来自
、$request
、数据库字段回填但未转义时的证据request()
判定规则:
- 若 raw 输出内容存在用户可控字段,且未做
或等价 escape,则输出风险映射到e()
或相关模板注入风险(若你项目用到模板表达式执行则映射到XSS
)TPL
6) Signed URLs 与签名校验闭环(AUTH 或 CFG)
必须定位:
- 签名 URL 生成:
/URL::temporarySignedRouteURL::signedRoute - 验证中间件:
或等价校验机制middleware('signed')
判定规则:
- 若仅生成但无签名验证中间件,或验证逻辑可被绕过,输出风险映射到
或AUTHCFG
可观测 PoC(必做:框架特效可观测验证框架)
至少给出以下两类其一并写清观察点:
- 鉴权缺失/越权绕过:给出真实路由与 payload 目标(例如切换对象 id)
- CSRF 缺失/绕过:给出真实路由与需要携带/不携带的 token 场景,并说明观察点
PoC 输出要求:
- 必须包含真实路由(从
真实可命中位置抽取)routes/*.php - 必须包含真实字段名(如
字段、或表单 action)csrf
输出完整性检查(强制)
- 输出包含:Laravel 识别证据点
- CSRF/Auth/Session/Mass Assignment/Blade raw/Signed URL 六大块均有“检查结果”
- 每条风险都有:映射类型码 + 位置证据 + 可观测验证框架 + 修复建议