PHP.INI 詳解

今天遇到一個問題是用PHP從sql server 裡讀資料，一些資料莫名其妙的截斷的，而且截斷的長短不一，剛開始懷疑是程式問題，找了好久沒有找出原因，後來才知道是php的配置問題，是mssql.textsize，mssql.textlimit設定小了。回來特地在網上找相關的配置資料，以下是一篇對PHP.ini配置比較詳細的說明文檔。</p><p>php.ini 中的 php-5.2.0 配置指令詳解<br />;;;;;;;;;;;;;;;;<br />;; 作者：金步國<br />;; 日期：2006.11.12<br />;;;;;;;;;;;;;;;;<br />;; 著作權聲明 ;;<br />;;;;;;;;;;;;;;;;;;;;;;;;;<br />;; BUG報告，切磋與探討 ;;<br />;;;;;;;;;;;;;;;;;;;;;;;;;<br />; 由於作者水平有限，因此不能保證作品內容準確無誤，請在閱讀中自行鑒別。<br />; 如果你發現了作品中的錯誤，請您來信指出，哪怕是錯別字也好，任何提高作品品質的建議我都將虛心接納。<br />; 如果你願意就作品中的相關內容與我進行進一步切磋與探討，也歡迎你與我聯絡。<br />; 連絡方式：Email: csfrank@citiz.net ； QQ: 70171448 ； MSN: csfrank122@hotmail.com<br />;<br />;;;;;;;;;;;;;;<br />;; 簡介 ;;<br />;;;;;;;;;;;;;;<br />; 本文並非是對英文版 php.ini 的簡單翻譯，而是參考了眾多資料以後，結合自己的理解，<br />; 在原有 php.ini 基礎上增加了一些實用模組的配置說明，同時對檔案內容的安排進行了調整。<br />; 由於作者不喜歡 no-free 的玩意兒，所以刪除了除 MySQL 和 PostgreSQL 以外的其他資料庫模組配置選項。</p><p>;;;;;;;;;;;;;;;;;<br />;; 關於php.ini ;;<br />;;;;;;;;;;;;;;;;;<br />; 這個檔案必須命名為'php.ini'並放置在httpd.conf中的PHPIniDir指令指定的目錄中。<br />; 最新版本的php.ini可以在下面兩個位置查看：<br />; http://cvs.php.net/viewvc.cgi/php-src/php.ini-recommended?view=co<br />; http://cvs.php.net/viewvc.cgi/php-src/php.ini-dist?view=co</p><p>;;;;;;;;;;;;<br />;; 文法 ;;<br />;;;;;;;;;;;;<br />; 該檔案的文法非常簡單。空白字元和以分號開始的行被簡單地忽略。<br />; 章區段標頭(例如: [php])也被簡單地忽略，即使將來它們可能有某種意義。<br />;<br />; 設定指令的格式如下：<br />; directive = value<br />; 指令名(directive)是大小寫敏感的！所以"foo=bar"不同於"FOO=bar"。<br />; 值(value)可以是：<br />; 1. 用引號界定的字串(如："foo")<br />; 2. 一個數字(整數或浮點數，如：0, 1, 34, -1, 33.55)<br />; 3. 一個PHP常量(如：E_ALL, M_PI)<br />; 4. 一個INI常量(On, Off, none)<br />; 5. 一個運算式(如：E_ALL & ~E_NOTICE)<br />;<br />; INI檔案中的運算式僅使用：位元運算符、邏輯非、圓括弧：<br />; | 位或<br />; & 位與<br />; ~ 位非<br />; ! 邏輯非<br />;<br />; 布爾標誌用 On 表示開啟，用 Off 表示關閉。<br />;<br />; 一個Null 字元串可以用在等號後不寫任何東西表示，或者用 none 關鍵字：<br />; foo = ; 將foo設為空白字串<br />; foo = none ; 將foo設為空白字串<br />; foo = "none" ; 將foo設為字串'none'<br />;<br />; 如果你在指令值中使用動態擴充(PHP擴充或Zend擴充)中的常量，<br />; 那麼你只能在載入這些動態擴充的指令行之後使用這些常量。</p><p>;;;;;;;;;;;;;;;;;;<br />;; httpd.conf ;;<br />;;;;;;;;;;;;;;;;;;<br />; 還可以在httpd.conf中覆蓋php.ini的值，以進行更靈活的配置：<br />; php_value name value ;設定非bool型的指令，將value設為none則清除先前的設定<br />; php_flag name on|off ;僅用於設定bool型的指令<br />;<br />; PHP常量(如E_ALL)僅能在php.ini中使用，在httpd.conf中必須使用相應的掩碼值。<br />; 帶"SYS"標誌的指令只能在httpd.conf中的全域配置部分使用，<br />; 帶"ini"標誌的指令不能在httpd.conf中使用，它們僅能用於php.ini中。</p><p>;==========================================================================================<br />;;=====================================配置指令詳解========================================<br />;==========================================================================================<br />; 以下每個指令的設定值都與 PHP-5.2.0 內建的預設值相同。<br />; 也就是說，如果'php.ini'不存在，或者你刪掉了某些行，預設值與之相同。</p><p>;;;;;;;;;;;;;;<br />;; Apache ;;<br />;;;;;;;;;;;;;;<br />[Apache]<br />; 僅在將PHP作為Apache模組時才有效。</p><p>engine = On<br />; 是否啟用PHP解析引擎。<br />; 可以在httpd.conf中基於目錄或者虛擬機器主機來開啟或者關閉PHP解析引擎。</p><p>last_modified = Off<br />; 是否在Last-Modified應答頭中放置該PHP指令碼的最後修改時間。</p><p>xbithack = Off<br />; 是否不管檔案結尾是什麼，都作為PHP可執行位組來解析。</p><p>child_terminate = Off<br />; PHP指令碼在請求結束後是否允許使用apache_child_terminate()函數終止子進程。<br />; 該指令僅在UNIX平台上將PHP安裝為Apache1.3的模組時可用。其他情況下皆不存在。</p><p>;;;;;;;;;;;;;;;<br />;; PHP核心 ;;<br />;;;;;;;;;;;;;;;</p><p>[PHP-Core-DateTime]<br />; 前四個配置選項目前僅用於date_sunrise()和date_sunset()函數。</p><p>date.default_latitude = 31.7667<br />; 預設緯度</p><p>date.default_longitude = 35.2333<br />; 預設經度</p><p>date.sunrise_zenith = 90.583333<br />; 預設日出天頂</p><p>date.sunset_zenith = 90.583333<br />; 預設日落天頂</p><p>date.timezone =<br />; 未設定TZ環境變數時用於所有日期和時間函數的預設時區。<br />; 中國大陸應當使用"PRC"<br />; 應用時區的優先順序為：<br />; 1. 用date_default_timezone_set()函數設定的時區(如果設定了的話)<br />; 2. TZ 環境變數(如果非空的話)<br />; 3. 該指令的值(如果設定了的話)<br />; 4. PHP自己推測(如果作業系統支援)<br />; 5. 如果以上都不成功，則使用 UTC</p><p>[PHP-Core-Assert]</p><p>assert.active = On<br />; 是否啟用assert()斷言評估</p><p>assert.bail = Off<br />; 是否在發生失敗斷言時中止指令碼的執行</p><p>assert.callback =<br />; 發生失敗斷言時執行的回呼函數</p><p>assert.quiet_eval = Off<br />; 是否使用安靜評估(不顯示任何錯誤資訊，相當於error_reporting=0)。<br />; 若關閉則在評估斷言運算式的時候使用當前的error_reporting指令值。</p><p>assert.warning = On<br />; 是否對每個失敗斷言都發出警告</p><p>[PHP-Core-SafeMode]<br />; 安全模式是為瞭解決共用伺服器的安全問題而設立的。<br />; 但試圖在PHP層解決這個問題在結構上是不合理的，<br />; 正確的做法應當是修改web伺服器層和作業系統層。<br />; 因此在PHP6中廢除了安全模式，並打算使用open_basedir指令取代之。</p><p>safe_mode = Off<br />;SYS<br />; 是否啟用安全模式。<br />; 開啟時，PHP將檢查當前指令碼的擁有者是否和被操作的檔案的擁有者相同，<br />; 相同則允許操作，不同則拒絕操作。</p><p>safe_mode_gid = Off<br />;SYS<br />; 在安全模式下，預設在訪問檔案時會做UID比較檢查。<br />; 但有些情況下嚴格的UID檢查反而是不適合的，寬鬆的GID檢查已經足夠。<br />; 如果你想將其放寬到僅做GID比較，可以開啟這個參數。</p><p>safe_mode_allowed_env_vars = "PHP_"<br />;SYS<br />; 在安全模式下，使用者僅可以更改的環境變數的首碼列表(逗號分隔)。<br />; 允許使用者佈建某些環境變數，可能會導致潛在的安全性漏洞。<br />; 注意: 如果這一參數值為空白，PHP將允許使用者更改任意環境變數！</p><p>safe_mode_protected_env_vars = "LD_LIBRARY_PATH"<br />;SYS<br />; 在安全模式下，使用者不能更改的環境變數列表(逗號分隔)。<br />; 這些變數即使在safe_mode_allowed_env_vars指令設定為允許的情況下也會得到保護。</p><p>safe_mode_exec_dir = "/usr/local/php/bin"<br />;SYS<br />; 在安全模式下，只有該目錄下的可執行程式才允許被執行系統程式的函數執行。<br />; 這些函數是：system, escapeshellarg, escapeshellcmd, exec, passthru,<br />; proc_close, proc_get_status, proc_nice, proc_open, proc_terminate, shell_exec</p><p>safe_mode_include_dir =<br />;SYS<br />; 在安全模式下，該組目錄和其子目錄下的檔案被包含時，將跳過UID/GID檢查。<br />; 換句話說，如果此處的值為空白，任何UID/GID不符合的檔案都不允許被包含。<br />; 這裡設定的目錄必須已經存在於include_path指令中或者用完整路徑來包含。<br />; 多個目錄之間用冒號(Win下為分號)隔開。<br />; 指定的限制實際上是一個首碼，而非一個目錄名，<br />; 也就是說"/dir/incl"將允許訪問"/dir/include"和"/dir/incls"<br />; 如果您希望將存取控制在一個指定的目錄，那麼請在結尾加上斜線。</p><p>sql.safe_mode = Off<br />;SYS<br />; 是否使用SQL安全模式。<br />; 如果開啟，指定預設值的資料庫連接函數將會使用這些預設值代替支援的參數。<br />; 對於每個不同資料庫的串連函數，其預設值請參考相應的手冊頁面。</p><p>[PHP-Core-Safe]</p><p>allow_url_fopen = On<br />;ini<br />; 是否允許開啟遠程檔案</p><p>allow_url_include = Off<br />;SYS<br />; 是否允許include/require遠程檔案。</p><p>disable_classes =<br />;ini<br />; 該指令接受一個用逗號分隔的類名列表，以禁用特定的類。</p><p>disable_functions =<br />;ini<br />; 該指令接受一個用逗號分隔的函數名列表，以禁用特定的函數。</p><p>enable_dl = On<br />;SYS<br />; 是否允許使用dl()函數。dl()函數僅在將PHP作為apache模組安裝時才有效。<br />; 禁用dl()函數主要是出於安全考慮，因為它可以繞過open_basedir指令的限制。<br />; 在安全模式下始終禁用dl()函數，而不管此處如何設定。</p><p>expose_php = On<br />;ini<br />; 是否暴露PHP被安裝在伺服器上的事實(在http頭中加上其簽名)。<br />; 它不會有安全上的直接威脅，但它使得用戶端知道伺服器上安裝了PHP。</p><p>open_basedir =<br />;SYS<br />; 將PHP允許操作的所有檔案(包括檔案自身)都限制在此組目錄列表下。<br />; 當一個指令碼試圖開啟一個指定分類樹之外的檔案時，將遭到拒絕。<br />; 所有的符號串連都會被解析，所以不可能通過符號串連來避開此限制。<br />; 特殊值'.'指定了存放該指令碼的目錄將被當做基準目錄。<br />; 但這有些危險，因為指令碼的工作目錄可以輕易被chdir()改變。<br />; 對於共用伺服器，在httpd.conf中靈活設定該指令將變得非常有用。<br />; 在Windows中用分號分隔目錄，UNIX系統中用冒號分隔目錄。<br />; 作為Apache模組時，父目錄中的open_basedir路徑將自動被繼承。<br />; 指定的限制實際上是一個首碼，而非一個目錄名，<br />; 也就是說"/dir/incl"將允許訪問"/dir/include"和"/dir/incls"，<br />; 如果您希望將存取控制在一個指定的目錄，那麼請在結尾加上一個斜線。<br />; 預設是允許開啟所有檔案。</p><p>[PHP-Core-Error]</p><p>error_reporting = E_ALL & ~E_NOTICE<br />; 錯誤報表層級是位欄位的疊加，推薦使用 E_ALL | E_STRICT<br />; 1 E_ERROR 致命的執行階段錯誤<br />; 2 E_WARNING 運行時警告(非致命性錯誤)<br />; 4 E_PARSE 編譯時間解析錯誤<br />; 8 E_NOTICE 運行時提醒(經常是bug，也可能是有意的)<br />; 16 E_CORE_ERROR PHP啟動時初始化過程中的致命錯誤<br />; 32 E_CORE_WARNING PHP啟動時初始化過程中的警告(非致命性錯)<br />; 64 E_COMPILE_ERROR 編譯時間致命性錯 </p><p>; 128 E_COMPILE_WARNING 編譯時間警告(非致命性錯)<br />; 256 E_USER_ERROR 使用者自訂的致命錯誤<br />; 512 E_USER_WARNING 使用者自訂的警告(非致命性錯誤)<br />; 1024 E_USER_NOTICE 使用者自訂的提醒(經常是bug，也可能是有意的)<br />; 2048 E_STRICT 編碼通訊協定化警告(建議如何修改以向前相容)<br />; 4096 E_RECOVERABLE_ERROR 接近致命的執行階段錯誤，若未被捕獲則視同E_ERROR<br />; 6143 E_ALL 除E_STRICT外的所有錯誤(PHP6中為8191,即包含所有) </p><p>track_errors = Off<br />; 是否在變數$php_errormsg中儲存最近一個錯誤或警告訊息。</p><p>display_errors = On<br />; 是否將錯誤資訊作為輸出的一部分顯示。<br />; 在最終發布的web網站上，強烈建議你關掉這個特性，並使用錯誤記錄檔代替(參看下面)。<br />; 在最終發布的web網站開啟這個特性可能暴露一些安全資訊，<br />; 例如你的web服務上的檔案路徑、資料庫規劃或別的資訊。</p><p>display_startup_errors = Off<br />; 是否顯示PHP啟動時的錯誤。<br />; 即使display_errors指令被開啟，關閉此參數也將不顯示PHP啟動時的錯誤。<br />; 建議你關掉這個特性，除非你必須要用於調試中。</p><p>report_memleaks = On<br />; 是否報告記憶體流失。這個參數只在以調試方式編譯的PHP中起作用，<br />; 並且必須在error_reporting指令中包含 E_WARNING</p><p>report_zend_debug = On<br />; 尚無說明文檔</p><p>html_errors = On<br />; 是否在出錯資訊中使用HTML標記。<br />; 注意: 不要在發布的網站上使用這個特性！</p><p>docref_root = ;"http://localhost/phpmanual/"<br />docref_ext = ;".html"<br />; 如果開啟了html_errors指令，PHP將會在出錯資訊上顯示超串連，<br />; 直接連結到一個說明這個錯誤或者導致這個錯誤的函數的頁面。<br />; 你可以從http://www.php.net/docs.php下載php手冊，<br />; 並將docref_root指令指向你本地的手冊所在的URL目錄。<br />; 你還必須設定docref_ext指令來指定檔案的副檔名(必須含有'.')。<br />; 注意: 不要在發布的網站上使用這個特性。</p><p>error_prepend_string = ;"<font color=#f00>"<br />; 用於錯誤資訊前輸出的字串<br />error_append_string = ;"</font>"<br />; 用於錯誤資訊後輸出的字串</p><p>xmlrpc_errors = Off<br />xmlrpc_error_number = 0<br />; 尚無文檔</p><p>[PHP-Core-Logging]</p><p>define_syslog_variables = Off<br />; 是否定義各種系統日誌變數，如：$LOG_PID, $LOG_CRON 等等。<br />; 關掉它以提高效率的好主意。<br />; 你可以在運行時調用define_syslog_variables()函數來定義這些變數。</p><p>error_log =<br />; 將錯誤記錄檔記錄到哪個檔案中。該檔案必須對Web伺服器使用者可寫。<br />; syslog 表示記錄到系統日誌中(NT下的事件記錄, Unix下的syslog(3))<br />; 如果此處未設定任何值，則錯誤將被記錄到Web伺服器的錯誤記錄檔中。</p><p>log_errors = Off<br />; 是否在記錄檔裡記錄錯誤，具體在哪裡記錄取決於error_log指令。<br />; 強烈建議你在最終發布的web網站時使用日誌記錄錯誤而不是直接輸出，<br />; 這樣可以讓你既知道那裡出了問題，又不會暴露敏感資訊。</p><p>log_errors_max_len = 1024<br />; 設定錯誤記錄檔中附加的與錯誤資訊相關聯的錯誤源的最大長度。<br />; 這裡設定的值對顯示的和記錄的錯誤以及$php_errormsg都有效。<br />; 設為 0 可以允許無限長度。</p><p>ignore_repeated_errors = Off<br />; 記錄錯誤記錄檔時是否忽略重複的錯誤資訊。<br />; 錯誤資訊必須出現在同一檔案的同一行才被被視為重複。</p><p>ignore_repeated_source = Off<br />; 是否在忽略重複的錯誤資訊時忽略重複的錯誤源。</p><p>[PHP-Core-Mail]<br />; 要使郵件函數可用，PHP必須在編譯時間能夠訪問sendmail程式。<br />; 如果使用其它的郵件程式，如qmail或postfix，確保使用了相應的sendmail封裝。<br />; PHP首先會在系統的PATH環境變數中搜尋sendmail，接著按以下順序搜尋：<br />; /usr/bin:/usr/sbin:/usr/etc:/etc:/usr/ucblib:/usr/lib<br />; 強烈建議在PATH中能夠找到sendmail。<br />; 另外，編譯PHP的使用者必須能夠訪問sendmail程式。</p><p>SMTP = "localhost"<br />; mail()函數中用來發送郵件的SMTP伺服器的主機名稱或者IP地址。僅用於win32。</p><p>smtp_port = 25<br />; SMTP伺服器的連接埠號碼。僅用於win32。</p><p>sendmail_from =<br />; 發送郵件時使用的"From:"頭中的郵件地址。僅用於win32<br />; 該選項還同時設定了"Return-Path:"頭。</p><p>sendmail_path = "-t -i"<br />;SYS<br />; 僅用於unix，也可支援參數(預設的是'sendmail -t -i')<br />; sendmail程式的路徑，通常為"/usr/sbin/sendmail或/usr/lib/sendmail"。<br />; configure指令碼會嘗試找到該程式並設定為預設值，但是如果失敗的話，可以在這裡設定。<br />; 不使用sendmail的系統應將此指令設定為sendmail替代程式(如果有的話)。<br />; 例如，Qmail使用者通常可以設為"/var/qmail/bin/sendmail"或"/var/qmail/bin/qmail-inject"。<br />; qmail-inject 不需要任何選項就能正確處理郵件。</p><p>mail.force_extra_parameters =<br />; 作為額外的參數傳遞給sendmail庫的強制指定的參數附加值。<br />; 這些參數總是會替換掉mail()的第5個參數，即使在安全模式下也是如此。</p><p>[PHP-Core-ResourceLimit]</p><p>default_socket_timeout = 60<br />; 預設socket逾時(秒)</p><p>max_execution_time = 30<br />; 每個指令碼最大允許執行時間(秒)，0 表示沒有限制。 </p><p>; 這個參數有助於阻止劣質指令碼無休止的佔用伺服器資源。<br />; 該指令僅影響指令碼本身的已耗用時間，任何其它花費在指令碼運行之外的時間，<br />; 如用system()/sleep()函數的使用、資料庫查詢、檔案上傳等，都不包括在內。<br />; 在安全模式下，你不能用ini_set()在運行時改變這個設定。 </p><p>memory_limit = 16M<br />; 一個指令碼所能夠申請到的最大記憶體位元組數(可以使用K和M作為單位)。<br />; 這有助於防止劣質指令碼消耗完伺服器上的所有記憶體。<br />; 要能夠使用該指令必須在編譯時間使用"--enable-memory-limit"配置選項。<br />; 如果要取消記憶體限制，則必須將其設為 -1 。<br />; 設定了該指令後，memory_get_usage()函數將變為可用。</p><p>max_input_time = -1<br />; 每個指令碼解析輸入資料(POST, GET, upload)的最大允許時間(秒)。<br />; -1 表示不限制。</p><p>post_max_size = 8M<br />; 允許的POST資料最大位元組長度。此設定也影響到檔案上傳。<br />; 如果POST資料超出限制，那麼$_POST和$_FILES將會為空白。<br />; 要上傳大檔案，該值必須大於upload_max_filesize指令的值。<br />; 如果啟用了記憶體限制，那麼該值應當小於memory_limit指令的值。</p><p>realpath_cache_size = 16K<br />;SYS<br />; 指定PHP使用的realpath(正常化的絕對路徑名)緩衝區大小。<br />; 在PHP開啟大量檔案的系統上應當增大該值以提高效能。</p><p>realpath_cache_ttl = 120<br />;SYS<br />; realpath緩衝區中資訊的有效期間(秒)。<br />; 對檔案很少變動的系統，可以增大該值以提高效能。<br />[PHP-Core-FileUpLoad]</p><p>file_uploads = On<br />;SYS<br />; 是否允許HTTP檔案上傳。<br />; 參見upload_max_filesize, upload_tmp_dir, post_max_size指令</p><p>upload_max_filesize = 2M<br />; 允許上傳的檔案的最大尺寸。</p><p>upload_tmp_dir =<br />;SYS<br />; 檔案上傳時存放檔案的臨時目錄(必須是PHP進程使用者可寫的目錄)。<br />; 如果未指定則PHP使用系統預設的臨時目錄。</p><p>[PHP-Core-MagicQuotes]<br />; PHP6將取消魔術引號，相當於下列指令全部為 Off</p><p>magic_quotes_gpc = On<br />; 是否對輸入的GET/POST/Cookie資料使用自動字串轉義( ' " NULL )。<br />; 這裡的設定將自動影響 $_GEST $_POST $_COOKIE 數組的值。<br />; 若將本指令與magic_quotes_sybase指令同時開啟，則僅將單引號(')轉義為('')，<br />; 其它特殊字元將不被轉義，即( " NULL )將保持原樣！！<br />; 建議關閉此特性，並使用自訂的過濾函數。</p><p>magic_quotes_runtime = Off<br />; 是否對運行時從外部資源產生的資料使用自動字串轉義( ' " NULL )。<br />; 若開啟本指令，則大多數函數從外部資源(資料庫,文字檔等)返回資料都將被轉義。<br />; 例如：用SQL查詢得到的資料，用exec()函數得到的資料，等等<br />; 若將本指令與magic_quotes_sybase指令同時開啟，則僅將單引號(')轉義為('')，<br />; 其它特殊字元將不被轉義，即( " NULL )將保持原樣！！<br />; 建議關閉此特性，並視具體情況使用自訂的過濾函數。</p><p>magic_quotes_sybase = Off<br />; 是否採用Sybase形式的自動字串轉義(用 '' 表示 ')</p><p>[PHP-Core-HighLight]</p><p>highlight.bg = "#FFFFFF"<br />highlight.comment = "#FF8000"<br />highlight.default = "#0000BB"<br />highlight.html = "#000000"<br />highlight.keyword = "#007700"<br />highlight.string = "#DD0000"<br />; 文法高亮模式的色彩(通常用於顯示 .phps 檔案)。<br />; 只要能被<font color=xxx>接受的東西就能正常工作。</p><p>[PHP-Core-Langue]</p><p>short_open_tag = On<br />; 是否允許使用"<? ?>"短標識。否則必須使用"<?php ?>"長標識。<br />; 除非你的php程式僅在受控環境下運行，且只供自己使用，否則請不要使用短標記。<br />; 如果要和XML結合使用PHP，可以選擇關閉此選項以方便直接嵌入"<?xml ... ?>"，<br />; 不然你必須用PHP來輸出：<? echo '<?xml version="1.0"'; ?><br />; 本指令也會影響到縮寫形式"<?="，它和"<? echo"等價，要使用它也必須開啟短標記。</p><p>asp_tags = Off<br />; 是否允許ASP風格的標記"<% %>"，這也會影響到縮寫形式"