在开发过程中，可访问性很容易被忽视，而回归错误也很难在代码审查中发现。Lens for Laravel 由……创建 雅库布·利平斯基 是一个开发包，它会扫描正在运行的应用程序是否存在 WCAG 违规行为。 斧核 然后将每个问题映射回其来源的特定 Blade 模板文件和行号。
它配备了网页控制面板、Artisan 命令和可选的 AI 辅助修复建议。
安装
镜头取决于 木偶师 通过以下方式驱动无头 Chromium 浏览器 太空浏览器镜头 因此，您需要同时安装Node.js、PHP 8.2+和Laravel 10、11或12。
npm
安装
木偶师
--save-dev作曲家
要求
webcrafts-studio/lens-for-laravel
--dev无需额外设置。该软件包会自动发现其服务提供商，并从 CDN 拉取 Alpine.js 和 Tailwind。
仪表盘
导航至
/lens-for-laravel/dashboard
在您的本地应用程序中。您可以从那里审核单个页面、URL 列表，或者通过站点地图发现或链接跟踪抓取整个网站（默认最多 50 个页面）。
结果按 WCAG 等级（A、AA 或 AAA）分组，每项违规都会显示 CSS 选择器、源 Blade 文件和行号，以及指向相关 WCAG 文档的链接。您还可以截取屏幕截图，突出显示上下文中的违规元素，或导出格式化的 PDF 审核报告。
单击源位置即可直接在您配置的编辑器中打开文件：VSCode、Cursor、PhpStorm 或 Sublime Text。
仪表盘仅限您使用
local
默认情况下，环境会进行检查，并且会强制执行域检查。
APP_URL
因此，除非您明确更改配置，否则在测试环境或生产环境中将无法访问它。
CLI 审计
对于无头工作流和 CI/CD 集成，该软件包提供了一个
lens:audit
Artisan 命令：
# 审核根 URLphp
工匠
镜头：审核
工匠指令的其他选项包括：
# 审核特定页面php
工匠
镜头：审核
/关于
/接触# 抓取整个网站php
工匠
镜头：审核
- 爬行# 按 WCAG 级别筛选php
工匠
镜头：审核
- 一个
# --aa 或 --all# 如果违规次数超过阈值，则命令失败php
工匠
镜头：审核
--threshold=10这
--threshold
该选项可以方便地根据违规次数上限来限制部署。
人工智能辅助修复
如果配置了 AI 提供商，Lens 可以直接在控制面板中生成建议的补丁。它会检查大约 20 行周围的 Blade 代码，提出更正后的差异，并允许您在不离开浏览器的情况下应用更改。
配置您的提供商
.env
:
LENS_FOR_LARAVEL_AI_PROVIDER
=
双子座GEMINI_API_KEY
=
你的钥匙# LENS_FOR_LARAVEL_AI_PROVIDER=openai# OPENAI_API_KEY=你的密钥# LENS_FOR_LARAVEL_AI_PROVIDER=anthropic# ANTHROPIC_API_KEY=你的密钥Gemini、OpenAI 和 Anthropic 均受支持。文件写入次数受限。
resources/views
防止路径遍历。
配置
发布配置文件以调整默认设置：
php
工匠
供应商：发布
--标签=
"lens-for-laravel-config"这
config/lens-for-laravel.php
文件暴露了：
route_prefix— 控制面板 URL 前缀（默认值：lens-for-laravel）enabled_environments— 哪些环境会加载仪表板（默认：local）editor— 你的点击式源代码链接集成开发环境crawl_max_pages— 每次抓取的最大页数（默认值：50）ai_provider— 用于修复建议的 AI 后端
自动扫描无法发现的内容
Axe-core 大约能检测到 20% 到 30% 的 WCAG 违规。需要人工判断的问题——例如有意义的图像替代文本、逻辑清晰的标题层级、键盘导航流程、屏幕阅读器播报以及认知负荷——不会被标记出来。该软件包的文档对此也有明确说明：自动扫描只是一个起点，不能替代人工键盘测试、屏幕阅读器验证以及残障人士参与的用户测试。
Lens 是一个有用的开发工作流程补充工具，可以帮助我们及早发现容易发现的问题。对于致力于符合 ADA、Section 508 或欧盟无障碍法案的团队来说，它应该只是更广泛测试流程中的一个环节。
您可以在以下位置找到来源： GitHub 并浏览以下文档： lens.webcrafts.pl 。
