从零安装 Authpuppy

其实也不是从零安装，首先，我们需要一个Debian系的Linux发行版，比如 Ubuntu，或者Debian自己；其次，我们具有一个畅通的互 联网，并已经配置好系统的更新源。“从零”的意义是，系统是“干净”的，比如刚刚安装好Debian/Ubuntu，没有服务占用80端口，等等....

下面的十八个步骤并不全面，却很有可能是安装Authpuppy所必需的。

0、安装 OpenSSH

这一步并不是必需的，却可以让我们远程通过命令行完成下面的步骤。

sudo apt-get install openssh-server openssh-client

善用 TAB键补全软件包的名称。

1、安装 Apache2

sudo apt-get install apache2

当然会安装一堆依赖的软件包。

2、安装 mysql

sudo apt-get install mysql-server

善用 TAB键补全软件包的名称，比如，输入mysql-server后按TAB，可能补全的是-5.6呢！这与软件源里面的mysql-server 包的版本有关，所以不能照抄命令。当然，也会安装一堆依赖的包。

3、安装 php5

sudo apt-get install php5

一大堆依赖的包......

4、安装 php5 的一些插件包，比如与 mysql 数据库连接的包

sudo apt-get install php5-mysql php5-curl php5-apcu php5-xsl

5、接下来的操作，都可以在 authpuppy 网站上找到。

http://www.authpuppy.org/doc/Getting_Started

不过我还是一条一条列出来了。

6、开启 Apache2 的 rewrite 模式

sudo a2enmod rewrite

8、启动 Apache2

sudo service apache2 start

9、检查 php 的插件包是否安装完全

去 http://svn.symfony-project.com/branches/1.4/data/bin/check_configuration.php

下载 check_configuration.php，放到 /var/www/html 下面，权限755；

访问 127.0.0.1/check_configuration.php ，页面会列出一条一条的东西。如果插件安装完全，则会显示诸如下面的内容：

** Mandatory requirements **

OK        PHP version is at least 5.2.4

** Optional checks **

OK        PD0 is installed.

OK        PD0 has some drivers installed: mysql （这是安装了 php5-mysql 的缘故）

OK        PHP-XML module is installed.

OK        XSL module is installed. （这是安装了 php5-xsl 的缘故）

OK        A PHP accelerator is installed （这是安装了 php5-apcu 的缘故）

如果显示警告或者错误信息，则需要安装缺失的插件包，或者改写部分配置文件的内容。

10、下载 Authpuppy 文件

访问 https://launchpad.net/authpuppy ，在右侧”Downloads“栏，下载最新的 Authpuppy 文件压缩包：

https://launchpad.net/authpuppy/trunk/1.0.0-stable/+download/authpuppy-1.0.0-stable.tgz

比如我下载的是 authpuppy-1.0.0-stable.tgz 。

解压它：

tar  xvzf authpuppy-1.0.0-stable.tgz

移动到 /var/www 目录下：

sudo  mv  authpuppy  /var/www

11、让 apache2 可以在 /var/www/authpuppy 目录随意读写

sudo   chown  -R  www-data  /var/www/authpuppy

假设 apache2 是运行在 www-data 用户下的，具体查看可以使用

ps -aux | grep apache2

看到一段类似

www-data 1524 0.0 0.3 155348 7140 ? S 21:09 0:00 /usr/sbin/apache2 -k start

的字样，那么 www-data 就是 apache2 这个进程所属的用户。

（相对于 sudo chmod -R 777 /var/www/authpuppy，上述方法更安全一些。）

12、看看 apache2 的配置文件在哪里

我们的目的是配置 Apache2，使之能够承载 Authpuppy。首先，看看 apache2 的配置文件在哪里。切换到 /etc/apache2，打开 apache2.conf 文件，第18~30行清楚地显示了apache2配置文件的结构。我们需要在 sites-available 里面添加一个文件，然后改变 sites-enabled 目录下的内容。

让我们停掉 apache2：

sudo service apache2 stop

毕竟在汽车还没熄火的时候维修发动机是一件危险的事情......

13、编辑 /etc/apache2/sites-available/authpuppy.conf

切换到 /etc/apache2/sites-available

cd  /etc/apache2/sites-available

列出下面的所有文件

ls -l

在 /etc/apache2/sites-available 下面，原来已经有了两个文件，0000-default.conf 和 default-ssl.conf。下面，我们在下面新建一个 authpuppy.conf，内容如下：

 1 <VirtualHost *:80>
 2     ServerAdmin webmaster@localhost
 3     ServerName authpuppy.localhost
 4     ServerAlias authpuppy.sample
 5     DocumentRoot /var/www/authpuppy/web
 6     DirectoryIndex index.php
 7     <Directory /var/www/authpuppy/web/>
 8         Options Indexes FollowSymLinks MultiViews
 9         AllowOverride All
10         Order allow,deny
11         allow from all
12     </Directory>
13     Alias /sf /var/www/authpuppy/lib/vendor/symfony/data/web/sf
14     <Directory "/var/www/authpuppy/lib/vendor/symfony/data/web/sf">
15         AllowOverride All
16         Allow from All
17     </Directory>
18     ErrorLog /var/log/apache2/authpuppy/error.log
19     # Possible values include: debug, info, notice, warn, error, crit, alert, emerg.
20     LogLevel warn
21     CustomLog /var/log/apache2/authpuppy/access.log combined
22 </VirtualHost>        

具体可以参考 http://www.authpuppy.org/doc/Getting_Started 里面的示例。

14、停用 Apache2 默认的站点

在 /etc/apache2/sites-enabled 下面，存放着 apache2 承载的站点配置文件，默认是 000-default.conf ，指向 /var/www/html。下面我们停用它：

sudo a2dissite 000-default

这下  /etc/apache2/sites-enabled 目录下面是空的了。

15、启用 authpuppy 站点

sudo a2ensite authpuppy

16、为 Authpuppy 设置数据库（mysql）

首先，我们需要登录 mysql

mysql  -u  root  -p

输入密码登陆。如果遇到了 mysql 无法登陆的错误，恭喜，我们有得折腾啦。

（1）新建一个用户

create  user  ‘authpuppy‘@‘localhost‘  identified  by  ‘密码‘;

（2）新建一个数据库

create  database  authpuppy;

（3）为用户”authpuppy“赋予在数据库”authpuppy“里面的所有表上随意操作的权利

grant  all  privileges  on  authpuppy.*  to  ‘authpuppy‘@‘localhost‘  with  grant  option;

flush  privileges;

（4）退出mysql

exit

17、启动 Apache2

sudo service apache2 start

如果遇到问题，问题描述含有“/var/log/apache2/authpuppy”，请在/var/log/apache2下面新建文件夹 authpuppy，并更改权限为 777。

18、试试看！

访问 http://127.0.0.1，看看发生了什么？是不是出现了一只可爱的狗狗？

按照网页的要求，一步一步配置就可以了。注意数据库的用户名和密码会用到。至于 Authpuppy 怎么用.... 且听下回分解