請教: 這種模組開發的方式

是的, {門號} 意指 電話號碼.

我是想做一個網站的api, 接收這種形式: "http://伺服主機網址/接收點/門號/簡訊內容" 的 url 所傳進來的 data.

這個過程中, 沒有 user 手動 key 資料的動作介入, 完全是由遠端主機(資料來源)裏會有一支專門餵資料的程式, 會以上述的 url 將資料傳到伺服主機這邊來.

而我所要做的安排是: 伺服主機這邊收到了, 就從 hook_menu() 處理 url 開始, 直到所有資料都存入了該存的資料庫欄位裏, 並回應結果訊息.

若照一般 php 程式的寫法來做的話, 是不成問題的. 但現在卡在對於 drupal hook system 不熟, 整個流程分解成好幾個小動作: 接收url, 剖析參數, 針對所需的 content type 新增 node, 建立 node 之間的關聯, 每個小動作對我而言都形同卡關, 還要持續奮鬥下去. XD

node 之間的關聯, 我想用 CCK 的 node reference 做的原因是: 後續 Views 對 CCK 的支援比較完整, 要拉報表就簡單多了.

目前是不了解該如何在程式中建立 CCK node reference 來聯結{門號}及{已發簡訊}, 只知應該跟 hook_nodeapi 有關.

嗨嗨, Kay.L 大:

我最後發現原來是我想偏了, 未必要跟 nodeapi 有關. 您在部落格上提到的 node_save() 即是關鍵.

要儲存{門號}跟{已發簡訊}之間的關聯(CCK node reference)沒有想像中那麼複雜, 因為執行 node_save($node) 或是 content_insert($node) 時, 其內部運作已把細節都處理掉了.

以下是我整理出來的程式碼, 目前已把原來發問要做的東西搞定. 或許還有些細節沒處理到, 但至少確定方法是可行的了.

<?php
function node_example_menu() {
// 在 hook_menu 當中, 定義接收參數的路徑, 把接收到的參數引導到指定的callback: _node_example_sms 處理
$items['sms/%/%'] = array(
'title' => 'Node example: (sms)',
'page callback' => '_node_example_sms', // 指定 callback
'page arguments' => array(1, 2), // 指定要傳給 _node_example_sms 的參數是 第1個, 及第2個. (0-base, 第0個是 sms)
'type' => MENU_CALLBACK,
'access callback' => TRUE
);

return $items;
}

function _node_example_sms($mobile_phone, $sms) {
// 若門號不是數字, 則回傳 'false', 代表錯誤.
if ( !is_numeric($mobile_phone) ) {
return 'false';
}
//先新增一筆{門號}, (暫不考慮例外處理)
$mp = _build_new_mobile_phone($mobile_phone);

//再新增一筆{已發簡訊}, (暫不考慮例外處理)
_build_new_sms($mp, $sms);

//回傳 'ok', 代表處理成功.
return 'ok';

}

function _build_new_sms(&$mobile_phone, $title_hint=NULL){
$newnode = new stdClass();
$newnode->is_new=1;
$newnode->title = !empty($title_hint) ? $title_hint:"0";
$newnode->type = 'sms'; // {已發簡訊} 的 content type 名稱.
$newnode->uid = 1;
$newnode->teaser = "";
$newnode->status = 0; //unpublished
$newnode->created = time();
$newnode->changed = time();
$contenttype = content_types($newnode->type);

//在此指定 {門號} 的 nid 給 {已發簡訊} 的 node reference.
$newnode->field_mobile_phone[0]['nid'] = $mobile_phone->nid;

// 若 $newnode 尚有屬性在上面未給值, 卻在widget裏有定義預設值, 則在此指定預設值:
foreach ($contenttype['fields'] as $fieldname => $field) {
if(isset($field['widget']['default_value']) && empty($newnode->$fieldname) ) {
$newnode->$fieldname = $field['widget']['default_value'];
}
}
// node_save 儲存成功後, $newnode 的 nid 及 vid 自動會被填值.
node_save($newnode);

// 若 $newnode 裏有 CCK 建立的欄位, 則由 cotent_insert 負責處理儲存的細節.
content_insert($newnode);

return $newnode;
}

function _build_new_mobile_phone($title_hint){ // {門號}的新增函式, 結構跟{已發簡訊}的新增函式差不多.
$newnode = new stdClass();
$newnode->is_new=1;
$newnode->title = !empty($title_hint) ? $title_hint:"0";
$newnode->type = 'mobile_phone'; // {門號} 的 content type 名稱.
$newnode->uid = 1;
$newnode->teaser = "";
$newnode->status = 0; //unpublished
$newnode->created = time();
$newnode->changed = time();
$contenttype = content_types($newnode->type);
foreach ($contenttype['fields'] as $fieldname => $field) {
if( isset($field['widget']['default_value']) && empty($newnode->$fieldname) ) {
$newnode->$fieldname = $field['widget']['default_value'];
}
}
node_save($newnode);
content_insert($newnode);

return $newnode;
}

?>