使用 PHP 在站点上构建类似 Twitter 的系统
http://blog.csdn.net/sfshine/article/details/8184510
如果您曾经留意过,就会知道 Twitter 是 Web 2.0 世界最大的轰动事件之一。简单来说,Twitter(Twitter.com 上提供的一个服务)是一个简单的微博客服务,用户可以发最多 140 个字符的贴子(称作?tweet),回答 “你现在在做什么?” 之类的问题。用户可以追随他们感兴趣的人,也有自己的追随者。通过这种方式,可以将信息发布给追随者或是广泛地转发。
随意浏览一下某个 Twitter 账户可以发现,用户常常发布关于很多不同话题的 tweet,从日常生活(例如 “我在吃三明治”)到更不平凡的话题。其中常常嵌入了图像、媒体文件和日志的链接。这些 URL 常常被 TinyURL 之类的服务缩短,主要是为了使贴子的总字符数不超过 140 个字符。
很多人喜欢上了 Twitter,使超短格式成了一种艺术形式,甚至将之用于与其他用户交谈(例如将他们的评论定向到 @user)。从这个简单的起点开始,涌现了大量支持 Twitter 的移动应用程序和其他工具。现在甚至还有专门为最有趣、最卓越和最详实的 tweet 而设置的奖项,另外还有跟踪不同 Twitter 应用程序的状态的在线应用程序。
很多其他站点和服务,例如 LinkedIn 和 Facebook 现在允许用户用仿照 Twitter 的方式更新他们的当前状态。换句话说,在 Facebook 更新状态需要使用短消息,当然,状态通常是回答 “你现在在干什么” 之类的问题。
为您自己的站点添加微博客或状态更新工具不需要做很多工作,但是却可以为用户带来乐趣和简单的交流方式。本文的目标是展示如何实现这个目的。但是,首先需要对您作一些假设。
首先,假设您对 PHP 和 MySQL 有所了解。同时假设您可以访问某个运行 PHP 和 MySQL 的本地 Apache Web 服务器。对于本文,我在使用 Macintosh、Apache、MySQL 和 PHP(MAMP)的 MacBook Products 上进行开发,这个免费程序将整个开发环境打包到一个包中。但是,您应该能够毫无困难地在 Microsoft? Windows? 或 Linux? 上进行开发。最后,假设您已经有一个可以立即运行的应用程序,该应用程序现在有一些用户,您打算以某种方式将微博客或 tweeting 添加到该应用程序中。为此,我简化应用程序中侧重用户的一些方面(例如登录、管理个人文件等),而侧重于贴子。
设计应用程序的后端
简言之,Twitter 服务以两个名词为中心:用户和消息。如果您已经构建了一个应用程序,并且希望将类似 Twitter 的服务添加到应用程序中,那么很可能已经有了用户管理功能。如果还没有,那么需要采用某种方式使用一个数据库表(一个主键,通常是一个整数)、一个用户名(也是惟一的)、一个电子邮件地址和密码等标识每个用户。
tweet(即贴子)存储在一个 posts 表中,每个贴子有一个主键(某种连续整数)、一个指向发出该贴的用户的外键关系、贴子本身(限制为一定数量的字符)和日期/时间戳。
最容易令人感到迷惑的是显示用户追随关系的数据库表。这里需要某种方式记录用户 ID 和追随者 ID,使应用程序能够快速建立追随者列表,并轻松地将信息转发给那些已注册为要追随某用户的其他用户。
理解这些内容后,现在就可以着手建立这 3 个数据库表。使用清单 1 中的 SQL 代码创建第一个表,即 users 表(如果已经有一个 users 表,则可以跳过这一步)。
清单 1. users 表
CREATE TABLE `users` ( `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY , `username` VARCHAR( 255 ) NOT NULL , `email` VARCHAR( 255 ) NOT NULL , `password` VARCHAR( 8 ) NOT NULL , `status` ENUM( 'active', 'inactive' ) NOT NULL ) ENGINE = MYISAM ;
|
下面是第二个表,即 posts 表。
清单 2. posts 表
CREATE TABLE `posts` ( `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY , `user_id` INT NOT NULL , `body` VARCHAR( 140 ) NOT NULL , `stamp` DATETIME NOT NULL ) ENGINE = MYISAM ;
|
清单 3 显示了最后一个表,即 following 表。注意这个表有两个主键。
清单 3. following 表
CREATE TABLE `following` ( `user_id` INT NOT NULL , `follower_id` INT NOT NULL , PRIMARY KEY ( `user_id` , `follower_id` ) ) ENGINE = MYISAM ;
|
然后,先创建一个名为 header.php 的文件,将所有用于 MySQL 的连接字符串放到该文件中。如果已经有一个这样的文件,可以跳过这一步。请务必在各处都包括这个文件,因为将来需要用到它。清单 4 展示了这个文件的内容。
清单 4. 样例 header.php 文件
$SERVER = 'localhost'; $USER = 'username'; $PASS = 'password'; $DATABASE = 'microblogger';
if (!($mylink = mysql_connect( $SERVER, $USER, $PASS))){ echo "<h3>Sorry, could not connect to database.</h3><br/> Please contact your system's admin for more help\n"; exit; }
mysql_select_db( $DATABASE );
|
请记住,还可以随意将任何其他类型的安全检查添加到这个 header.php 文件中。例如,可以检查一个会话变量中是否设置了一个用户 ID(表明该用户已经登录)。如果用户没有登录,那么可以将用户重定向到登录页面。本文不会深入讨论这一点,不过需要时可以很容易地添加安全检查。
创建输入表单
设置好后端表之后,就可以考虑处理数据插入和更新的 PHP。现在需要的是一些简单的函数,这些函数将:
- 允许用户登录和添加贴子。
- 将那些贴子转发给追随那个用户的人。
- 允许用户追随其他用户。
我 通常在模型-视图-控制器(Model-View-Controller,MVC)应用程序框架(例如 CodeIgniter)的上下文中工作,因为它提供了一套工具用于创建这些类型的应用程序。例如,我一般先创建两个模型(一个用于用户,另一个用于贴 子),这两个模型使我可以与 users、posts 和 following 表交互,然后从这两个模型开始继续前进。
由于您可能已经在使用不同的框架,所以我决定在此不使用上述方法。相反,我选择一种更简单的、独立于框架的方法。对于本文,我们走走捷径,直接将记录添加到 users 表中,以创建一系列测试用户,供应用程序使用。我创建 3 个用户,并将他们的用户名设为?jane
、?tommy
?和?bill
。
然后,创建一个简单的名为 functions.php 的 PHP 文件,该文件将包含主要的功能。在该文件中要创建少量的函数,以支持微博客应用程序上下文中的动作。
如清单 5 所示,第一个函数是一个简单的函数,用于将内容添加到 posts 表中。
清单 5. 用于将内容添加到 posts 表中的函数
function add_post($userid,$body){ $sql = "insert into posts (user_id, body, stamp) values ($userid, '". mysql_real_escape_string($body). "',now())";
$result = mysql_query($sql); }
|
为了测试这个简单的函数,还需要添加另外两个 PHP 文件。一个是 index.php 文件,目前包含一个基本的小表单 — 后面将向页面添加更多内容。另一个 PHP 文件是 add.php,上述表单将被发布到该文件。清单 6 是 index.php 文件的摘录。请注意,在此使用一个 PHP 会话将一个用户 ID 值硬编码为 1,这是我的数据库中的用户?jane
。现在这样做完全没有问题,但是在后面显然需要更改。
清单 6. index.php 文件摘录
<?php session_start(); include_once('header.php'); include_once('functions.php');
$_SESSION['userid'] = 1; ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>Microblogging Application</title> </head> vbody>
<?php if (isset($_SESSION['message'])){ echo "<b>". $_SESSION['message']."</b>"; unset($_SESSION['message']); } ?> <form method='post' action='add.php'> <p>Your status:</p> <textarea name='body' rows='5' cols='40' wrap=VIRTUAL></textarea> <p><input type='submit' value='submit'/></p> </form>
</body> </html>
|
此外还应注意,我在表单上为状态消息留下了空间,这将在 add.php 中动态地设置,如下面的清单所示。
清单 7. 用 add.php 文件将贴子添加到数据库中
<?php session_start(); include_once("header.php"); include_once("functions.php");
$userid = $_SESSION['userid']; $body = substr($_POST['body'],0,140);
add_post($userid,$body); $_SESSION['message'] = "Your post has been added!";
header("Location:index.php"); ?>
|
上述代码应该没有什么特别令人奇怪的东西。它只是接受表单的?body
?字段和 PHP 会话中设置的 user ID,然后将它们传递给 functions.php 文件中的?add_post()
?函数。然后,设置另一个会话变量(更新消息),并将用户重定向回 index.php 页面。
如果要测试这个小函数,惟一的方法是检查数据库中的 posts 表。这不太符合用户友好性,不是吗?这里需要的是更新主页上的贴子。为此,需要再将一个函数添加到 functions.php 文件中,并在主页上使用它。
添加一系列的更新
现在可以打开 functions.php 文件并在其中添??另一个函数。这一次,将函数命名为show_posts()
。它将显示特定用户 ID 的所有贴子,如下面的清单所示。
清单 8.?show_posts()
?函数
function show_posts($userid){ $posts = array();
$sql = "select body, stamp from posts where user_id = '$userid' order by stamp desc"; $result = mysql_query($sql);
while($data = mysql_fetch_object($result)){ $posts[] = array( 'stamp' => $data->stamp, 'userid' => $userid, 'body' => $data->body ); } return $posts;
}
|
如果为这个函数传递一个用户 ID,它将在一个多维数组中按日期倒序的顺序返回那个用户发出的贴子。要使用该函数,只需在 index.php 上调用它,并检索那个用户的所有贴子。由于对于每个记录只需处理少量的数据,这种查询可以很好地进行扩展。
清单 9 是添加到 index.php 页面的代码,这些代码就放在前面添加的表单之后。通过使用show_posts()
?函数和会话变量,可以获得登录的用户发出的所有贴子。如果没有贴子,则显示某种错误消息。如果有贴子,则在一个表中逐个显示它们 — 或者,如果想别致一点,可以使用自己的级联样式表(CSS)。
清单 9. 在 index.php 页面上显示贴子
<?php $posts = show_posts($_SESSION['userid']);
if (count($posts)){ ?> <table border='1' cellspacing='0' cellpadding='5' width='500'> <?php foreach ($posts as $key => $list){ echo "<tr valign='top'>\n"; echo "<td>".$list['userid'] ."</td>\n"; echo "<td>".$list['body'] ."<br/>\n"; echo "<small>".$list['stamp'] ."</small></td>\n"; echo "</tr>\n"; } ?> </table> <?php }else{ ?> <p><b>You haven't posted anything yet!</b></p> <?php } ?>
|
图 1 显示到目前为止的基本界面 — 还不错,几分钟就有这样的成绩。
图 1. 基本界面
?
容 易的部分就完成了。现在有了一个基本的应用程序,用户可以发布状态,并看到它在页面上显示。但是,还缺少一个重要的部分:除了发布状态的人以外,没有人看 到状态更新。在下一节中,将创建一个简单的界面,其中列出系统中的所有用户,并且允许已登录的用户追随其他用户并看到他们的状态更新。
追随其他用户
接下来可以将更多东西添加到 functions.php 文件中。这里需要一个?show_users()
?函数,该函数可以返回系统中所有用户的一个列表。后面将使用这个函数填充一个用户列表。
清单 10.?show_users()
?函数
function show_users(){ $users = array(); $sql = "select id, username from users where status='active' order by username"; $result = mysql_query($sql);
while ($data = mysql_fetch_object($result)){ $users[$data->id] = $data->username; } return $users; }
|
有了?show_users()
?函数之后,接下来可以创建一个 users.php 文件,该文件将运行这个函数,并显示系统中所有用户的一个列表,对于每个用户,在用户名的旁边都有一个?follow?链接。
清单 11. 运行?show_users()
?函数的 users.php 文件
<?php session_start(); include_once("header.php"); include_once("functions.php");
?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>Microblogging Application - Users</title> </head> <body>
<h1>List of Users</h1> <?php $users = show_users();
if (count($users)){ ?> <table border='1' cellspacing='0' cellpadding='5' width='500'> <?php foreach ($users as $key => $value){ echo "<tr valign='top'>\n"; echo "<td>".$key ."</td>\n"; echo "<td>".$value ." <small><a href='#'>follow</a></small></td>\n"; echo "</tr>\n"; } ?> </table> <?php }else{ ?> <p><b>There are no users in the system!</b></p> <?php } ?> </body> </html>
|
为了访问这个用户列表,在 index.php 文件中表单的上方添加一个到 users.php 的链接:
<p><a href='users.php'>see list of users</a></p>
|
现在有了一个易于使用的用户名列表,每个用户名旁有一个?follow?链接。
图 2. 用户列表
?
在进入下一个阶段之前,还需要编写一个小函数,该函数将返回当前用户正在追随的用户。这样一来,用户就可以用这个列表来确定是否追随另一个用户。
回到 functions.php 文件,添加一个名为?following()
?的函数,如清单 12 所示。将当前用户 ID 传递给该函数,就可以得到该用户正在追随的每个用户的 ID。
清单 12.?following()
?函数
function following($userid){ $users = array();
$sql = "select distinct user_id from following where follower_id = '$userid'"; $result = mysql_query($sql);
while($data = mysql_fetch_object($result)){ array_push($users, $data->user_id);
}
return $users;
}
|
现在可以在 users.php 上运行这个函数,检查某个用户 ID 是否在该数组中。如果在,则使用 unfollow 链接。如果不在,则使用默认的 follow 链接。清单 13 显示修改后的代码。
清单 13. 修改后的 users.php 文件,它将显示 follow 和 unfollow 链接
<?php $users = show_users(); $following = following($_SESSION['userid']);
if (count($users)){ ?> <table border='1' cellspacing='0' cellpadding='5' width='500'> <?php foreach ($users as $key => $value){ echo "<tr valign='top'>\n"; echo "<td>".$key ."</td>\n"; echo "<td>".$value; if (in_array($key,$following)){ echo " <small> <a href='action.php?id=$key&do=unfollow'>unfollow</a> </small>"; }else{ echo " <small> <a href='action.php?id=$key&do=follow'>follow</a> </small>"; } echo "</td>\n"; echo "</tr>\n"; } ?>
|
接下来的步骤很简单:创建 follow 和 unfollow 链接使用的 action.php 文件。该文件接受两个?GET
?参数:一个用于用户 ID,另一个用于 follow 或 unfollow。如清单 14 所示,这个文件和 add.php 文件一样简短。
清单 14. action.php 文件
<?php session_start(); include_once("header.php"); include_once("functions.php");
$id = $_GET['id']; $do = $_GET['do'];
switch ($do){ case "follow": follow_user($_SESSION['userid'],$id); $msg = "You have followed a user!"; break;
case "unfollow": unfollow_user($_SESSION['userid'],$id); $msg = "You have unfollowed a user!"; break;
} $_SESSION['message'] = $msg;
header("Location:index.php"); ?>
|
可以看到,这里取决于之前选择的链接,采取两种不同的动作 —?follow_user()
?或unfollow_user()
。然后,设置一条消息,并将用户重定向回 index.php 页面。用户回到 index.php 页面后,不仅可以看到自己的消息,还可以看到他们追随的用户最近添加的消息。或者,如果之前选择 unfollow 链接,那么那个用户的消息将从列表中消失。稍后需要在 index.php 中添加这点代码。现在,将?follow_user()
?和?unfollow_user()
?函数添加到 functions.php 中。
对 于这两个函数要小心一点。不能只是因为用户单击了那个链接,就盲目地追随或放弃追随一个用户。首先,需要检查 following 表中是否存在这样的关系。如果存在,那么可以忽略请求(单击 follow 链接时),或者接受请求(单击 unfollow 链接时)。为简单起见,编写两种情况下都可以使用的一个check_count()
?函数,如下面的清单所示。
清单 15.?check_count()
?函数
function check_count($first, $second){ $sql = "select count(*) from following where user_id='$second' and follower_id='$first'"; $result = mysql_query($sql);
$row = mysql_fetch_row($result); return $row[0];
}
function follow_user($me,$them){ $count = check_count($me,$them);
if ($count == 0){ $sql = "insert into following (user_id, follower_id) values ($them,$me)";
$result = mysql_query($sql); } }
function unfollow_user($me,$them){ $count = check_count($me,$them);
if ($count != 0){ $sql = "delete from following where user_id='$them' and follower_id='$me' limit 1";
$result = mysql_query($sql); } }
|
接下来的步骤很容易:在主页上显示当前用户正在追随的其他用户的列表。虽然已经有了一个show_users()
?函数,但那个函数是显示所有?用户。可以通过增加一个非必需的参数,轻松地改变这个函数的用途。这个参数是一个用户 ID,可以用该参数将用户列表限制为该用户 ID 所追随的那些用户。
清单 16 中重新编写的代码所做的事情是检查传入的?$user_id
?参数。如果该用户 ID 大于 0,则使用一个查询获取此 ID 追随的所有用户的 ID。使用?implode()
?函数将获得的数组转换为一个以逗号分隔的列表。然后将这个字符串 — 大致为?and id in (1,2,3...n)
?— 插入到已有的 SQL 查询中,从而将用户列表限制为该用户正在追随的那些用户。
清单 16. 重新编写的代码,用于限制通过查询获得的用户列表
function show_users($user_id=0){
if ($user_id > 0){ $follow = array(); $fsql = "select user_id from following where follower_id='$user_id'"; $fresult = mysql_query($fsql);
while($f = mysql_fetch_object($fresult)){ array_push($follow, $f->user_id); }
if (count($follow)){ $id_string = implode(',', $follow); $extra = " and id in ($id_string)";
}else{ return array(); }
}
$users = array(); $sql = "select id, username from users where status='active' $extra order by username";
$result = mysql_query($sql);
while ($data = mysql_fetch_object($result)){ $users[$data->id] = $data->username; } return $users; }
|
接下来,将清单 17 中的代码添加到主页中,用于显示所有那些被追随的用户。
清单 17. 修改 index.php 以显示被追随的用户
<h2>Users you're following</h2>
<?php $users = show_users($_SESSION['userid']);
if (count($users)){ ?> <ul> <?php foreach ($users as $key => $value){ echo "<li>".$value."</li>\n"; } ?> </ul> <?php }else{ ?> <p><b>You're not following anyone yet!</b></p> <?php } ?>
|
添加其他用户?贴子
要将其他用户的贴子添加到一个用户的时间表(timeline)上,只需重用之前编写的一些代码。例如,现在已经知道如何获得当前用户正在追随的用户的列表。也知道如何获得某个用户发出的所有贴子。因此只需稍微修改后一个函数,使之能够接受一个用户列表,而不是单个用户。
现在只需在 index.php 文件中将第一个函数上移一点,以便马上使用它,然后使用通过该函数获得的用户 ID 列表,从他们的时间表中获取一定数量的贴子 — 这里不需要所有的贴子,只需 5 个左右。记住,要按日期倒序(最近的在上)排列那些用户的贴子。
首先,为?show_posts()
?函数增加一个 limit 参数,将它的值默认为 0。如果 limit 大于 0,则将一个限制值添加到用于检索贴子的 SQL 语句中。另外要做的是将?$userid
?参数放入到一个数组中,并将该数组解析到一个以逗号分隔的字段中,最后将该字段传递给 SQL 语句。这需要做一点额外工作,但是可以获得丰厚的回报,因为如您所见,所有贴子都将以倒序显示。
清单 18. 更新?show_posts()
,以接受一个用户数组
function show_posts($userid,$limit=0){ $posts = array();
$user_string = implode(',', $userid); $extra = " and id in ($user_string)";
if ($limit > 0){ $extra = "limit $limit"; }else{ $extra = ''; }
$sql = "select user_id,body, stamp from posts where user_id in ($user_string) order by stamp desc $extra"; echo $sql; $result = mysql_query($sql);
while($data = mysql_fetch_object($result)){ $posts[] = array( 'stamp' => $data->stamp, 'userid' => $data->user_id, 'body' => $data->body ); } return $posts;
}
|
现在回到 index.php 文件,将不止一个用户 ID 传递给?show_posts()
,如下面的清单所示。这其实很简单,因为已经收集到了这些用户。现在只需使用?array_keys()
?取出键值,将会话变量加到数组中。这样,传递的数组最少包含一个值(已登录的当前用户的 ID),最多则包含当前用户 ID 和该用户追随的每个用户的 ID。
清单 19. 将一个用户数组传递给?show_posts()
?函数
$users = show_users($_SESSION['userid']); if (count($users)){ $myusers = array_keys($users); }else{ $myusers = array(); } $myusers[] = $_SESSION['userid'];
$posts = show_posts($myusers,5);
|
结束语
在本文中,您学习了如何构建一个简单的基于 PHP 的微博客服务,该服务类似于 Twitter 和 Facebook 状态更新工具。如果一切顺利的话,您就可以得到现在这样的成果,并将它添加到您的应用程序中,并根据需要加以定制。