Tad 教材網 - 線上書籍

:::

17-6 [sprintf示範]main.php

18-1 include/onUninstall.php next

\[981\]PHP入門+XOOPS模組設計
======================

[![](http://tad0616.net/uploads/dl.gif)](http://120.115.2.76/tad/tad_book3/file/9801/18.zip)

### 一、安裝、更新及移除模組用的設定

這個項目沒有也沒關係，主要是用來設定在安裝（或反安裝）模組時，要順便進行的一些指定動作，並不常用（也並沒有規定一定要放在include中）。

1. **$modversion\['onInstall'\] = "include/oninstall.php";** 
 模組安裝時要執行的程式。檔案裡頭必須包含一個函數： **xoops\_module\_install\_{dirname}** ，此函數將會在模組安裝時被執行。
2. **$modversion\['onUninstall'\] = "include/onuninstall.php";** 
 模組移除時要執行的程式。檔案裡頭必須包含一個函數： **xoops\_module\_uninstall\_{dirname}** ，此函數將會在模組反安裝時被執行。
3. **$modversion\['onUpdate'\] = "include/onUpdate.php";** 
 模組更新時要執行的程式。檔案裡頭必須包含一個函數： **xoops\_module\_update\_{dirname}** ，此函數將會在模組更新時被執行。
 
### 二、安裝時自動建立資料夾

安裝時可以讓模組建立一些必要的資料夾或者複製一些檔案等動作。  
 function xoops\_module\_install\_tad\_contact(&$module) {  
 mk\_dir(XOOPS\_ROOT\_PATH."/uploads/tad\_contact");  
 mk\_dir(XOOPS\_ROOT\_PATH."/uploads/tad\_contact/file");  
 mk\_dir(XOOPS\_ROOT\_PATH."/uploads/tad\_contact/image");  
 return true;  
 }

### 三、更新時自動更新資料庫結構

若模組的資料結構需更新，那麼可以用此機制（先檢查，後執行）：  
 function xoops\_module\_update\_tad\_contact(&$module, $old\_version) {  
 GLOBAL $xoopsDB;  
 if(chk\_chk1()) go\_update1();  
 return true;  
 }

function chk\_chk1(){  
 global $xoopsDB;  
 $sql="select count(`pic\_type`) from ".$xoopsDB->prefix("contact");  
 $result=$xoopsDB->query($sql);  
 if(empty($result)) return false;  
 return true;  
 }

function go\_update1(){  
 global $xoopsDB;  
 $sql="ALTER TABLE ".$xoopsDB->prefix("contact")." DROP `pic\_type`";  
 $xoopsDB->queryF($sql) or redirect\_header(XOOPS\_URL."/modules/system/admin.php?fct=modulesadmin",30, mysql\_error());  
 }

### 四、移除時自動備份資料夾

移除時，若覺得資料有保存價值，那麼亦可將資料保存起來。 
 function **xoops\_module\_uninstall\_tad\_contact(&$module)** { 
 GLOBAL $xoopsDB; 
 $date=date("Ymd"); 
 rename(XOOPS\_ROOT\_PATH."/uploads/tad\_contact",XOOPS\_ROOT\_PATH."/uploads/tad\_contact\_bak\_{$date}"); 
 
 return true; 
 }

:::