相信很多人都遇到了這件事情，從 TC 把資料匯出之後，再匯入其他（或是原來）的 TC 的時候，鏈結全部都不見了，只剩下一個鏈結而已。這件事情，從 TC 1.7 推出之後就已經存在，而，這個錯誤並不單純只是程序上的錯誤，而是整個資料結構上的錯誤，老實說，我覺得 TC 團隊會出這樣的錯誤實在是該打屁股了。
我們先來看看 tc_Links 這個資料表：
[code]
/// setup.php Line 1319
CREATE TABLE {$_POST['dbPrefix']}Links (
pid int(11) NOT NULL default '0',
blogid int(11) NOT NULL default '0',
id int(11) NOT NULL default '0',
category int(11) NOT NULL default '0',
name varchar(255) NOT NULL default '',
url varchar(255) NOT NULL default '',
rss varchar(255) NOT NULL default '',
written int(11) NOT NULL default '0',
visibility tinyint(4) NOT NULL default '2',
xfn varchar(128) NOT NULL default '',
PRIMARY KEY (pid),
UNIQUE KEY blogid (blogid,url)
) $charset;
[/code]
眼尖的人可以看到，有兩個關鍵欄位，pid 與 id，而這兩組關鍵欄位，pid 是主鍵，兩欄位都沒有設定 auto_increment，至於為什麼不設定，這一點我也不知道。既然他沒有設定 auto_increment 這個附加條件，那麼，我們再來看看當資料轉出（匯出）時，他的格式：
[code]
/// 僅節錄 Links 匯出的部分
<link><url>http://nzma.ushiisland.net/</url><title>NZMA::STUDIO VOICE R&W</title><feed></feed><registered>1212398140</registered></link>
<link><url>http://fusionism.blogspot.com/</url><title>Fusionism Art</title><feed>http://fusionism.blogspot.com/feeds/posts/default</feed><registered>1212398085</registered></link>
<link><url>http://blog.xuite.net/nzma/diary</url><title>在草原的中心‧不存在的騎士</title><feed>http://blog.xuite.net/nzma/diary/rss.xml</feed><registered>1212560707</registered></link>
/// 後略...
[/code]
由這樣的匯出資料，我們可以猜到 id 與 pid 並沒有在他的匯出清單中，也就是說，這兩項值將來可以在匯入的時候，依照 migrational 的設定（true or false）來決定是否覆寫原來的資料。這種情況在分類的部分也可以看出端倪，分類匯出時，也沒有帶入 id 這項設定：
[code]
/// 僅節錄 Category 匯出的部分
<category><name>Chats</name><priority>1</priority>
<category><name>Moblog</name><priority>39</priority></category>
<category><name>blahblah</name><priority>40</priority></category>
<category><name>nothing else</name><priority>41</priority></category>
<category><name>funny</name><priority>42</priority></category>
<category><name>note note note</name><priority>43</priority></category>
<category><name>dark cooking</name><priority>44</priority></category>
</category>
<category><name>Life</name><priority>2</priority></category>
<category><name>Photography</name><priority>3</priority></category>
/// 後略...
[/code]
所以，在匯入與匯出這個部分，其實在程序上並沒有太大的問題。接著我們轉向 TC 的核心原件（Components）來看看。當 TC 在做匯入與匯出時，使用的原件是以 Data 為命名規則的所有原件庫，所以，在調用資料庫的動作時，全部都是以個別的原件庫去完成。那，我們就來看看
Textcube.Data.Link.php 到底做了甚麼事：
展開 Textcube.Data.Link.php 原始碼...
[code]
<?php
/// Copyright (c) 2004-2008, Needlworks / Tatter Network Foundation
/// All rights reserved. Licensed under the GPL.
/// See the GNU General Public License for more details. (/doc/LICENSE, /doc/COPYRIGHT)
// NOTE : it does not support to save link category yet,
// due to compartibility issues with other software under 'Project Tattertools.'
class Link {
function Link() {
$this->reset();
}
function reset() {
$this->error =
$this->id =
$this->title =
$this->url =
$this->feed =
$this->registered =
null;
}
function open($filter = '', $fields = '*', $sort = 'id') {
global $database;
if (is_numeric($filter))
$filter = 'AND id = ' . $filter;
else if (!empty($filter))
$filter = 'AND ' . $filter;
if (!empty($sort))
$sort = 'ORDER BY ' . $sort;
$this->close();
$this->_result = POD::query("SELECT $fields FROM
{$database['prefix']}Links WHERE blogid = ".getBlogId()." $filter
$sort");
if ($this->_result)
$this->_count = POD::num_rows($this->_result);
return $this->shift();
}
function close() {
if (isset($this->_result)) {
POD::free($this->_result);
unset($this->_result);
}
$this->_count = 0;
$this->reset();
}
function shift() {
$this->reset();
if ($this->_result && ($row = POD::fetch($this->_result))) {
foreach ($row as $name => $value) {
if ($name == 'blogid')
continue;
switch ($name) {
case 'name':
$name = 'title';
break;
case 'rss':
$name = 'feed';
break;
case 'written':
$name = 'registered';
break;
}
$this->$name = $value;
}
return true;
}
return false;
}
function add() {
unset($this->id);
if (!isset($this->url))
return $this->_error('url');
if (!isset($this->title))
return $this->_error('title');
if (!$query = $this->_buildQuery())
return false;
if (!isset($this->registered))
$query->setAttribute('written', 'UNIX_TIMESTAMP()');
if (!$query->insert())
return $this->_error('insert');
$this->id = $query->id;
return true;
}
function update() {
if (!isset($this->id))
return $this->_error('id');
if (!$query = $this->_buildQuery())
return false;
if (!$query->update())
return $this->_error('update');
return true;
}
function getCount() {
return (isset($this->_count) ? $this->_count : 0);
}
/*@static@*/
function getId($url) {
global $database;
if (empty($url))
return null;
return POD::queryCell("SELECT id FROM
{$database['prefix']}Links WHERE blogid = ".getBlogId()." AND url = '"
. POD::escapeString($url) . "'");
}
/*@static@*/
function getURL($id) {
global $database;
if (!Validator::number($id, 1))
return null;
return POD::queryCell("SELECT label FROM {$database['prefix']}Links WHERE blogid = ".getBlogId()." AND id = $id");
}
function _buildQuery() {
global $database;
$query = new TableQuery($database['prefix'] . 'Links');
$query->setQualifier('blogid', getBlogId());
if (isset($this->id)) {
if (!Validator::number($this->id, 1))
return $this->_error('id');
$query->setQualifier('id', $this->id);
}
if (isset($this->url)) {
$this->url = UTF8::lessenAsEncoding(trim($this->url), 255);
if (empty($this->url))
return $this->_error('url');
$query->setQualifier('url', $this->url, true);
}
if (isset($this->title)) {
$this->title = UTF8::lessenAsEncoding(trim($this->title), 255);
if (empty($this->title))
return $this->_error('title');
$query->setAttribute('name', $this->title, true);
}
if (isset($this->feed)) {
$this->feed = UTF8::lessenAsEncoding(trim($this->feed), 255);
if (empty($this->feed))
return $this->_error('feed');
$query->setAttribute('rss', $this->feed, true);
}
if (isset($this->registered)) {
if (!Validator::number($this->registered, 1))
return $this->_error('registered');
$query->setAttribute('written', $this->registered);
}
return $query;
}
function _error($error) {
$this->error = $error;
return false;
}
}
?>
[/code]
我在這裡簡單的說明一下，當使用者匯出資料時，會使用到 Link->open()、Link->shift() 與 Link->close() 把每一筆資料都寫成 TTXML 格式並寫入匯出檔案裡。這裡有一個問題：
早在 TC 1.7 就有鏈結分類功能，匯出時並未將分類匯出。再來，第二個就是匯入。我剛剛已經說過，他應該會仿造 Category 的模式，將鏈結匯入，但是，仔細拆解 Link 類別之後，發現了兩個嚴重問題：
整個類別功能沒有因為資料結構修改而做修正，缺了 pid、id 以及 category 檢查。
在 add() 時，因為結構與匯出資料結構不符，導致匯入資料的 pid 以及 id 永遠為 0。
這也就是為什麼，鏈結匯入時，永遠只有一個鏈結的主因。我目前依照這個狀況修改了這個類別檔案，這個檔案可以用在 TC 1.7.x 版本上，請直接覆蓋掉原來的檔案。檔案請到 Google Code 下載。
http://code.google.com/p/tczh/downloads/list
Posted by hina
