國產 PHP 框架 MyQEE 新手快速入門：從環境搭建到資料庫 CURD

MyQEE 是一套輕量級國產 PHP 框架，架構清晰、學習曲線平緩。本教程記錄從 Windows + XAMPP 環境搭建、虛擬主機配置、專案建立、路由控制器、模型資料庫操作到視圖渲染的完整新手入門流程，助你 30 分鐘跑通第一個 MyQEE 專案。

一、開發環境準備

推薦環境

• OS：Windows 7/10/11
• 整合包：XAMPP 1.7.4 (PHP 5.3.x 系列，穩定相容)
• 框架：MyQEE 最新版 (GitHub 下載)

Apache 虛擬主機配置

檔案：D:\xampp\apache\conf\extra\httpd-vhosts.conf

# MyQEE 專案

    DocumentRoot "D:/xampp/htdocs/mq/"
    ServerName mq
    
        Options Indexes FollowSymLinks Includes ExecCGI
        AllowOverride All
        Order allow,deny
        Allow from all
    


# 保留 localhost

    DocumentRoot "D:/xampp/htdocs/"
    ServerName localhost

Hosts 檔案綁定

路徑：C:\Windows\System32\drivers\etc\hosts (或 hosts.ics)

127.0.0.1 mq

二、建立 MyQEE 專案

1. 部署框架檔案

# 解壓至虛擬主機目錄
D:/xampp/htdocs/mq/

# 重命名配置檔
config.new.php → config.php

2. .htaccess 重寫規則 (必要)

GitHub 版本可能缺失，請手動建立 wwwroot/.htaccess：

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule .* index.php [PT,L]

3. 註冊新專案模組

編輯 config.php，在預設配置前新增：

's' => array(
    'name'   => '預設專案',
    'dir'    => 's',
    'isuse'  => true,
    'url'    => '/',
),

4. 建立專案目錄結構

projects/
└── s/                 # 新專案目錄 (複製 default 重命名)
    ├── controllers/
    ├── models/
    └── views/

三、第一個控制器：Hello World

檔案：projects/s/controllers/helloworld.controller.php

瀏覽器訪問：https://mq/index.php/helloworld → 顯示 helloworld 成功！

開啟 Debug 模式 (開發環境強烈建議)
php.ini 加入：
;[MyQEE]
myqee.debug=On
搭配 Firefox + Firebug 進行除錯。

四、資料庫 CURD 完整實作

1. 專案獨立資料庫配置
檔案：projects/s/config.php


2. 建立資料表
CREATE TABLE `wh_list` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `name` varchar(32) COLLATE utf8_unicode_ci DEFAULT NULL,
    PRIMARY KEY (`id`),
    UNIQUE KEY `username` (`username`) USING BTREE
) ENGINE=MyISAM DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;

3. Model 層
檔案：projects/s/models/wh.model.php
query($sql)->as_array();
    }
}

4. Controller 層
修改 helloworld.controller.php：
set('wh', $arr);
        $view->render();
    }
}

5. View 層
檔案：projects/s/views/wh.view.php

    


重新整理瀏覽器，即可看到資料庫 wh_list 表的 name 欄位內容輸出。

五、常見坑點與解決

    

        
問題
解決
    
    

        
訪問 404
檢查 .htaccess 是否放在 wwwroot、mod_rewrite 是否啟用
        
資料庫連線失敗
確認 config.php 資料庫配置、MySQL 服務啟動、帳號密碼正確
        
視圖找不到
views 目錄命名需與 View('wh') 參數一致、副檔名 .view.php
        
類別找不到
檢查命名空間、檔案命名規範 (Controller_、Model_ 前綴)
    


六、進階學習資源

    
官方文檔：https://myqee.com
    
GitHub 原始碼：https://github.com/myqee
    
社群討論：QQ 群、論壇搜尋 "MyQEE"


完成本教程，你已掌握 MyQEE 的環境部署、MVC 分層開發、資料庫操作核心流程。後續可深入學習路由進階、驗證機制、快取、任務排程等企業級特性。