安裝moodle 1.8.2（OS and Web Server: FreeBSD 6.2 and Apache22, PHP5.1.6）上傳中文檔名的檔案後無法正確顯示中文名問題，先到網路搜尋解決方法，在這幾篇看到修正方法：

1.http://moodle.club.tw/moodle/mod/forum/discuss.php?d=66&parent=163 

2.http://plog.hlps.tcc.edu.tw/plog/post/1/2945

以下是個人的說明與提出一些修正的看法

於config.php加入

$CFG->unicodecleanfilename = true;

即可正常上傳中文檔名

在lib/moodlelib.php下亦有這段說明

/**
 * Cleans a given filename by removing suspicious or troublesome characters
 * Only these are allowed: alphanumeric _ - .
 * Unicode characters can be enabled by setting $CFG->unicodecleanfilename = true in config.php
 *
 * WARNING: unicode characters may not be compatible with zip compression in backup/restore,
 *          because native zip binaries do weird character conversions. Use PHP zipping instead.
 *
 * @param string $string  file name
 * @return string cleaned file name
 */

因此似乎雖解決上傳中文檔名問題但zip壓縮卻無法使用中文檔名，以moodle 內建pclzip也許可解決???

 以下有兩個問題待解決：

1. 下載中文檔名於IE下有問題，會轉成英文檔名，Firefox可正常下載
2. 無論在firefox或IE均無法壓縮與解壓縮中文檔名（備份亦然）

產生此問題原因分析：

1. IE6對於UTF-8中文檔名無法正常下載，IE7則只對zip的中文檔會產生問題其餘對office或wmv,gif,jpg不會產生問題，所以對於若是IE瀏覽器下載時將檔名轉成Big5應可解決。
2. 壓縮與解壓縮問題，原因在於php的basename() function對於UTF-8對中文檔名會回傳成無中文檔名或不正確之檔名(IE6與IE7不一樣,IE7較接近Frefox)，改寫basename　function應可解決。不知道其他php版本會不會這樣？？？沒試過。

文章最底下有一小段程式碼支持上述說法。

==================================

詳細改寫程式碼，請參閱以下說明： 

 1. 下載中文檔名於IE下有問題，Firefox可正常下載

 雖然註解lib/file.php下的這一行
//$filename = $args[count($args)-1];
send_file($pathname, $filename, $lifetime, $CFG->filteruploadedfiles, false, $forcedownload); 

可解決下載問題，但使用 //$filename = $args[count($args)-1];

則造成下一行程式call send_file(....)的filename參數為null。

trace send_file function(在lib/filelib.php檔案中)以filename無法正確取得mimetype，不知會不會造成隱含的問題？

經過簡化後測試（參閱最下面程式碼）發現應該是以@header('Content-Disposition: attachment; filename='.$filename);
送出UTF-8中文檔名造成IE錯誤（與IE是否設定以UTF-8傳送URL無關）

因此做了以下修改

1. file.php不註解 $filename = $args[count($args)-1];

2. lib/filelib.php加入一小段程式碼： 

header('Last-Modified: '. gmdate('D, d M Y H:i:s', $lastmodified) .' GMT');

if (check_browser_version()){
        $filename=iconv("UTF-8","Big5",$filename);
}

if ($forcedownload) {
       @header('Content-Disposition: attachment; filename='.$filename);
} else {
       @header('Content-Disposition: inline; filename='.$filename);   
 }

 紅色部份是加入的程式碼，check_browser_version()是在lib/moodlelib.php內的function用來檢查用戶端使用何種瀏覽器

2. php之basename() 內建function無法正確傳回中文檔名，造成壓縮與解壓縮問題：
於lib/moodlelib.php加一function 來取代原來的basename

function file_basename($file= null) {
    if($file=== null || strlen($file)<= 0) {
        return null;
    }
  
    $file= explode('?', $file);
    $file= explode('/', $file[0]);
    $basename= $file[count($file)-1];

    return $basename;  
}

因此需修改的程式碼部份說明如下:

A. files/index.php修改如下

在case "paste": 修改
$shortfile = basename($file);->$shortfile = file_basename($file);

在case "unzip": 修改
$file = basename($file);->$file = file_basename($file);

 在case "listzip": 修改
$file = file_basename($file);->$file = file_basename($file);

 約825行處$fileurl改成$filesafe(fileurl為未編碼的檔名，filesafe為編碼的檔名), 則不管IE6或 IE7均能正常取得正確的檔名

else if ($icon == "zip.gif") {
                $edittext .= "<a href=\"index.php?id=$id&wdir=$wdir&file=$filesafe&action=unzip&sesskey=$USER->sesskey&choose=$choose\">$strunzip</a> ";
                //
                $edittext .= "<a href=\"index.php?id=$id&wdir=$wdir&file=$filesafe&action=listzip&sesskey=$USER->sesskey&choose=$choose\">$strlist</a> ";

B. 修改lib/moodlelib.php

在lib/moodlelib.php

修改function zip_files(..)

//$destfilename = $path_parts["basename"];  //The name of the zip file
    $destfilename = file_basename($destination);

//$filestozip .= escapeshellarg(basename($filetozip));
$filestozip .= escapeshellarg(file_basename($filetozip)); 

修改 function unzip_file(...)

//$zipfilename = $path_parts["basename"];  //The name of the zip file
    $zipfilename = file_basename($zipfile);

經過以上修改無論在Firefox, IE6 or IE7均能正常使用中文檔名了。 

簡化測試程式碼
--------------------------------------------

<?
//echo basename("/usr/local/test/中文測試檔.zip");

$filename=iconv("UTF-8","Big5","中文測試檔.zip");
//$filename="中文測試檔.zip";
@header('Content-Disposition: attachment; filename='.$filename);
@header('Content-Type: application/zip');
readfile_chunked("中文測試檔.zip");

//readfile_chunked 為lib/filelib.php內的function
function readfile_chunked($filename, $retbytes=true) {
    $chunksize = 1*(1024*1024); // 1MB chunks - must be less than 2MB!
    $buffer = '';
    $cnt =0;// $handle = fopen($filename, 'rb');
    $handle = fopen($filename, 'rb');
    if ($handle === false) {
        return false;
    }

    while (!feof($handle)) {
        @set_time_limit(60*60); //reset time limit to 60 min - should be enough for 1 MB chunk
        $buffer = fread($handle, $chunksize);
        echo $buffer;
        flush();
        if ($retbytes) {
            $cnt += strlen($buffer);
        }
    }
    $status = fclose($handle);
    if ($retbytes && $status) {
        return $cnt; // return num. bytes delivered like readfile() does.
    }
    return $status;
}
?>