這裡將收集與 TCExam 有關的資料內容.

虛擬主機上的 TCExam

相關程式檔案放在 c:\tcexam, 管理者帳號設為 tcexam. 啟動 exam.網域.名稱, 牽涉 nginx, php, pgsql 以及 tcexam 程式原始碼.

nginx 主要負責將 http 跳轉至 https, 並且透過 fastcgi 啟動 php 解譯器的執行. 而 nginx 的 server 設定範例如下:

server { 
    listen    98 ssl;
    listen    [::]:98 ssl;

    root c:/tmp/TCExam;

    server_name    exam.網域.名稱;
    ssl_certificate    C:/pj2022/stunnel/config/fullchain.pem;
    ssl_certificate_key    C:/pj2022/stunnel/config/privkey.pem;
    ssl_protocols    TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers    HIGH:!aNULL:!MD5;

    location /{ 
        index index.html index.php;
    }

    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9123;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

pgsql 以手動 start.bat 啟動, 設定檔案如下:

@echo off
set /p DATA=<PGDATA.txt
cd %~dp0
bin\postgres -V
bin\pg_ctl -D %DATA% -l logfile.txt start

其中的 PGDATA.txt 內容為 .\data, 表示資料庫內容存在 .\data 目錄中.

一旦考試結束後, 以 stop.bat 關閉 pgsql:

@echo off
set /p DATA=<PGDATA.txt
cd %~dp0
bin\pg_ctl -D %DATA% -l logfile.txt stop

TCExam 原始碼

由於目前所啟動的線上 TCExam 採用 2022.06.9 釋出的 PHP 8.1.7 版, 而 https://github.com/tecnickcom/tcexam 最近修改日期為 2021.08.05, 因此直接從 TCExam github 網站 clone 下來的原始碼無法在最新版的 PHP 解譯環境中執行.

因此啟動修改 TCExam, 令其可以在 PHP 8.1.7 中執行, 且 pdf 轉檔的部分, 也自行建立中文字型, 以便正確將考試內容轉為中英並存的格式.

目前尚未完成的設定為 send mail 的部分.

總結上述說明, 要啟動 TCExam 考試系統, 必須確認 nginx 已經啟動, 然後手動執行 pgsql 目錄下的 start.bat, 並且注意 c:\certbot 目錄下有關 https 數位簽章每 90 天必須設法手動或自動更新.

CYCU TCExam 主機

目前 exam dot cycu dot org 採用 10ff:1:0::1 設定, 使用 8GB 虛擬主機測試是否合用. 目前透過 nginx 管制, 只允許系上 IPv6 網段連線.

Python and PostgreSQL

pip install psycopg2 peewee

import psycopg2

conn = psycopg2.connect(host='localhost', user='postgres', password='postgres')
conn.cursor().execute('CREATE DATABASE mydatabase')
conn.close()

from peewee import *

db = PostgresqlDatabase('mydatabase', host='localhost', port=5432, user='postgres', password='postgres')
class MyUser (Model):
   name=TextField()
   city=TextField(constraints=[SQL("DEFAULT 'Mumbai'")])
   age=IntegerField()
   class Meta:
      database=db
      db_table='MyUser'

db.connect()
db.create_tables([MyUser])

Windows TCExam

nginx 只允許特定 IPv6 網段連線, 且將 http 用戶跳轉至 https 設定:

server {
    listen       [::]:80 default ipv6only=on;
    server_name  domain.cycu.org;
    #return       301 https://$server_name$request_uri;

    allow 2001:288:6004:xx::0/32;
    deny all;

return 302 https://domain.cycu.org;

    #location /{
        #root C:/tcexam_dir/downloads;
        #auth_basic "For Authorized Users Only!";
        #auth_basic_user_file C:/tcexam_dir/nginx-1.20.1/.htpasswd;
    #}
}

nginx 執行 php 解譯設定:

server { 
    listen    [::]:443 default ssl ipv6only=on;

    root C:/tcexam_dir/tcexam;

    server_name    domain.cycu.org;
    ssl_certificate    C:/tcexam_dir/fullchain.pem;
    ssl_certificate_key    C:/tcexam_dir/privkey.pem;
    ssl_protocols    TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers    HIGH:!aNULL:!MD5;

    allow 2001:288:6004:xx::0/32;
    deny all;

    location /{ 
        index index.html index.php;
    }

    location ~ \.php$ {
        fastcgi_pass   127.0.0.1:9123;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

fastcgi 在 port 9123 啟動的 batch file:

@ECHO OFF
ECHO Starting PHP FastCGI...
set PATH=C:\PHP8.1.7;%PATH%
c:\PHP8.1.7\RunHiddenConsole.exe C:\PHP8.1.7\php-cgi.exe -b 127.0.0.1:9123

若採用 nssm 建立服務, 則透過下列設定建立:

nssm install php 建立 php 服務.

nssm edit php 則用來編輯服務.

Path: C:\tcexam_dir\php8.1.7\php-cgi.exe

Startup Directory: C:\tcexam_dir\php8.1.7

Arguments: -b 127.0.0.1:9123

在 TCExam 準備線上試卷

使用說明: https://tcexam.org/docs/first_test/

以管理者帳號登入, 進入 admin 頁面. Group 代表開課班級, 在此分別建立 cp2022_四設一甲, cp2022_四設一乙, cad2022_四設二甲與 cad2022_四設二乙 等四個開課班級 Group. 當使用者自行建立考試帳號時, 必須選擇所屬班級 Group, 若同時選修兩個班級的課程, 必須同時選擇多個 Group.

建立題庫時, 以 Module 來區分測驗試題的模組類別, 例如: 可以針對開設課程"計算機程式"名稱建立試題模組, 也可以針對主題建立 Module. 目前建立 cp2022, cad2022 與 network_setting 等三個試題模組.

進入試題模組 (考試題目的類別與範圍) 後, 可以再將試題細分 Topic, 例如 network_setting 模組就包含與 cadlab 有關的 Topic, 而 cp2022 試題模組則依照週次加以界定 Topic, 目前的主題訂為 w1-w3, 希望根據上課各週的進度與內容命題.

管理者登入後, 選擇 public 即進入一般用戶介面.

以下題庫範例:

Group (代表開課班級) - Module (試題的最大分類) - Topic (試題的次主題分類)

cp2022_四設一甲 - cp2022 - w1-w3

只允許系上網段可以考試, 外部電腦必須設定代理主機後才可參與考試:

authorized IP's: 2001:288:6004:17::

basic points: 每一個題目得分, 若總題數為 10 題, 則 basic points 為 10 分, 總分為 100 分.

partial score for MCMA: 打勾, 表示針對 Multiple Choice Multiple Answer 允許部分給分.

Let'sEncrypt renew: 開啟管理者模式下的 cmd, 然後執行 "C:\Program Files (x86)\Certbot\bin\certbot" renew

exam.cycu.org 之 https 數位簽章 due day: 2022.12.27