本文讨论内容基于 Discuz 7, Red Hat Enterprise Linux AS 4, MogileFs Server 2.17, MogileFS Client 1.08, MogileFS Utils 2.14

MogileFS 安装和配置

安装
基本安装顺序是 mogilefs-server（服务端）， MogileFS-Client（客户端）， MogileFS-Utils（工具包）。安装 MogileFS 其实并不复杂，但有些耗时，因为大多数据时间都被用在安装依赖包上了。在安装 MogileFS 之前有几个包是必需的：

Sys-Syscall-0.22.tar.gz
Danga-Socket-1.56.tar.gz
String-CRC32-1.4.tar.gz
Gearman-1.07.tar.gz
Gearman-Client-Async-0.93
Net-Netmask-1.9015.tar.tar 
Perlbal-1.70.tar.tar

若在安装过程中还提示其它包不存在，可以根据提示到search.cpan.org搜索相应的包装上。具体安装步骤可以参考这里或这里。

安装成功后，会提示安装了以下文件，在下文的 MogileF S配置部分中会提到。

/usr/bin/mogilefsd
/usr/bin/mogstored
/usr/bin/mogdbsetup
/usr/bin/mogautomount
/usr/bin/mogtool
/usr/bin/mogadm

数据库配置
MogileFS 通过数据库来维护文件的存储节点和存储份数等相关属性。 创建一个数据库命名为 mogilefs，创建一个用户 mogile，设置密码为 mogile

# mysql
mysql> CREATE DATABASE mogilefs;
mysql> GRANT ALL ON mogilefs.* TO 'mogile'@'%';
mysql> SET PASSWORD FOR 'mogile'@'%' = PASSWORD('mogile');
mysql> FLUSH PRIVILEGES;
mysql> quit

然后通过 MogileFs 自带的工具创建表

# /usr/bin/mogdbsetup --dbhost=db.yourdomain.com --dbname=mogilefs --dbuser=mogile --dbpassword=mogile

tracker 配置
编辑 /etc/mogilefs/mogilefsd.conf

db_dsn DBI:mysql:mogilefs
db_user mogile 
db_pass mogile 
conf_port 6001 
listener_jobs 5

存储节点配置

• 先编辑配置文件 /etc/moiglefs/mogstored.conf

  httplisten=192.168.0.7:7500 
  mgmtlisten=192.168.0.7:7501 
  docroot=/var/mogdata

• 向系统添加存储节点主机，并查看是否添加成功。这里我们添加的主机名称是 file.yourdomain.com，IP为192.168.0.7

  # /usr/bin/mogadm --trackers=192.168.0.7:6001 host add file.yourdomain.com --ip=192.168.0.7 --port=7500 --status=alive
  # /usr/bin/mogadm --trackers=192.168.0.7:6001 host list

• 向系统添加存储节点设备，并查看是否添加成功

  # mkdir /var/mogdata/dev1
  # /usr/bin/mogadm --trackers=192.168.0.7:6001 device add file.yourdomain.com 1
  # /usr/bin/mogadm --trackers=192.168.0.7:6001 device list

  这里的 1 代表 file.yourdomain.com 主机下的存储设备编号，对应存储目录为 /var/mogdata/dev1

• 添加存储域。在 MogileFs 中，文件通过 KEY 来引用，KEY 在某个存储域下是唯一的。我们添加一个 bbs.yourdomain.com 域，论坛里的附件都存储到该域下。

  # /usr/bin/mogadm --trackers=192.168.0.7:6001 domain add bbs.yourdomain.com
  # /usr/bin/mogadm --trackers=192.168.0.7:6001 domain list

• 添加存储类别。在 MogileFs 中可以设置不同的存储类别存储不同份数的文件副本。我们添加一个 attach 类，每个文件至少存储 2 份

  # /usr/bin/mogadm --trackers=192.168.0.7:6001 class add bbs.yourdomain.com attach --mindevcount=2
  # /usr/bin/mogadm --trackers=192.168.0.7:6001 class list

最后在防火墙配置上述几个端口访问规则。现在可以启动 MogileFs，并查看进程与服务状态。

# /usr/bin/mogstored --daemon
# /usr/bin/mogilefsd -c /etc/mogilefs/mogilefsd.conf --daemon
 
# ps -fe |grep mogstored
# ps -fe |grep mogilefsd
 
# /usr/bin/mogadm --trackers=192.168.0.7:6001 check
# /usr/bin/mogadm --trackers=192.168.0.7:6001 stats

注：上述配置例子基于tracker，存储节点均在同一台主机，而实际使用上需要将存储节点分配到不同主机上才是真正意义上的分布式存储。甚至于 tracker 也可以是多个。

安装 MogileFS PHP 扩展

从 http://svn.usrportage.de/php-mogilefs/trunk/ 获取源代码编译安装：

$ phpize
$ ./configure
$ make install

将生成的 php-mogilefs.so 复制到 PHP 扩展目录，在 php.ini 添加一行扩展配置：

extension=php-mogilefs.so

重启 WEB 服务，用 phpinfo() 函数测试，如果显示结果如下图显示则表示安装成功

该扩展提供的方法和函数可以直接使用，不过为了方便维护，可以对之进行一下简单的封装。

改造 Discuz 的附件系统

接下来会应用到 WordPress 的 Hook 机制，详见WordPress 的 Hook 机制在 Discuz 二次开发中的应用

附件上传

在 Discuz 7 中附件的上传由include/post.func.php文件里的attach_upload()函数处理，我们在其中增加将附件添加到 MogileFS 的处理。由于 Discuz 7 支持远程上传附件到 FTP，并且可以设置成只上传到远程 FTP，这会删除上传到 WEB 服务器的原始附件，所以要在这之前处理。

// begin of hack
dz_do_action('mogilefs_attachment_upload', $attach, $target);
// end of hack
 
// 找到以下这行代码，在这之前添加以上代码
$attach['remote'] = !$swfupload ? ftpupload($target, $attach) : 0;

mogilefs_attachment_upload 函数用来处理往 MoigleFs 添加附件。在前面提到，MogileFs 通过 KEY 来引用文件，我采用的 KEY 的规则是：

attach_{attachment_md5}_{ext}
attach_{attachment_md5}_thumb_jpg

{md5} 是 Discuz 附件表 attachment 字段的 MD5 值，{ext} 是附件的扩展名。注意，Discuz 存储文件时会把部分可能不安全附件的后缀名更改为 attach。Discuz 中图片附件的缩略图均为 JPG 格式，所以 thumb_jpg 表示 JPG 格式缩略图的意思。

mogilefs_attachment_upload() 函数的处理流程:

1. 判断 MogileFs 扩展是否加载，否则退出处理
2. 获取 MogileFs 单个操作实例
3. 根据传入的附件信息（$target, $attach）生成 attach_key，然后往 MogileFs 提交文件
4. 如果附件是图片，检查图片的缩略图是否存在，如果存在，则生成 thumb_key ，然后往 MogileFs 提交缩略图文件

附件删除

Discuz 7 中附件文件的删除由include/global.func.php文件里的dunlink()函数处理，我们在该函数结束之前添加 MogileFs 的文件删除处理：

dz_do_action('mogilefs_attachment_delete', $filename, $havethumb);

mogilefs_attachment_delete() 函数的处理流程:

1. 判断 MogileFs 扩展是否加载，否则退出处理
2. 获取 MogileFs 单个操作实例
3. 根据传入的附件路径 $filename 生成 attach_key，然后通过 MogileFs 提供的方法删除文件
4. 根据 $havethumb 判断是否存在缩略图，若存在则生成 thumb_key，然后通过 MogileFs 提供的方法删除文件

由于附件的上传中可能出现错误，Discuz 7 会做回滚处理删除本次上传出现错误之前已经正常上传的附件，而这些文件同样已经被上传到 MogileFs，故也要做删除处理：
修改include/post.func.php文件里的upload_error()函数和ftpupload_error()：

function upload_error($message, $attacharray = array()) {
  if(!empty($attacharray)) {
    foreach($attacharray as $attach) {
      @unlink($GLOBALS['attachdir'].'/'.$attach['attachment']);
      // begin of hack
      dz_do_action('mogilefs_attachment_delete', $attach['attachment'], true);
      // end of hack
    }
  }
  showmessage($message);
}
 
function ftpupload_error($source, $attach) {
  @unlink($source);
  if($attach['thumb']) {
    @unlink($source.'.thumb.jpg');
  }
  // begin of hack
  dz_do_action('mogilefs_attachment_delete', $source, $attach['thumb']);
  // end of hack
  showmessage('post_attachment_remote_save_error');
}

附件读取
附件的读取需要在 Discuz 后台打开“下载附件来路检查”选项，因为附件的读取操作是 hook 在attachment.php文件上的。

• 缩略图处理

  // begin of hack
  dz_do_action('mogilefs_attachment_fetch', $attach['attachment'], true);
  // end of hack
   
  //找到下面这行代码，在此之前添加上述代码
  getlocalfile($attachdir.'/'.$attach['attachment'].'.thumb.jpg');

• 其他附件处理
  先删除attachment.php中的以下代码

  if(!$attach['remote'] && !is_readable($filename)) {
    showmessage('attachment_nonexistence');
  }

  然后将以下代码添加到getlocalfile()函数的起始处，接管该函数读取本地附件的处理。

  // begin of hack
  dz_do_action('mogilefs_attachment_fetch', $filename);
  // end of hack

mogilefs_attachment_fetch() 的处理流程

1. 判断 MogileFs 扩展是否加载，否则退出处理
2. 获取 MogileFs 单个操作实例
3. 根据传入参数判断读取的是缩略图还是原附件，生成 thumb_key 或 attach_key
4. 通过 MogileFs 扩展提供的方法读取文件内容
5. 输出

当然，此外还有一些细节处理，如文件大小，文件头响应输出等，不再赘述。

Related Posts

• WordPress 的 Hook 机制在 Discuz 二次开发中的应用

WordPress 内部提供了许多 Hook（钩子），以便插件可以将相应的 action 或 filter 挂接上去接管或改进 WordPress 的默认处理来达到自己期望的目的，在处理完毕后将控制权重新交给 WordPress。而我们所要做的就是将这种机制移植到 Discuz 中，所幸的是，WordPress 的 Hook 机制并没有过多地依赖于它的其它核心程序，所以基本不需要做多少修改就可以拿来使用。

基本步骤

1. 在 Discuz 安装目录新建一个文件夹，命名为extra，复制 WordPress 的wp-includes/plugin.php文件到此文件夹。为了符合 Discuz 名命名规范，将文件重命名为plugin.func.php
2. 为了避免潜在的函数命名冲突，可以将plugin.func.php文件里的函数名称都加上前缀，例如do_action()修改成dz_do_action()；另外 plugin_basename(), register_activation_hook(), register_deactivation_hook(), register_uninstall_hook() 等函数可以删除。
3. 在extra文件夹新建一个php文件，命名为hooks.inc.php，这里放置绝大部分 filter 和 action，将它们放在该文件中的一个最大的好处是方便集中维护。
4. 载入相关文件。打开include/common.inc.php文件，找到

   require_once DISCUZ_ROOT.'./config.inc.php';

   在该行代码下面添加

   require_once DISCUZ_ROOT.'./extra/plugin.func.php';
   require_once DISCUZ_ROOT.'./extra/hooks.inc.php';

   至此，基本的 Hook 机制已经建立

实际应用示例

接下来我们就可以开始添加自己的代码了。举个例子，Discuz 中$discuz_auth_key是这样定义的：

$discuz_auth_key = md5($_DCACHE['settings']['authkey'].$_SERVER['HTTP_USER_AGENT']);

如果想将$discuz_auth_key的定义修改为md5(authkey+user_agent+ip)这样的形式，我们可以通过 filter 来实现。在$discuz_auth_key的定义代码下一行添加：

// 生成一个名为 discuz_auth_key 的钩子
$discuz_auth_key = dz_apply_filters('discuz_auth_key', $discuz_auth_key, $_DCACHE['settings']['authkey'], $_SERVER['HTTP_USER_AGENT'], $onlineip);

然后打开hooks.inc.php文件，添加以下代码

// 为了方便维护，所有 filter 类 hook 都以 filter_ 为前缀
function filter_discuz_auth_key($discuz_auth_key, $authkey, $ua, $ip) {
  // 符合自己设定的条件时才重新定义 authkey
  // 否则返回 Discuz 定义的 discuz_auth_key 原值
  if ($authkey && $ua && $ip) {
    $discuz_auth_key = md5($authkey . $ua . $ip);
  }
  return $discuz_auth_key;
}
 
// 将 filter 函数 filter_discuz_auth_key 挂接到 discuz_auth_key 钩子上
// 第三个参数的值 10 代表执行优先级，因为一个钩子上可以挂接多个callback函数
// 第四个参数的值 4 代表允许 filter_discuz_auth_key 函数接收的参数个数
add_filter('discuz_auth_key', 'filter_discuz_auth_key', 10, 4);

这样便达到我们所要的效果了。当然有些情况下还是无法避免了二次开发代码与原代码的夹杂在一起，不过由于有了 Hook 机制，这种情形已经可以大大减少了。

相关阅读
WordPress Plugin API

Related Posts

• Media Temple Hacked
• 在 Discuz 中应用 MogileFS 分布式文件存储系统
• At Reply Mail Notification 1.0 Release
• LBS 转 WordPress 不完全记录
• Wordpress 糟糕的重复评论检测方式
• At Reply Mail Notification 测试贴
• 让 Wordpress 自动删除 Post Revisions
• 让 Google Sitemaps Generator 可以忽略指定的日志分类
• Wordpress 分页文章静态化的更优解决方案
• 升级到 WordPress 2.6