开源项目lib-noir常见问题解决方案

开源项目lib-noir常见问题解决方案

lib-noir A set of libraries for ring apps, including stateful sessions. 项目地址: https://gitcode.com/gh_mirrors/li/lib-noir

1. 项目基础介绍

lib-noir 是一个用于构建 ring 应用的库集合，包含状态会话、静态资源管理、文件上传、自定义响应类型和重定向、输入验证、内容缓存、路由过滤和重定向以及使用 SCrypt 进行密码哈希等功能。这个库最初是从 Noir Web 框架中分离出来的，目前独立于 Noir 进行活跃开发，可以与任何基于 ring 的 Web 框架（如 Moustache 和 Compojure）一起使用。该项目的主要编程语言是 Clojure。

2. 新手常见问题及解决步骤

问题一：如何添加lib-noir到项目中？

问题描述： 新手在使用lib-noir时，不知道如何将其添加到项目中。

解决步骤：

1. 确保你的项目使用 Leiningen 作为构建工具。
2. 在项目的 project.clj 文件中，添加以下依赖项到 :dependencies 中：

[:lib-noir "0.9.5"]

问题二：如何设置状态会话？

问题描述： 新手在使用lib-noir时，不知道如何配置状态会话。

解决步骤：

1. 在 project.clj 文件中，确保已经引入了 noir.session 相关的依赖。
2. 在你的应用程序的 app-handler 中，添加会话选项，例如：

(def app (middleware/app-handler
           [home-routes app-routes]
           :session-options [:cookie-name "example-app-session" :store (cookie-store)]))

问题三：如何处理密码哈希？

问题描述： 新手在使用lib-noir时，遇到密码哈希不兼容的问题。

解决步骤：

1. 了解从版本 0.9.5 开始，lib-noir 使用 SCrypt 作为加密实现，这会破坏与之前使用 bcrypt 加密密码哈希的兼容性。
2. 如果你需要迁移现有的密码哈希，你需要使用 SCrypt 重新生成哈希。
3. 使用以下代码生成新的密码哈希：

(use 'noir.crypto)
(println (hashers/bcrypt "new-password"))

然后，使用新的哈希值替换数据库中的旧哈希值。

通过以上步骤，新手可以更好地开始使用lib-noir，并解决在初始化项目时可能遇到的一些常见问题。

lib-noir A set of libraries for ring apps, including stateful sessions. 项目地址: https://gitcode.com/gh_mirrors/li/lib-noir