README

自托管、可定制、易于实现且用户友好的验证码。

介绍 IconCaptcha，这是一款自托管验证码解决方案，设计速度快、用户友好且高度可定制。与其它验证码不同，IconCaptcha 免去了用户解码难读的文本图像、解决复杂的数学问题或参与令人困惑的谜题游戏的麻烦。相反，使用 IconCaptcha 只需要比较最多 8 个图标并选择最不常见的一个即可。

IconCaptcha 不仅重视用户，也考虑了开发者的友好性。只需几个步骤，你就可以将 IconCaptcha 集成到你的网站中。即使你是 PHP 和 JavaScript 的初学者，安装 IconCaptcha 也是一个简单的过程。该存储库中包含的演示页面提供了启动 IconCaptcha 所需的所有代码。为了更深入的了解，请花些时间查看此页面上提供的信息和维基。

▶ 在这里尝试实时演示！

使用 ASP.NET？尝试 IconCaptcha for ASP.NET (目前未维护 - 将于 2023 年第四季度继续)

安装

Composer

composer require fabianwennink/iconcaptcha

安装完包后，继续执行剩余的 安装说明，然后是 设置说明。

手动安装

建议使用 Composer。但是，如果您不能使用它，请按照 手动安装说明 和 设置说明 进行操作。

功能

• 🏠 自托管： 作为自托管解决方案，IconCaptcha 消除了对第三方服务的依赖，将一切控制在您的控制之下。
• 🚫 不共享数据： 与其他验证码不同，IconCaptcha 的自托管特性确保不将用户数据与第三方共享。
• 🔐 服务器端验证： 所有验证都在服务器端执行，通过消除客户端敏感过程的暴露来提高安全性。
• 😊 用户友好： 用易于理解的图像替换复杂的验证码，为用户提供更流畅的体验。
• 💾 数据库支持： 使用 MySQL、SQL Server、PostgreSQL 和 SQLite 等各种流行的数据库存储和管理挑战数据。
• 🌐 跨域集成： 带有 CORS 支持，IconCaptcha 可以轻松集成到跨越不同域的应用程序中。
• 🎣 事件和钩子： 代码中会触发事件，允许您注入自定义代码并根据您的需求调整体验。
• 🎨 现代设计： IconCaptcha 的现代设计可以无缝集成到各种风格中。
• 🖌️ 主题： 从现有的主题中选择，或者使用提供的 SASS 文件创建您自己的独特主题。
• 🔌 jQuery 集成： 虽然 IconCaptcha 是用纯 JavaScript 编写的，但它可以无缝集成到 jQuery 中。

IconCaptcha 4 的新功能

IconCaptcha 4版本对架构和功能集进行了重大增强，提供了更大的灵活性和定制化，同时提升了安全性。以下是这次发布的关键更新：

• 📦 Composer 兼容性： IconCaptcha 现已在 Packagist 上可用，并可通过 Composer 进行安装。
• 🏗️ 重构代码库： 整个代码库已重构，摒弃了之前“一文件走天下”的方法。这种重构使得未来维护代码更加容易。
• 📃 改进配置： IconCaptcha 4引入了一个更加全面和精致的配置文件，提供了更多定制选项，并对每个选项提供了更清晰的描述。
• 💾 数据库支持： 本版本的一个重要新增是增加了数据库支持。挑战数据现在可以使用MySQL、SQL Server、PostgreSQL和SQLite等知名数据库进行存储。
• 🧩 自定义驱动： 想要自定义处理某些服务器端功能？IconCaptcha 4允许您为会话管理、存储和超时处理等关键功能实现自定义驱动。
• 🎣 服务器端钩子： 钩入服务器端事件，如验证码初始化、挑战生成和解决方案处理，以根据应用程序的需求自定义流程。
• 🌐 CORS 支持： 现在支持跨源资源共享（CORS），允许IconCaptcha集成到跨不同域的应用程序中，同时保持安全标准。

维基

有关安装、设置和配置IconCaptcha的说明，请务必查看Wiki页面

• 要求 - 运行IconCaptcha所需的列表。
• 安装 - 安装/下载IconCaptcha的说明。
• 实现 - 如何实现IconCaptcha的步骤指南。
• 配置 - 所有可配置选项的说明。
• 存储 - 所有存储选项的详细信息。
• 挑战生成器 - 如何实现自定义挑战生成器的信息。
• 验证 - 验证过程和错误处理的说明。
• 钩子 & 事件 - 在验证码处理不同阶段触发的事件概述。
• 令牌 - 关于可选小部件安全令牌使用的信息。
• 主题 - 创建和设置自定义主题的详细信息。
• 本地化 - 如何自定义本地化字符串的详细信息。

鸣谢

本项目中使用的图标由 BlendIcons 制作。

许可证

本项目采用 MIT 许可证。