萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

Laravel 框架安裝與核心配置詳解

前言

Laravel 是目前最流行的 PHP 框架之一。本文針對 Laravel 4/5 早期版本的核心配置檔 app/config/app.php 與 app/config/database.php 進行詳細說明,幫助初學者快速上手。

環境需求

  • PHP >= 5.4(Laravel 4)或 PHP >= 5.5.9(Laravel 5)
  • Composer 套件管理工具
  • OpenSSL、Mbstring、Tokenizer 等擴充套件

安裝步驟

# 透過 Composer 建立專案
composer create-project laravel/laravel your-project-name --prefer-dist

# 進入專案目錄
cd your-project-name

# 設定儲存目錄權限
chmod -R 775 storage bootstrap/cache

核心配置檔詳解

1. app/config/app.php - 應用程式基礎設定

<?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、佇列驅動等其他設定...
];
?>

2. app/config/database.php - 資料庫連線設定

<?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',
];
?>

環境變數檔 .env

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 專案穩定部署的基礎。

copyright © 萬盛學電腦網 all rights reserved