Laravel 是目前最流行的 PHP 框架之一。本文針對 Laravel 4/5 早期版本的核心配置檔 app/config/app.php 與 app/config/database.php 進行詳細說明,幫助初學者快速上手。
# 透過 Composer 建立專案
composer create-project laravel/laravel your-project-name --prefer-dist
# 進入專案目錄
cd your-project-name
# 設定儲存目錄權限
chmod -R 775 storage bootstrap/cache
<?php
return [
// 除錯模式:生產環境務必設為 false
'debug' => env('APP_DEBUG', false),
// 應用程式 URL,影響生成連結、資源路徑
'url' => env('APP_URL', 'https://localhost'),
// 時區:台灣請設為 Asia/Taipei
'timezone' => 'Asia/Taipei',
// 語系:預設 en,中文環境建議 zh-TW
'locale' => 'zh-TW',
// 應用程式金鑰:32 字元隨機字串,用於加密、簽名
// 執行 php artisan key:generate 產生
'key' => env('APP_KEY'),
// 快取、Session、佇列驅動等其他設定...
];
?>
<?php
return [
// 預設取資料方式:物件或陣列
'fetch' => PDO::FETCH_CLASS,
// 預設連線名稱(對應 connections 陣列鍵名)
'default' => env('DB_CONNECTION', 'mysql'),
'connections' => [
'sqlite' => [
'driver' => 'sqlite',
'database' => database_path('database.sqlite'),
'prefix' => '',
],
'mysql' => [
'driver' => 'mysql',
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '3306'),
'database' => env('DB_DATABASE', 'forge'),
'username' => env('DB_USERNAME', 'forge'),
'password' => env('DB_PASSWORD', ''),
'charset' => 'utf8mb4',
'collation' => 'utf8mb4_unicode_ci',
'prefix' => '',
'strict' => true,
'engine' => null,
],
'pgsql' => [
'driver' => 'pgsql',
'host' => env('DB_HOST', '127.0.0.1'),
'port' => env('DB_PORT', '5432'),
'database' => env('DB_DATABASE', 'forge'),
'username' => env('DB_USERNAME', 'forge'),
'password' => env('DB_PASSWORD', ''),
'charset' => 'utf8',
'prefix' => '',
'schema' => 'public',
'sslmode' => 'prefer',
],
],
// 遷移資料表名稱
'migrations' => 'migrations',
];
?>
Laravel 5 起採用 .env 管理環境變數,切勿將 .env 提交至版控。範例:
APP_ENV=local
APP_DEBUG=true
APP_KEY=base64:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
APP_URL=https://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
APP_KEY 會導致所有已加密資料(Session、Cookie、密碼重設 token 等)失效。php artisan config:cache 提升效能,修改配置後需重新快取。connections 新增陣列,使用 DB::connection('name') 切換。掌握 app.php 與 database.php 核心設定,並善用 .env 區分環境,是 Laravel 專案穩定部署的基礎。