| 說(shuō)明 | 設定日志的文件名和格式 |
|---|---|
| 語(yǔ)法 | CustomLog file|pipe format|nickname [env=[!]environment-variable] |
| 作用域 | server config, virtual host |
| 狀態(tài) | 基本(B) |
| 模塊 | mod_log_config |
CustomLog指令用來(lái)對服務(wù)器的請求進(jìn)行日志記錄??梢灾付ㄈ罩镜母袷?,也可以使用環(huán)境變量根據請求的特征來(lái)自由地組織日志。
第一個(gè)參數指定了日志記錄的位置,可以使用以下兩種方式來(lái)設定:
當在非UNIX平臺上輸入文件路徑的時(shí)候,要特別注意即使平臺本身是使用反斜杠(\)來(lái)分隔路徑的,在這里也只能使用正斜杠(/)。通常在配置文件里只用正斜杠(/)來(lái)分隔路徑總是不會(huì )錯的。
第二個(gè)參數指定了寫(xiě)入日志文件的內容。它既可以是由前面的LogFormat指令定義的nickname ,也可以是直接按日志格式一節所描述的規則定義的format字符串。
例如:以下兩組指令的結果是完全一樣的:
# 使用nickname
LogFormat "%h %l %u %t \"%r\" %>s %b" common
CustomLog logs/access_log common
# 明確使用格式格式字符串
CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b"
第三個(gè)參數是可選的,它根據服務(wù)器上特定的環(huán)境變量是否被設置來(lái)決定是否對某一特定的請求進(jìn)行日志記錄。如果這個(gè)特定的 可以使用 或者為了復制舊有的RefererIgnore指令的行為,你可以使用下面的指令:mod_setenvif和/或mod_rewrite模塊來(lái)為每個(gè)請求設置環(huán)境變量。例如:如果你想在服務(wù)器上將所有對GIF圖片的請求記錄在不同于主日志文件的另一個(gè)日志文件中,你可以使用下面的指令:SetEnvIf Request_URI \.gif$ gif-image
CustomLog gif-requests.log common env=gif-image
CustomLog nongif-requests.log common env=!gif-imageSetEnvIf Referer example\.com localreferer
CustomLog referer.log referer env=!localreferer
聯(lián)系客服