Yaapi + PHP 快速構建內容管理系統（CMS）

Yaapi (Your Article Application Programming Interface) 是一個輕量級 PHP 內容管理框架，提供數據庫抽象、分類管理、文章分頁、模板分離等核心 CMS 功能。適合中小型內容型網站快速開發。

環境需求與安裝

• Web 服務器：Apache / Nginx
• PHP 5.3+ (建議 7.4+)
• MySQL 5.0+

安裝步驟

1. 下載 Yaapi 至網站根目錄：/var/www/yaapi/
2. 導入數據庫結構：mysql -u root -p < yaapi.sql
3. 配置資料庫連線：編輯 article.class.php 構造函數中的 DB 參數
4. 設置目錄權限：chmod 755 admin/ cache/ templates/

後台管理功能

訪問 https://yourdomain.com/yaapi/admin/

核心字段說明

文章分頁語法

導語內容...

#intro#
第 1 頁內容...

#page#
第 2 頁內容...

#page#
第 3 頁內容...
#page#
以此類推...

前台顯示時自動按 #page# 分割，生成分頁導航。

前台調用示例

<?php
require_once 'yaapi/article.class.php';

$yaapi = new Yaapi();

// 獲取分類列表
$categories = $yaapi->getCategories();

// 獲取最新文章 (分類 ID=1, 每頁 10 條)
$articles = $yaapi->getArticles([
    'category' => 1,
    'limit' => 10,
    'page' => isset($_GET['page']) ? (int)$_GET['page'] : 1,
    'approved_only' => true
]);

// 獲取單篇文章內容 (含分頁)
$article = $yaapi->getArticle($article_id);
if ($article) {
    echo "<h1>{$article['title']}</h1>";
    echo "<div class='meta'>作者：{$article['author']} | {$article['pub_date']}</div>";
    
    // 文章分頁輸出
    $pages = $yaapi->getArticlePages($article_id);
    $current_page = isset($_GET['p']) ? (int)$_GET['p'] : 1;
    echo $pages[$current_page - 1]['content'];
    
    // 分頁導航
    echo $yaapi->getPageNavigation($article_id, $current_page);
}

模板系統整合

Yaapi 採用簡單的 PHP 模板機制：

<!-- templates/article_list.php -->
<?php foreach ($articles as $art): ?>
<article>
    <h2><a href="/article.php?id=<?php echo $art['id']; ?>"><?php echo $art['title']; ?></a></h2>
    <p><?php echo mb_substr(strip_tags($art['content']), 0, 200); ?>...</p>
</article>
<?php endforeach; ?>

優缺點評估

現代化改造建議

1. 引入 Composer 自動加載，重構為 PSR-4 結構
2. 替換 mysql_* 為 PDO，加入預處理語句防注入
3. 整合 Twig/Blade 模板引擎
4. 加入 PSR-7 請求/響應、路由組件
5. 實現 RESTful API 介面，支援前後端分離

總結

Yaapi 作為早期 PHP CMS 框架，展示了「內容模型 + 管理後台 + 前台 API」的經典架構。雖然功能較簡陋，但對於理解 CMS 核心邏輯、快速原型開發、輕量項目仍有參考價值。新項目建議考慮 WordPress、Laravel+CMS 包、Strapi 等現代方案。