這個文件控制了PHP許多方面的觀點。為了讓PHP讀取這個文件,它必須被命名為
;
´php.ini´。PHP 將在這些地方依次查找該文件:當前工作目錄;環境變量PHPRC
;
指明的路徑;編譯時指定的路徑。
; 在windows下,編譯時的路徑是Windows安裝目錄。
;
在命令行模式下,php.ini的查找路徑可以用 -c 參數替代。
;
該文件的語法非常簡單。空白字符和用分號´;´開始的行被簡單地忽略(就象你可能
; 猜到的一樣)。
章節標題(例如 : [Foo])也被簡單地忽略,即使將來它們可能
; 有某種的意義。
;
; 指示被指定使用如下語法:
; 指示標識符 = 值
; directive = value
; 指示標識符 是 *大小寫敏感的* -
foo=bar 不同於 FOO = bar。
;
; 值可以是一個字符串,一個數字,一個 PHP 常量 (如: E_ALL or
M_PI), INI 常量中的
; 一個 (On, Off, True, False, Yes, No and None)
,或是一個表達式
; (如: E_ALL & ~E_NOTICE), 或是用引號括起來的字符串("foo").
;
;
INI 文件的表達式被限制於位運算符和括號。
; | bitwise OR
; & bitwise AND
;
~ bitwise NOT
; ! boolean NOT
;
; 布爾標志可用 1, On, True or Yes
這些值置於開的狀態。
; 它們可用 0, Off, False or No 這些值置於關的狀態。
;
;
一個空字符串可以用在等號後不寫任何東西表示,或者用 None 關鍵字:
;
; foo = ; 將foo置為空字符串
;
foo = none ; 將foo置為空字符串
; foo = "none" ;
將foo置為字符串´none´
;
;
如果你值設置中使用常量,而這些常量屬於動態調入的擴展庫(不是 PHP 的擴展,就是
; Zend
的擴展),你僅可以調入這些擴展的行*之後*使用這些常量。
;
; 所有在 php.ini-dist
文件裡設定的值與內建的默認值相同(這是說,如果 php.ini
; 沒被使用或者你刪掉了這些行,默認值與之相同)。
;;;;;;;;;;;;;;;;;;;;
; 語言選項 ;
;;;;;;;;;;;;;;;;;;;;
engine = On
; 使 PHP
scripting language engine(PHP 腳本語言引擎)在 Apache下有效。
short_open_tag =
On
; 允許 <? 標識(這種簡單表示)。否則 僅有 <?php and <script> tags 將被識別。
asp_tags
= Off
; 允許ASP-style <% %> tags
precision = 14
;
浮點類型數顯示時的有效位數
y2k_compliance = Off
; 是否打開 2000年適應
(可能在非Y2K適應的浏覽器中導致問題)
output_buffering = Off
;
輸出緩存允許你甚至在輸出正文內容之後發送 header(標頭,包括cookies)行
;
其代價是輸出層減慢一點點速度。你可以使用輸出緩存在運行時打開輸出緩存,
; 或者在這裡將指示設為 On 而使得所有文件的輸出緩存打開。
implicit_flush
= Off
; 強制flush(刷新)讓PHP 告訴輸出層在每個輸出塊之後自動刷新自身數據。
; 這等效於在每個
print() 或 echo() 調用和每個 HTML 塊後調用flush()函數。
;
打開這項設置會導致嚴重的運行時沖突,建議僅在debug過程中打開。
allow_call_time_pass_reference
= On
; 是否讓強迫函數調用時按引用傳遞參數。這一方法遭到抗議,
; 並可能在將來版本的PHP/Zend裡不再支持。
;
受到鼓勵的指定哪些參數按引用傳遞的方法是在函數聲明裡。
;
你被鼓勵嘗試關閉這一選項並確認你的腳本仍能正常工作,以保證在將來版本的語言裡
;
它們仍能工作。(你將在每次使用該特點時得到一個警告,而參數將按值而不是按引用
; 傳遞)。
; Safe Mode
安全模式
safe_mode = Off
safe_mode_exec_dir =
safe_mode_allowed_env_vars
= PHP_
; ?Setting certain environment variables
; ?may be a
potential security breach.
; 該指示包含用逗號分隔的前綴列表。安全模式中,用戶僅可以替換
;
以在此列出的前綴開頭的環境變量的值。
; 默認地,用戶將僅能 設定以PHP_開頭的環境變量,(如: PHP_FOO=BAR)。
;
注意: 如果這一指示為空,PHP 將讓用戶更改任意環境變量!
safe_mode_protected_env_vars =
LD_LIBRARY_PATH
; 這條指示包含一個用逗號分隔的環境變量列表,那是最終用戶將不能用putenv () 更改的。
;
這些變量甚至在safe_mode_allowed_env_vars 設置為允許的情況下得到保護。
disable_functions
=
; 這條指示讓你可以為了安全的原因讓特定函數失效。
; 它接受一個用逗號分隔的函數名列表。
; 這條指示 *不受*
安全模式是否打開的影響。
; 語法高亮模式的色彩。
; 只要能被<font
color=???>接受的東西就能工作。
highlight.string = #DD0000
highlight.comment
= #FF8000
highlight.keyword = #007700
highlight.bg = #FFFFFF
highlight.default
= #0000BB
highlight.html = #000000
; Misc 雜項
expose_php
= Off
; 決定 PHP 是否標示它裝在服務器上的事實(例如:加在它 —PHP—給Web服務
; 發送的信號上)。
;
(我個人的意見,在出現什麼power-by的header的時候,把這關掉。)
; 它不會有安全上的威脅,
但它使檢查你的服務器上是否安裝了PHP成為了可能。
;;;;;;;;;;;;;;;;;;;
; Resource
Limits ;
;;;;;;;;;;;;;;;;;;;
max_execution_time = 30 ;
每個腳本的最大執行時間, 按秒計
memory_limit = 8388608 ; 一個腳本最大可使用的內存總量 (這裡是8MB)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Error handling and logging ;
; 出錯控制和登記 ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; 錯誤報告是按位的。或者將數字加起來得到想要的錯誤報告等級。
; E_ALL - 所有的錯誤和警告
;
E_ERROR - 致命性運行時錯
; E_WARNING - 運行時警告(非致命性錯)
; E_PARSE - 編譯時解析錯誤
; E_NOTICE - 運行時提醒(這些經常是是你的代碼的bug引起的,
;也可能是有意的行為造成的。(如:基於未初始化的變
量自動初始化為一個
;空字符串的事實而使用一個未初始化的變量)
; E_CORE_ERROR -
發生於PHP啟動時初始化過程中的致命錯誤
; E_CORE_WARNING - 發生於PHP啟動時初始化過程中的警告(非致命性錯)
;
E_COMPILE_ERROR - 編譯時致命性錯
; E_COMPILE_WARNING - 編譯時警告(非致命性錯)
;
E_USER_ERROR - 用戶產生的出錯消息
; E_USER_WARNING - 用戶產生的警告消息
;
E_USER_NOTICE - 用戶產生的提醒消息
; 例子:
; error_reporting = E_ALL &
~E_NOTICE ; 顯示所有的錯誤,除了提醒
; error_reporting =
E_COMPILE_ERROR|E_ERROR|E_CORE_ERROR ; 僅顯示錯誤
error_reporting = E_ALL
& ~E_NOTICE ; 顯示所有的錯誤,除了提醒
display_errors = On ;
顯示出錯誤信息(作為輸出的一部分)
; 在最終發布的web站點上,強烈建議你關掉這個特性,並使用
; 錯誤日志代替(參看下面)。
; 在最終發布的web站點繼續讓 display_errors 有效可能
;
暴露一些有關安全的信息,例如你的web服務上的文件路徑、
; 你的數據庫規劃或別的信息。
log_errors =
Off ; 在日志文件裡記錄錯誤(服務器指定的日志,stderr標准錯誤輸出,或error_log(下面的))
;
正如上面說明的那樣,強烈建議你在最終發布的web站點以日志記錄錯誤
; 取代直接錯誤輸出。
track_errors =
Off ; 保存最近一個 錯誤/警告 消息於變量 $php_errormsg (boolean)
;error_prepend_string
= "<font color=ff0000>" ; 於錯誤信息前輸出的字符串
;error_append_string =
"</font>" ; 於錯誤信息後輸出的字符串
;error_log = filename ; 記錄錯誤日志於指定文件
;error_log
= syslog ; 記錄錯誤日志於系統日志 syslog (NT 下的事件日志, Windows 95下無效)
warn_plus_overloading
= Off ; 當將‘ ’用於字符串時警告
;;;;;;;;;;;;;;;;;
; Data Handling
;
;;;;;;;;;;;;;;;;;
variables_order = "EGPCS" ; 這條指示描述了PHP 記錄
;
GET, POST, Cookie, Environment and Built-in 這些變量的順序。
; (以 G, P, C, E
& S 代表,通常以 EGPCS 或 GPC 的方式引用)。
; 按從左到右記錄,新值取代舊值。
register_globals
= On ; 是否將這些 EGPCS 變量注冊為全局變量。
; 若你不想讓用戶數據不在全局范圍內混亂的話,你可能想關閉它。
;
這和 track_vars 連起來用更有意義 — 這樣你可以通過
; $HTTP_*_VARS[] 數組訪問所有的GPC變量。
register_argc_argv
= On ; 這條指示告訴 PHP 是否聲明 argv和argc 變量
; (注:這裡argv為數組,argc為變量數)
;
(其中包含用GET方法傳來的數據)。
; 若你不想用這些變量,你應當關掉它以提高性能。
track_vars = On ;
使$HTTP_*_VARS[]數組有效,這裡*在使用時用
; ENV, POST, GET, COOKIE or SERVER替換
gpc_order
= "GPC" ; 這條指示被人反對。用 variables_order 代替。
; Magic quotes
magic_quotes_gpc
= On ; 在輸入的GET/POST/Cookie數據裡使用魔術引用
; (原文就這樣,呵呵,所謂magic quotes
應該是指用轉義符加在引用性的控制字符上,如 ´....)
magic_quotes_runtime