PHPCMS 二次開發核心：base.php 入口文件與靜態方法全解析

PHPCMS 架構概覽

PHPCMS 採用 MVC 設計模式，基於模塊與操作訪問，採用單一入口模式部署。所有請求統一通過入口文件分發，確保流程可控、安全性高。

核心入口文件：base.php

路徑：根目錄/phpcms/base.php

此文件是框架引導程序，包含系統常量定義、核心類實例化方法、常用工具函數加載。掌握其靜態方法是二次開發的鑰匙。

關鍵靜態方法速查表

實戰場景演示

場景一：脫離框架使用原生 PDO 操作數據庫

<?php
// 1. 引導框架
define('PHPCMS_PATH', dirname(__FILE__).'/phpcms/');
include PHPCMS_PATH.'base.php';

// 2. 獲取數據庫配置
$db_config = pc_base::load_config('database');
$default = $db_config['default'];
$conn = new PDO(
    "mysql:host={$default['hostname']};dbname={$default['database']};charset={$default['charset']}",
    $default['username'],
    $default['password']
);

// 3. 直接執行 SQL
$stmt = $conn->query("SELECT * FROM v9_category WHERE catid=1");
$row = $stmt->fetch(PDO::FETCH_ASSOC);
var_dump($row);

場景二：在獨立腳本中複用模塊邏輯

<?php
include 'phpcms/base.php';
// 加載 content 模塊的 global 函數庫
pc_base::load_app_func('global', 'content');
// 實例化內容模型
$content_db = pc_base::load_model('content_model');
// 調用模型方法
$data = $content_db->get_one(['catid'=>5], 'title,url', 'id DESC');

場景三：自定義模塊開發骨架

// modules/myapp/myapp.class.php
class myapp {
    public function __construct() {
        // 可在此加載所需模型、類
        $this->db = pc_base::load_model('myapp_model');
    }
    public function my_action() {
        // 業務邏輯
    }
}

// 前端調用：index.php?m=myapp&c=myapp&a=my_action

最佳實踐建議

1. 永不修改 base.php 核心代碼，通過擴展類、配置文件、鉤子實現定制。
2. 善用 load_config 讀取配置，避免硬編碼數據庫憑證。
3. 模塊間調用優先使用 load_app_class/func，保持鬆耦合。
4. 二次開發前先閱讀 phpcms/libs/classes/ 下核心類源碼，理解生命周期。