如何用PHP项目搭建内容管理系统？

本文目录导读：

1. 🔧 一、技术选型与基础环境
2. 📁 二、项目目录结构示例（原生 PHP）
3. 🧱 三、核心功能模块实现
4. 🛡️ 四、安全要点
5. 🚀 五、进阶建议
6. 🧩 六、推荐已有的成熟 CMS（不用重复造轮子）

搭建一个 PHP 内容管理系统（CMS），可以从零开始手工编码，也可以使用成熟的 PHP 框架，还可以直接在现有 CMS（如 WordPress、Drupal 等）基础上二次开发，下面我提供一个基础、模块化的搭建思路,适用于自定义开发或学习原理。

🔧 一、技术选型与基础环境

小项目或零基础可以不用框架，用原生 PHP + PDO + 模板引擎（如 Blade 或 Twig）。

📁 二、项目目录结构示例（原生 PHP）

project-root/
├── admin/               # 后台管理
│   ├── index.php        # 登录页
│   ├── dashboard.php    # 仪表盘
│   ├── posts.php        # 文章管理
│   ├── categories.php   # 分类管理
│   └── users.php        # 用户管理
├── public/              # 对外访问入口
│   ├── index.php        # 前端入口(渲染文章列表/详情)
│   └── assets/          # CSS / JS / 图片
├── includes/            # 核心功能
│   ├── config.php       # 数据库配置、站点配置
│   ├── db.php           # 数据库连接（PDO）
│   ├── auth.php         # 认证/权限检查
│   ├── functions.php    # 通用函数（如 sanitize, redirect）
│   └── session.php      # Session 管理
├── templates/           # 视图模板
│   ├── header.php
│   ├── footer.php
│   └── ...
├── uploads/             # 用户上传的文件
└── install.php          # 安装脚本（可选）

🧱 三、核心功能模块实现

数据库连接（includes/db.php）

<?php
$host = 'localhost';
$dbname = 'cms_db';
$user = 'root';
$pass = '';
try {
    $pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $user, $pass);
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
} catch (PDOException $e) {
    die("数据库连接失败：" . $e->getMessage());
}
?>

数据库表结构（简化）

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) UNIQUE NOT NULL,
    password VARCHAR(255) NOT NULL,   -- 使用 password_hash()
    role ENUM('admin','editor') DEFAULT 'editor',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE categories (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    slug VARCHAR(100) UNIQUE
);
CREATE TABLE posts (
    id INT AUTO_INCREMENT PRIMARY KEY,VARCHAR(255) NOT NULL,
    slug VARCHAR(255) UNIQUE,
    content TEXT,
    category_id INT,
    author_id INT,
    status ENUM('draft','published') DEFAULT 'draft',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    FOREIGN KEY (category_id) REFERENCES categories(id),
    FOREIGN KEY (author_id) REFERENCES users(id)
);

用户认证（登录 / 权限检查）

• 使用 password_verify() 验证密码；
• 登录成功后存入 Session；
• 后台每个页面顶部引入 auth.php 检查是否登录；

// includes/auth.php
session_start();
if (!isset($_SESSION['user_id'])) {
    header('Location: /admin/index.php');
    exit;
}

文章 CRUD（增删改查）

以 admin/posts.php 为例（简化）：

// 新增文章（POST 处理）
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $title = trim($_POST['title']);
    $content = $_POST['content'];  // 注意 XSS 过滤
    $slug = createSlug($title);
    $stmt = $pdo->prepare("INSERT INTO posts (title, slug, content, author_id) VALUES (?, ?, ?, ?)");
    $stmt->execute([$title, $slug, $content, $_SESSION['user_id']]);
    header('Location: posts.php?msg=created');
}
// 显示文章列表
$stmt = $pdo->query("SELECT p.*, u.username FROM posts p JOIN users u ON p.author_id = u.id ORDER BY created_at DESC");
$posts = $stmt->fetchAll();

前台页面（public/index.php）

<?php
require '../includes/db.php';
$stmt = $pdo->query("SELECT * FROM posts WHERE status='published' ORDER BY created_at DESC LIMIT 10");
$posts = $stmt->fetchAll();
?>

然后循环输出文章标题、摘要和链接。

🛡️ 四、安全要点

1. SQL 注入：始终使用 PDO::prepare() + 参数绑定。
2. XSS：输出时使用 htmlspecialchars()。
3. CSRF：在后台表单中添加 Token。
4. 文件上传：限制类型（白名单）、重命名、存储到非 Web 可访问目录（或设置权限）。
5. 密码：使用 password_hash() 和 password_verify()。

🚀 五、进阶建议

🧩 六、推荐已有的成熟 CMS（不用重复造轮子）

针对“学习如何用 PHP 搭建 CMS”，建议从本回答的原生 PHP 方案开始，理解 CRUD、Session、权限、模板分离等基础概念后，再迁移到框架（例如用 Laravel 重写一遍）——这样既能理解底层原理,又能提高开发效率。

如果你需要更具体的代码示例（比如完整后台登录、文章管理、分页），可以告诉我,我可以帮你补全某个模块的代码。