phpbb-python 0.0.1

在Python中实现的PHPBB认证
==========================================

作者：Santtu Pajukanta <santtu@pajukanta.fi>
更新时间：2010-03-31


简介
============

phpbb-python实现了phpBB3的认证部分。这
使基于Python的Web应用程序能够对现有phpBB3论坛的用户
账户数据库进行认证。

还提供了一个Django认证后端。与phpBB 3.0.7、
Django 1.0和PostgreSQL 8.4进行了测试。其他配置可能

可能或可能无法工作。
本说明书假设对Django和phpBB3的内部有深入了解。


非专业人士请勿尝试。使用源代码，路克。
=======================

版权和许可
这是phpBB3本身登录代码的直接移植。因此，这个
软件包可以被认为是phpBB3的派生作品，并且phpBB3的

许可证（GPLv2，遗憾的是不是“或更新版”）适用。
然而，如果phpBB3软件有一天被重新许可为GPLv2或
更新版，我不会阻止您使用这个软件包与“更新版”的许可证。
因此，我认为不是phpBB3的派生作品的文件仅包含我的

版权声明和“GPLv2或更新版”许可证模板。


基本用法（不使用Django）
============================

from phpbb.auth.sql import setup
from phpbb.auth.auth_db import login_db

import psycopg2

conn = psycopg2.connect(
database="phpbb3",
user="phpbb3",
password="phpbb3"
)
setup(conn)

result, user_row = login_db("username", "password")
if result == "LOGIN_SUCCESS"
print "Multipass!"
else
print "您不能通过！"


与Django一起使用
=================

确保"phpbb"模块在您的PythonPath中的某个位置。将此
添加到您的settings.py

AUTHENTICATION_BACKENDS = (
('django.contrib.auth.backends.ModelBackend'),
('phpbb.auth.backends.PhpbbBackend'),
)

PHPBB_AUTH_DB_MODULE = "psycopg2"
PHPBB_AUTH_DB_KEYS = {
"用户": "",
"密码": "",
"数据库": "",
}
PHPBB_AUTH_DB_PARAM_STYLE = "%s"
PHPBB_AUTH_DB_USERS_TABLE = "phpbb_users"

显然，还有一些需要填写的内容。注意我们保留了ModelBackend，
这样做。这样我们可以在Django中定义超级用户等，
而在phpBB3中只定义普通用户。

examples/hammertime中有可工作的（WORKSFORME）示例。祝您玩得愉快。


常见问题解答
===

问：我能得到一匹小马吗？
答：不，你不能得到一匹小马。