cPanel 安裝指南 / cPanel Installation Guide

本章節將指引您在 cPanel 共享主機環境中安裝 Toppay，所有必要的 vendor 與編譯檔已預先包含。
This section guides you to install Toppay on a shared hosting environment using cPanel. All required vendor and compiled files are pre-included.

1. 上傳程式檔案 / Upload the Script

登入 cPanel 並開啟 File Manager。
Login to your cPanel and open the File Manager.

導航至 public_html/ 或您的網域根目錄。
Navigate to public_html/ or your domain root.

點選 Upload 並上傳 core.zip。
Click Upload and select the core.zip file.

上傳後解壓縮 ZIP，您將看到 app/、public/、routes/ 等資料夾。
After upload, extract the ZIP. You should see folders like app/, public//, routes/, etc.

2. 建立資料庫 / Create a Database

前往 cPanel 的 MySQL® Databases。
Go to MySQL® Databases in cPanel.

建立資料庫與使用者，並賦予 ALL PRIVILEGES。
Create a new database and user, then assign the user to the database with ALL PRIVILEGES.

前往 phpMyAdmin，從 /core/DB/digikash.sql 匯入 SQL 檔案。
Go to phpMyAdmin and import the SQL file from //core/DB/digikash.sq.

3. 設定環境變數 / Configure Environment Variables

編輯 .env，輸入您的域名與資料庫資訊。
Edit .env with your domain and database credentials.

APP_URL=https://yourdomain.com/public
DB_HOST=localhost
DB_DATABASE=your_db
DB_USERNAME=your_user
DB_PASSWORD=your_pass

4. 設定資料夾權限 / Set Folder Permissions

chmod -R 775 storage
chmod -R 775 bootstrap/cache

5. 清除 Laravel 快取 / Clear Laravel Cache

若出現空白頁或錯誤，請執行以下指令。
If you face a blank page or error, run the following command.

php artisan optimize:clear

6. 執行 Queue Worker / Run the Queue Worker

⚙️ 選項 1：使用 cPanel Cron Job
⚙️ Option 1: Add a Cron Job in cPanel

* * * * * cd /home/your_user/public_html && php artisan queue:work --timeout=60 --tries=3 >> /dev/null 2>&1

⚙️ 選項 2：透過 SSH 執行
⚙️ Option 2: Run manually via SSH

php artisan queue:work --daemon

7. 設定維護模式與正式模式 / Set Maintenance and Production Mode

進入 Admin Panel → Site Settings → Maintenance Mode。
Go to Admin Panel → Site Settings → Maintenance Mode.

切換模式前請確認登入、註冊、交易、通知、API 等功能皆正常。
Before changing any mode, verify that login, registration, transactions, notifications, API, etc., are working properly.

所有功能正常後，再將 Site Environment 切換為 Production。
Set Site Environment to Production only after confirming everything functions correctly.

關閉 Development Mode 能提升效能並增強安全性。
Turn off Development Mode to improve performance and enable full system security optimizations.

8. 訪問網站 / Access the Website

前台 / Frontend： https://yourdomain.com
使用者登入 / User Login： /login
用戶註冊 / User Registration： /register
管理後台 / Admin Panel： /Joekoe
預設管理登入 / Default Admin Login： admin@v2u.ai / 12345678

⚠️ 安裝後請變更管理者密碼、於 Site Settings → Mail 設定郵件、確認 queue worker 運作並關閉開發模式。
⚠️ After installation: change the admin password, configure mail under Site Settings → Mail, ensure queue worker is active, and disable development mode.