這個文件控制了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 允許 tags 將被識別。 ASP_tags = Off 允許ASP-style tags precision = 14 浮點類型數顯示時的有效位數 y2k_compliance = Off 是否打開 2000年適應 (可能在非Y2K適應的浏覽器中導致問題) output_buffering = Off 輸出緩存允許你甚至在輸出正文內容之後發送 header(標頭,包括cookies)行 其代價是輸出層減慢一點點速度。你可以使用輸出緩存在運行時打開輸出緩存, 或者在這裡將指示設為 On 而使得所有文件的輸出緩存打開。 output_handler = ; 你可以重定向你的腳本的所有輸出到一個函數, 那樣做可能對處理或以日志記錄它有用。 例如若你將這個output_handler 設為"ob_gzhandler", 則輸出會被透明地為支持gzip或deflate編碼的浏覽器壓縮。 設一個輸出處理器自動地打開輸出緩沖。 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 = 這條指示讓你可以為了安全的原因讓特定函數失效。 它接受一個用逗號分隔的函數名列表。 這條指示 *不受* 安全模式是否打開的影響。 語法高亮模式的色彩。 只要能被接受的東西就能工作。 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_ERRORE_ERRORE_CORE_ERROR ; 僅顯示錯誤 error_reporting = E_ALL & ~E_NOTICE ; 顯示所有的錯誤,除了提醒 display_errors = On ; 顯示出錯誤信息(作為輸出的一部分) ; 在最終發布的web站點上,強烈建議你關掉這個特性,並使用 ; 錯誤日志代替(參看下面)。 ; 在最終發布的web站點繼續讓 display_errors 有效可能 ; 暴露一些有關安全的信息,例如你的web服務上的文件路徑、 ; 你的數據庫規劃或別的信息。 display_startup_errors = Off ; 甚至當display_erroes打開了,發生於PHP的啟動的步驟中 ; 的錯誤也不會被顯示。 ; 強烈建議保持使 display_startup_errors 關閉, ; 除了在改錯過程中。 log_errors = Off ; 在日志文件裡記錄錯誤(服務器指定的日志,stderr標准錯誤輸出,或error_log(下面的)) ; 正如上面說明的那樣,強烈建議你在最終發布的web站點以日志記錄錯誤 ; 取代直接錯誤輸出。 track_errors = Off ; 保存最近一個 錯誤/警告 消息於變量 $php_errormsg (boolean) ;error_prepend_string = "" ; 於錯誤信息前輸出的字符串 ;error_append_string = "" ; 於錯誤信息後輸出的字符串 ;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為變量數