## **推薦.env( 環境變量定義) 配置文件** >[danger] 1.其中兩項配置`app_debug`、`config_ext`只在.env生效 參見開啟調試模式及代碼跟蹤器 > 2.除了一級配置外，配置參數名嚴格區分大小寫，建議是使用小寫定義配置參數的規范。 > 3.在.env中的**值**推薦用引號,否則坑死都不知道怎么死的 > 默認安裝后的根目錄有一個`.example.env`環境變量示例文件，你可以直接改成`.env`文件后進行修改。 > 如果你的部署環境單獨配置了環境變量（ 環境變量的前綴使用`PHP_`），那么請刪除`.env`配置文件，避免沖突。 > >[info]### 配置定義格式： ``` APP_DEBUG = true ;數據庫配置項 [DATABASE] TYPE = mysql HOSTNAME = 127.0.0.1 DATABASE = test USERNAME = username PASSWORD = password ;數組形式 ARR[]=1 ARR[]=2 ;數組形式 [TEST] PATHINFO_PATH[] = ORIG_PATH_INFO PATHINFO_PATH[] = REDIRECT_PATH_INFO PATHINFO_PATH[] = REDIRECT_URL ``` ### **env( 環境變量定義)的獲取** >[info] ### `\think\facade\Env::get('ARR');`結果： ~~~ array ( 0 => '1', 1 => '2', ) ~~~ >[info] ### `\think\facade\Env::get('test.pathinfo_path')`結果： ``` array ( 0 => 'ORIG_PATH_INFO', 1 => 'REDIRECT_PATH_INFO', 2 => 'REDIRECT_URL', ) ``` >[info]### `\think\facade\Env::get();`結果： ``` array ( 'APP_DEBUG' => '1', 'DATABASE_TYPE' => 'mysql', 'DATABASE_HOSTNAME' => '127.0.0.1', 'DATABASE_DATABASE' => 'test', 'DATABASE_USERNAME' => 'username', 'DATABASE_PASSWORD' => 'password', 'TEST_PATHINFO_PATH' => array ( 0 => 'ORIG_PATH_INFO', 1 => 'REDIRECT_PATH_INFO', 2 => 'REDIRECT_URL', ), ) ``` 可以支持默認值，例如： ~~~ // 獲取環境變量 如果不存在則使用默認值root Env::get('database.username', 'root'); ~~~ 可以直接在配置文件中使用環境變量進行本地環境和服務器的自動配置，例如： ~~~ return [ 'hostname' => Env::get('hostname','127.0.0.1'), ]; ~~~ >[warning]## **例子:配置數據庫**： ``` APP_DEBUG = true ;開啟跟蹤器 APP_TRACE = true [APP] DEFAULT_TIMEZONE = Asia/Shanghai default_app = admin ;數據庫配置項 [DATABASE] TYPE = mysql HOSTNAME = 127.0.0.1 DATABASE = test USERNAME = username PASSWORD = password HOSTPORT = 3306 CHARSET = utf8 DEBUG = true ;數據庫表前綴 prefix = [LANG] default_lang = zh-cn ``` ##### 全局配置 config/database.php ``` <?php use think\facade\Env; return [ // 默認使用的數據庫連接配置 'default' => Env::get('database.driver', 'mysql'), // 自定義時間查詢規則 'time_query_rule' => [], // 自動寫入時間戳字段 // true為自動識別類型 false關閉 // 字符串則明確指定時間字段類型 支持 int timestamp datetime date 'auto_timestamp' => true, // 時間字段取出后的默認時間格式 'datetime_format' => 'Y-m-d H:i:s', // 數據庫連接配置信息 'connections' => [ 'mysql' => [ // 數據庫類型 'type' => Env::get('database.type', 'mysql'), // 服務器地址 'hostname' => Env::get('database.hostname', '127.0.0.1'), // 數據庫名 'database' => Env::get('database.database', ''), // 用戶名 'username' => Env::get('database.username', 'root'), // 密碼 'password' => Env::get('database.password', ''), // 端口 'hostport' => Env::get('database.hostport', '3306'), // 數據庫連接參數 'params' => [], // 數據庫編碼默認采用utf8 'charset' => Env::get('database.charset', 'utf8'), // 數據庫表前綴 'prefix' => Env::get('database.prefix', ''), // 數據庫調試模式 'debug' => Env::get('database.debug', true), // 數據庫部署方式:0 集中式(單一服務器),1 分布式(主從服務器) 'deploy' => 0, // 數據庫讀寫是否分離 主從式有效 'rw_separate' => false, // 讀寫分離后 主服務器數量 'master_num' => 1, // 指定從服務器序號 'slave_no' => '', // 是否嚴格檢查字段是否存在 'fields_strict' => true, // 是否需要斷線重連 'break_reconnect' => false, // 字段緩存路徑 'schema_cache_path' => app()->getRuntimePath() . 'schema' . DIRECTORY_SEPARATOR, ], // 更多的數據庫配置信息 ], ]; ``` ### **多環境變量配置支持** `V6.0.8+`版本開始，可以支持定義多個環境變量配置文件，配置文件命名規范為 ~~~ .env.example .env.testing .env.develop ~~~ 然后，需要在入口文件中指定部署使用的環境變量名稱： ~~~ // 執行HTTP應用并響應 將$http = (new App())->http;改為： $http = (new App())->setEnvName('develop')->http; $response = $http->run(); $response->send(); $http->end($response); ~~~ 或者你可以繼承`App`類 然后重載`loadEnv`方法實現 動態切換環境變量配置。 ### 其它配置格式支持 默認的配置文件都是PHP數組方式，如果你需要使用其它格式的配置文件，你可以通過改變`CONFIG_EXT`環境變量的方式來更改配置類型。 在應用根目錄的`.env`或者系統環境變量中設置 ~~~ CONFIG_EXT=".ini" ~~~ 支持的配置類型包括`.ini`、`.xml`、`.json`、`.yaml`和`.php`在內的格式支持，配置后全局或應用配置必須統一使用相同的配置類型。