環境設定

以下介紹 config.php 各項參數的功能。

Part 1:程式基本設定

MySQL伺服器連接設定 (MySQL 版)

MYSQL_SERVER
MySQL 伺服器之位置。如果 MySQL 與網頁伺服器是同一台,設定為 localhost 即可。如果 MySQL 埠號是其他值,請用冒號指定 (例如 :4706)
MYSQL_USER
MySQL 連結使用者名稱。請依照 MySQL 伺服器帳號權限設定填寫。
MYSQL_PASSWORD
MySQL 連結使用者密碼。同上。
MYSQL_DBNAME
MySQL 連結資料庫名稱。此資料庫必須已存在,如果不存在請先利用 phpMyAdmin 等工具建立。有些伺服器會綁定帳號使用的資料庫名稱,這時請按照伺服器設定填寫。

伺服器常態設定

PHP_SELF
主程式名。如果您手動修改了 pixmicat.php 的主程式檔名,請在此修改為新的檔名。
TIME_ZONE
時區設定。時間是格林威治時間加上偏差時間,請參照自身地區修改而非伺服器所在地區。不過有些伺服器在 PHP 抓取時間時就已校正,取得的時間就不是格林威治時間,會造成時間錯亂情況。
PIXMICAT_LANGUAGE
程式介面語系。目前有 en_US, ja_JP 與 zh_TW 可用。
HTTP_UPLOAD_DIFF
HTTP 上傳所有位元組與實際位元組之允許誤差值。防止上傳中斷的檢查值,如果預計上傳位元組跟實際上傳位元組超過這個設定,將視為上傳不完整。
memory_limit
PHP 運行的最大記憶體使用量。大尺寸圖檔要縮圖時需要將其轉成點陣圖再操作,耗費的記憶體自然不是預設值可負荷的。本設定建議設大一點,以使大圖生成縮圖能正常。 注意有的伺服器關閉此修改功能!

FileIO設定 (PIO 版)

FILEIO_BACKEND
FileIO後端指定。依照 fileio 目錄下的檔案決定,目前有 local (本地端), normal (一般), ftp (FTP傳輸) 幾種。本地端與一般的不同是本地端完全依賴檔案操作,一般有使用資料庫做索引。建議使用 normal 即可。
FILEIO_INDEXLOG
FileIO索引記錄檔。此檔案儲存在本機端,會自動判斷伺服器環境而使用 SQLite 或 Log 檔儲存。裡頭儲存著檔名和檔案大小、對應位置等資訊。
FILEIO_PARAMETER
FileIO參數。每個後端需要一些參數,而可接受的參數亦不一樣。請參閱 FileIO 條目的 config.php 參數設定 以取得參數詳細說明。

PIO資料來源設定 (PIO 版)

CONNECTION_STRING
PIO 連線字串。跟 FileIO 參數差不多,PIO 同樣需要傳入適當的連線字串才能正常使用。請參考 PIO 資料來源 I/O 條目的 config.php 連線字串設定 取得詳細說明。

Part 2:板面各項細部功能設定

SQLLOG (legacy SQL版專用)
MySQL 記錄資料表名稱。此資料表名稱不一定要存在,不存在會自動建立結構,已存在會使用既有資料。
LOGFILE (legacy Log版專用)
投稿文字記錄檔檔名。儲存各筆文章的文字檔。
TREEFILE (legacy Log版專用)
樹狀結構記錄檔檔名。儲存討論串結構的文字檔。
IMG_DIR
圖片存放目錄。存放原圖的目錄。
THUMB_DIR
預覽圖存放目錄。存放預覽圖的目錄。
PHP_SELF2
入口檔名。第 0 頁的靜態頁面名稱。
PHP_EXT
第一頁以後生成檔案之副檔名。第 1 頁以後的靜態頁面副檔名。
TITLE
網頁標題。會用在 <title></title> 和 頁面上方的標題顯示。
HOME
回首頁的連結。出現在頁面右上方導覽列的 [回首頁]。
TOP_LINKS
頁面右上方的額外連結。會出現在頁面右上方導覽列。
ADMIN_PASS
管理員密碼。登入後端管理使用。(8th.Release 之前使用,8th.Release 之後以 ADMIN_HASH 替代)
ADMIN_HASH
管理員密碼雜湊值。為明文密碼經過計算後的片段,請使用 公用程式 的 genhash.php 計算。
IDSEED
生成 ID 之隨機種子。供 ID 辨識機能生成每個使用者之特定 ID 使用的 Salt Key。

管理員キャップ(Cap)設定

CAP_ENABLE (使用:1 不使用:0)
是否使用管理員キャップ。如果要使用 Admin Cap 請設為使用。
CAP_NAME
管理員キャップ識別名稱。當要使用 Admin Cap 時輸入名稱必須與此相符。
CAP_PASS
管理員キャップ啟動密碼。當要使用 Admin Cap 時請在 E-mail 欄輸入#啟動密碼,如#test。
CAP_SUFFIX
管理員キャップ後綴字元。不同於其他使用者的證明,此值請務必有 ★ 符號以便程式防止偽造。
CAP_ISHTML (是:1 否:0)
管理員キャップ啟動後內文是否接受 HTML 標籤。設為是可以自由使用 HTML 標記,但請記得遵守 XHTML 1.1 的語法規範。

功能切換

USE_FLOATFORM (是:1 否:0)
是否使用投稿表單自動隱藏。使用的話表單會自動隱藏,當滑鼠移到[投稿]區塊才會顯示,不使用的話表單會在上方占一塊空間。
USE_SEARCH (是:1 否:0)
是否開放搜尋功能。可選擇關閉搜尋功能。
USE_UPSERIES (是:1 否:0)
是否啟用連貼機能。啟用後表單會有 [連貼機能] ,勾選並開主題後會自動導向到主題下以方便連貼。
RESIMG (開啟:1 關閉:0)
是否接受回應附加檔案。關閉即回文不能附圖。
AUTO_LINK (是:1 否:0)
是否自動將討論串內文 URL 作成超連結。關閉後 URL 位置不會自動變成連結。
KILL_INCOMPLETE_UPLOAD (是:1 否:0)
是否自動刪除上傳不完整附加檔案。設成否只會在文章下附加上傳不完整的提示。
ALLOW_NONAME (強制砍名:2 是:1 否:0)
是否接受匿名發送。強制砍名是指只留下 Trip 其他一律不顯示。
DISP_ID (強制顯示:2 選擇性顯示:1 永遠不顯示:0)
是否使用 ID 辨識機能。如果設成選擇性顯示當 E-mail 有輸入時 ID 會變成 ???。
CLEAR_SAGE (是:1 否:0)
是否清除不推文模式時 E-mail 中的「sage」關鍵字。
USE_QUOTESYSTEM (是:1 否:0)
是否使用引用瀏覽系統 (自動轉換»No.xxx文字成連結並導引)。設成否可以關閉運算,節省系統資源。
SHOW_IMGWH (是:1 否:0)
是否顯示附加圖檔之原檔長寬尺寸。
USE_CATEGORY (是:1 否:0)
是否開啟使用類別標籤分類功能。類似部落格的標籤分類功能,或是 YouTube, Flickr 等標籤設定,可以標記以方便日後尋找同類型的圖或文。
USE_RE_CACHE (是:1 否:0)
是否使用回應頁面顯示快取功能。可以將回應頁面輸出結果作成檔案快取,在討論串沒有改變的狀態下使用以降低負擔。注意啟用後會有資訊延遲時間,可以 Ctrl + F5 強制更新快取檔。
USE_XHTML (是:1 否:0)
是否回傳 XHTML 檔頭讓瀏覽器以更嚴格的方式解析。XHTML 規定檔頭 MIME 必須回傳正確,但是開啟時某些狀況網頁可能無法顯示,此選項可以關閉以避免此情形。(註: 遇到 IE 會自動關閉此功能,因其不支援)

模組載入

$ModuleList
模組系統載入模組名稱陣列。假設欲引入模組名為 mod_test.php,則填入 'mod_test' 即可。

範例:
$ModuleList[] = 'mod_test';
$ModuleList[] = 'mod_dummy';

封鎖設定

BAN_CHECK (關閉:0, 開啟:1)
綜合性封鎖檢查功能。包括 IP/Hostname 封鎖黑名單和 DNSBL 黑白名單。
$BANPATTERN
IP/Hostname 封鎖黑名單。符合名單上的條件者將無法發文,接受完全相符、萬用字元 (*, ?) 、正規表達式 (Regular Expression) 和 CIDR Notation1 四種寫法。正規表達式寫法需要以 / 包住,CIDR Notation 需要 IP + /xx 的方式

範例:
完全相符: '127.0.0.1' (127.0.0.1 O;127.0.0.2 X)
萬用字元: '192.168.0.*' (192.168.0.3 O;192.168.1.3 X)
正規表達式: '/^.+\.proxy\.com$/' (gate1.proxy.com O;proxy2.com.tw X)
CIDR Notation: '192.168.0.1/20' (192.168.7.243 O;192.168.18.144 X)

$DNSBLservers
使用的 DNSBL 查詢伺服器列表。陣列首項數字代表使用使用伺服器個數,0 即為不使用。
$DNSBLWHlist
DNSBL 白名單列表。可用白名單設定強制通過檢查,請輸入 IP 位置即可,不必輸入主機名稱。
$BAD_STRING
限制出現之文字列表。檢查範圍包括名稱、 E-mail 、標題和內文。
$BAD_FILEMD5
限制上傳附加檔案之 MD5 檢查碼列表。可用來封鎖常用來亂的圖檔。

附加檔案限制

MAX_KB
附加檔案上傳容量限制KB。請注意除了這邊的設定之外,也需要注意 PHP.ini 內部 upload_max_filesizepost_max_size 的設定限制。
STORAGE_LIMIT (啟動:1 關閉:0)
是否啟動附加檔案總容量限制功能。關閉的話將不會限制總檔案大小,可以無上限的儲存 (但仍有存活週期,文章被刪除圖檔也會跟著刪除)。
STORAGE_MAX
附加檔案總容量限制上限 KB 大小。
ALLOW_UPLOAD_EXT
接受上傳之附加檔案副檔名列表。各副檔名間請用 | 分隔。

連續投稿時間限制

RENZOKU
連續投稿間隔秒數。在此秒數中間再次投稿會被暫時拒絕。
RENZOKU2
連續貼圖間隔秒數。在此秒數中間再次附圖投稿會被暫時拒絕。

預覽圖片相關限制

USE_THUMB (使用:1 不使用:0 文字:使用預覽圖生成物件)
是否使用預覽圖機能。如果不使用將不會為大圖生成預覽圖,會以「無法顯示預覽圖」(nothumb.gif) 代替顯示。

在 PIO 4th.Release.2 版之後強化了預覽圖生成物件支援,可輸入下列設定值以選取不同的生成方法。請先使用公用程式 checkenv.php 檢查是否支援。

'gd' : 使用 GD Library 生成
'imagick' : 使用 IMagick 函式庫生成
'magickwand' : 使用 MagickWand 函式庫生成
'repng2jpeg' : 使用菅処開發的 repng2jpeg 外部程式生成,可到其網站下載
'imagemagick' : 使用 ImageMagick 程式生成,需手動指定 convert 程式位置
1 : 等同 'gd' 設定值
0 : 不使用

MAX_W
討論串本文預覽圖片最大寬度。 (超過會自動原比例縮小)
MAX_H
討論串本文預覽圖片最大高度。
MAX_RW
討論串回應預覽圖片最大寬度。 (超過會自動原比例縮小)
MAX_RH
討論串回應預覽圖片最大高度。
THUMB_Q (1-100)
預覽圖片之品質。JPEG Quality %,越高品質越好但檔案也越大。
$THUMB_SETTING
PIO 6th.Release 新增。整合了 THUMB_Q 和預覽圖格式的新參數。

$THUMB_SETTING = array( // 預覽圖生成設定
'Format' => 'jpg',
'Quality' => 75
);

Format:
  為預覽圖格式,可以為 jpg, png, gif 等。視選取的預覽圖生成物件而定而有不同支援程度。比方說 ImageMagick 可以支援 bmp, psd 等等。未來也許可以支援 WebP。
Quality:
  為以前的 THUMB_Q 品質設定,JPEG 為品質 1-100,PNG 則為壓縮率 1-9。

外觀設定

$ADDITION_INFO
投稿表單下可顯示之額外文字。
$LIMIT_SENSOR
文章自動刪除機制設定。格式為 '使用機制物件名稱'=>傳入值,例如 'ByPostCountCondition'=>500 (以文章數作刪除判斷,超過500篇者刪除)。可一次使用多種條件,採聯集 (Union) 方式處理

截至 4th.Release.2 版本已經有下列幾種物件可供使用:

'ByPostCountCondition' => (最大文章數)
  以總文章篇數作為刪除判斷 (ex: 500) 即舊有 LOG_MAX 效果
'ByThreadCountCondition' => (最大討論串數)
  以總討論串數作為刪除判斷 (ex: 20)
'ByThreadAliveTimeCondition' => (討論串保留天數)
  以討論串生存時間作為刪除判斷 (ex: 7)

範例:
$LIMIT_SENSOR = array('ByPostCountCondition' => 500, 'ByThreadCountCondition' => 40);
// 限制總文章 500 筆「和 (AND)」 總討論串數 40 個,任一條件滿足便開始刪除

USE_TEMPLATE (是:1 否:0)
是否使用 PTE 樣板函式庫顯示討論串。
TEMPLATE_FILE
PTE 樣版函式庫讀取之樣板檔案位置。
PAGE_DEF
一頁顯示幾篇討論串。
ADMIN_PAGE_DEF
管理模式下,一頁顯示幾筆資料。
RE_DEF (全部隱藏:0)
討論串最多顯示之回應筆數,超過則自動隱藏。
RE_PAGE_DEF (全部顯示:0)
回應模式一頁顯示幾筆回應內容。
LOG_MAX
記錄檔保留之最大資料筆數。PIO 4th.Release.2 改以更多樣化的 $LIMIT_SENSOR 刪除機制取代
MAX_RES (關閉:0)
回應筆數超過多少則不再推文。
MAX_AGE_TIME (關閉:0)
討論串可接受推文的時間 (小時) 範圍。假如討論串存在超過此時間則之後回應皆不再推文。
RE_COL
引用標註顯示顏色。引用的方法有 > 和 > 兩種。
COMM_MAX
內文接受的最大 Byte。 (中文字為 2 Bytes)
BR_CHECK (不限:0)
內文換行行數上限。如果設成 15 則只接受 15 次換行,超過會把所有換行拿掉,讓文字變成一行。 (原 futaba 功能)
STATIC_HTML_UNTIL (全部生成:-1 僅入口頁:0 數字:生成到第幾頁止)
更新文章時自動生成的靜態網頁至第幾頁止。越後面的頁數通常越沒人看,還要花時間生成靜態頁面實在有點浪費,可以只生成熱門的前幾頁就好。
SHOW_IMGWH (是:1 否:0)
是否顯示附加檔案之原檔長寬尺寸。選否可以不必讀取每個圖檔的長寬資訊以節省系統資源。
GZIP_COMPRESS_LEVEL (關閉:0 啟動:1~9)
PHP 動態輸出頁面使用 Gzip 之壓縮層級。一般而言 3 或 4 是不錯的選擇,再下去壓縮時間增長但效果不顯著。

預設設定

DEFAULT_NOTITLE
預設文章標題,使用者未填此欄位時將使用此處設定
DEFAULT_NONAME
預設文章名稱,使用者未填此欄位時將使用此處設定
DEFAULT_NOCOMMENT
預設文章內文,使用者未填此欄位時將使用此處設定

Part 3:Anti-SPAM 防止垃圾訊息機器人發文

欄位陷阱 (Field Trap)

原本的 name, email, sub, com 等表單欄位現在全部都是欄位陷阱,只接受底下設定的這些欄位數值。請定期更改以免被廣告機器人學習,記得要符合 PHP 的變數命名原則:首字元不可為數字,不可使用非法特殊符號。建議大小寫英數字隨機搭配即可。

FT_NAME
真正的名稱欄位名稱
FT_EMAIL
真正的 E-mail 欄位名稱
FT_SUBJECT
真正的標題欄位名稱
FT_COMMENT
真正的內文欄位名稱
除非特別註明,本頁內容採用以下授權方式: Creative Commons Attribution-Noncommercial-Share Alike 2.5 License.