現代 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 決定是否執行遷移data/install.lock,各環境獨立安裝// 安裝成功最後一步
rename(APP_ROOT . 'install', APP_ROOT . 'install_' . bin2hex(random_bytes(4)));
// 或刪除
// array_map('unlink', glob(APP_ROOT . 'install/*.*'));
// rmdir(APP_ROOT . 'install');
chmod(INSTALL_LOCK, 0444) 唯讀,防篡改.env 管理敏感設定,config/app.php 讀取 env()| 方案 | 原理 | 優點 | 缺點 |
|---|---|---|---|
| 鎖定檔案 | 檢查檔案存在 | 簡單、無資料庫依賴、Git 友善 | 分散式部署需共享儲存 |
| 資料庫標記 | 查詢 settings 表 | 天然支援叢集 | 雞生蛋蛋生雞(需先有資料庫連線) | 零檔案、配置即代碼 | 需基礎設施支援 |
is_file(INSTALL_LOCK)php artisan install:reset 指令供開發環境快速重裝