萬盛學電腦網

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

CMS 系統安裝狀態檢測機制:PHP 判斷是否已安裝的最佳實踐

現代 CMS(WordPress、Typecho、OctoberCMS 等)皆採用「鎖定檔案」機制判斷系統是否已安裝。本文解析此模式原理、實作細節、安全考量與進階擴充。

核心原理:安裝鎖定檔案

<?php
// 入口檔案 index.php 或 bootstrap/app.php 最開頭
define('APP_ROOT', __DIR__ . '/');
define('INSTALL_LOCK', APP_ROOT . 'data/install.lock');

// 檢測安裝狀態
if (!is_file(INSTALL_LOCK)) {
    // 未安裝:導向安裝程式
    header('Location: /install/index.php');
    exit;
}

// 已安裝:正常啟動應用
require_once APP_ROOT . 'config/app.php';
// ...

安裝程式流程

<?php
// install/index.php 簡化流程
if (is_file(INSTALL_LOCK)) {
    die('系統已安裝,如需重裝請手動刪除 data/install.lock');
}

if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 1. 驗證環境需求
    $checks = [
        'PHP >= 8.0' => version_compare(PHP_VERSION, '8.0', '>='),
        'PDO MySQL' => extension_loaded('pdo_mysql'),
        'GD' => extension_loaded('gd'),
        'mbstring' => extension_loaded('mbstring'),
        '目錄可寫' => is_writable(APP_ROOT . 'data') && is_writable(APP_ROOT . 'storage'),
    ];
    if (in_array(false, $checks, true)) {
        // 顯示環境檢查失敗
    }
    
    // 2. 驗證資料庫連線
    try {
        $pdo = new PDO(
            "mysql:host={$_POST['db_host']};dbname={$_POST['db_name']};charset=utf8mb4",
            $_POST['db_user'],
            $_POST['db_pass'],
            [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
        );
    } catch (PDOException $e) {
        // 顯示連線失敗
    }
    
    // 3. 執行 SQL 遷移建立資料表
    $sql = file_get_contents(APP_ROOT . 'install/schema.sql');
    $pdo->exec($sql);
    
    // 4. 寫入設定檔
    $config = [
        'database' => [
            'driver' => 'mysql',
            'host' => $_POST['db_host'],
            'database' => $_POST['db_name'],
            'username' => $_POST['db_user'],
            'password' => $_POST['db_pass'],
            'charset' => 'utf8mb4',
            'prefix' => 'cms_',
        ],
        'app' => [
            'key' => bin2hex(random_bytes(32)),
            'debug' => false,
            'url' => $_POST['site_url'],
        ],
    ];
    file_put_contents(APP_ROOT . 'config/app.php', '

進階:版本化鎖定檔案


// data/install.lock 內容範例
2024-01-15T10:30:00+08:00
version=2.1.0
db_schema_version=15

支援:

  • 版本升級檢測:比對 db_schema_version 決定是否執行遷移
  • 多環境同步:Git 忽略 data/install.lock,各環境獨立安裝
  • 安全審計:記錄安裝時間、版本、資料庫版本

安全性強化

  1. 安裝完成後自動刪除/重命名安裝目錄:
    // 安裝成功最後一步
    rename(APP_ROOT . 'install', APP_ROOT . 'install_' . bin2hex(random_bytes(4)));
    // 或刪除
    // array_map('unlink', glob(APP_ROOT . 'install/*.*'));
    // rmdir(APP_ROOT . 'install');
  2. 鎖定檔案權限:chmod(INSTALL_LOCK, 0444) 唯讀,防篡改
  3. 環境變數覆蓋:生產環境建議用 .env 管理敏感設定,config/app.php 讀取 env()

替代方案比較

  • 環境變數:APP_INSTALLED=true(Docker/K8s 部署適用)
  • 方案原理優點缺點
    鎖定檔案檢查檔案存在簡單、無資料庫依賴、Git 友善分散式部署需共享儲存
    資料庫標記查詢 settings 表天然支援叢集雞生蛋蛋生雞(需先有資料庫連線)
    零檔案、配置即代碼需基礎設施支援

    最佳實務總結

    1. 入口檔最開頭檢查 is_file(INSTALL_LOCK)
    2. 安裝程式獨立目錄,完成後必須刪除或重命名
    3. 鎖定檔案記錄版本資訊,支援升級遷移
    4. 生產環境鎖定檔案設為唯讀
    5. 提供 php artisan install:reset 指令供開發環境快速重裝
    copyright © 萬盛學電腦網 all rights reserved